Jogosultságok referenciája

A jogosultságok határozzák meg, mit tehet egy API-kulcs. Kulcs létrehozásakor vagy szerkesztésekor jelölöd be őket a Settings > API keys oldalon, és később a kulcs cseréje nélkül is módosíthatod őket. Egy kulcs soha nem kaphat több jogot, mint amennyivel a tulajdonosa rendelkezik: a jogosultságok csak szűkítik azt, amit az alkalmazásban amúgy is megtehetsz.

A jogosultságok működése

• Minden REST-végpont jogosultságok egy listáját fogadja el. A kulcsnak legalább az egyikkel rendelkeznie kell. A referenciaoldalak minden végpontnál feltüntetik őket, és mindegyik az alábbi táblázatok megfelelő sorára hivatkozik.
• Minden MCP-eszközhöz pontosan egy jogosultság kell. Ha a kulcsnak nincs meg, nem látja az eszközt a tools/list válaszában, a meghívása pedig ugyanazt a hibát adja, mint egy nem létező eszközé.
• Az MCP jelvénnyel jelölt jogosultságok mindkét helyen működnek. Legalább egy MCP-eszközhöz és REST-végpontokhoz is hozzáférést adnak. Az összes többi csak a REST API-ra vonatkozik. Ugyanez a jelvény az alkalmazásban is megjelenik a jogosultságok mellett.
• A három utótag. A _get olvasásra, a _manage létrehozásra, módosításra és futtatásra, a _delete törlésre jogosít. A törlés mindig külön jogosultság, így egy integrációnak írási jogot adhatsz anélkül, hogy bármit eltávolíthatna.
• A munkaterület szabályai továbbra is érvényesek. A modellhozzáférés, az adatrezidencia és a védőkorlátok minden hívásnál érvényesülnek, az integrációs kapcsolatok pedig megtartják a saját hozzáférési szintjüket (például a Read only beállítású adatbázis-kapcsolat csak SELECT utasítást fogad el, bármilyen jogosultsága is van a kulcsnak).

Ha egy kulcsból hiányzik egy jogosultság, a REST API ezt válaszolja:

HTTP 403
{"error": "This api key does not have any of the required permissions. You need at least one of: conversations_get"}

Az összes jogosultság

Chat és beszélgetések

Jogosultság	Mihez ad hozzáférést	MCP
conversations_get	Beszélgetések és üzeneteik olvasása, egy beszélgetés élő követése a WebSocketjén keresztül, egy beszélgetés fájljainak listázása, üzenetek exportálása. MCP: get_conversation, list_conversations.	MCP
conversations_manage	Beszélgetések létrehozása és üzenetek küldése, elágaztatás (fork), újrapróbálás, megosztás, modellek összehasonlítása (albeszélgetések), ügynökök hozzáadása egy beszélgetéshez vagy eltávolítása belőle. MCP: send_message.	MCP
conversations_delete	DELETE /conversation/:id. MCP: delete_conversation.	MCP
search	GET /search: keresés a promptjaid és a beszélgetéseid között. MCP: search.	MCP

Promptok és futtatások

Jogosultság	Mihez ad hozzáférést	MCP
prompts_get	Promptok listázása és olvasása, valamint a kedvencek, a futtatási előzmények, a példányok, a megosztások és a promptfájlok elérése. MCP: list_prompts, get_prompt.	MCP
prompts_manage	Promptok létrehozása, módosítása, duplikálása, áthelyezése és megosztása; verziók, kedvencek, példányok és promptfájlok kezelése.	-
prompts_delete	DELETE /prompt/:id.	-
prompt_variables_manage	POST /variable, PUT /variable/:id.	-
prompt_variables_delete	DELETE /variable/:id.	-
run_prompt	Mentett promptok és példányok futtatása (POST /instance/:id/run és a /run/prompt/... rövidített végpontok). MCP: run_prompt.	MCP
custom_run	POST /run: szabad szöveg küldése egy modellnek, mentett prompt nélkül. MCP: custom_run.	MCP
ai_models_get	GET /ai_model, /ai_model/:id, /ai_model/filters, /ai_model/restricted. MCP: list_ai_models.	MCP

Ügynökök és munkafolyamatok

Jogosultság	Mihez ad hozzáférést	MCP
agents_get	GET /agents, GET /agents/:id. MCP: list_agents, get_agent.	MCP
agents_manage	POST /agents, PATCH /agents/:id.	-
agents_delete	DELETE /agents/:id.	-
workflow_tasks_get	Munkafolyamat-feladatok és végrehajtásaik listázása és olvasása. MCP: list_workflow_tasks, get_workflow_task.	MCP
workflow_tasks_manage	Munkafolyamat-feladatok létrehozása és módosítása, kézi futtatás indítása. MCP: run_workflow_task.	MCP
workflow_tasks_delete	DELETE /workflow-tasks/:id.	-
mcp_get	GET /mcp, GET /mcp/:id: a beállított távoli MCP-szervereid (azok, amelyeket az ügynökök és a chatek meghívnak).	-
mcp_manage	POST /mcp, PUT /mcp/:id.	-
mcp_delete	DELETE /mcp/:id.	-

Tudás, fájlok és táblázatok

Jogosultság	Mihez ad hozzáférést	MCP
knowledge_bases_get	Tudásbázisok és mappák listázása és olvasása. MCP: list_knowledge_bases, search_knowledge_base.	MCP
knowledge_bases_manage	Tudásbázisok és mappák létrehozása, módosítása és megosztása; tudásbázisfájlok feltöltése és törlése.	-
knowledge_bases_delete	DELETE /knowledge-bases/:id.	-
files_get	GET /file. MCP: list_files, get_file.	MCP
files_manage	POST /file (feltöltés), POST /file/:id/public.	-
files_delete	DELETE /file/:id, DELETE /file/:id/public.	-
spreadsheet_processing_get	GET /xlsx/process-status/:taskId, GET /xlsx/history. MCP: list_spreadsheet_processing_tasks, get_spreadsheet_processing_task.	MCP
spreadsheet_processing_manage	Táblázatfeldolgozás indítása, szüneteltetése és folytatása. MCP: start_spreadsheet_processing, pause_spreadsheet_processing, resume_spreadsheet_processing.	MCP

Projektek, csapatok és munkaterület

Jogosultság	Mihez ad hozzáférést	MCP
projects_get	Projektek, kitűzött projektek és projektfájlok listázása és olvasása. MCP: list_projects, get_project.	MCP
projects_manage	Projektek létrehozása, módosítása, kitűzése és megosztása; projektfájlok kezelése. MCP: create_project.	MCP
projects_delete	DELETE /project/:id. MCP: delete_project.	MCP
teams_get	GET /teams, /teams/all, /teams/:id/members. MCP: list_teams, list_team_members.	MCP
teams_manage	Csapatok létrehozása és módosítása; tagok hozzáadása, módosítása és eltávolítása.	-
teams_delete	DELETE /teams/:id.	-
organization_get	GET /workspace. MCP: list_workspace_members.	MCP
organization_manage	PATCH /workspace, PATCH /workspace/user/permissions.	-
organization_delete	DELETE /workspace.	-

Médiagenerálás és hangátírás

Jogosultság	Mihez ad hozzáférést	MCP
image_generation_manage	POST /image_generation, POST /image_generation/edit. MCP: generate_image, edit_image.	MCP
video_generation_get	Videómodellek listázása, videógenerálások listázása és olvasása. MCP: get_video_generation_status.	MCP
video_generation_manage	Videógenerálások létrehozása és újrapróbálása. MCP: generate_video.	MCP
video_generation_delete	Videógenerálás törlése. MCP: delete_video_generation.	MCP
tts_generation_get	Beszédmodellek listázása, beszédgenerálások listázása és olvasása. MCP: get_tts_generation_status.	MCP
tts_generation_manage	Beszédgenerálások létrehozása és újrapróbálása. MCP: generate_speech.	MCP
tts_generation_delete	Beszédgenerálás törlése. MCP: delete_tts_generation.	MCP
music_generation_get	Zenei modellek listázása, zenegenerálások listázása és olvasása. MCP: get_music_generation_status.	MCP
music_generation_manage	Zenegenerálások létrehozása és újrapróbálása. MCP: generate_music.	MCP
music_generation_delete	Zenegenerálás törlése. MCP: delete_music_generation.	MCP
transcription_get	Hangátírási modellek listázása, hangátírások listázása és olvasása. MCP: get_transcription_status.	MCP
transcription_manage	Hangátírások létrehozása és újrapróbálása, beszélők átnevezése. MCP: transcribe.	MCP
transcription_delete	Hangátírás törlése. MCP: delete_transcription.	MCP

Decisions

Jogosultság	Mihez ad hozzáférést	MCP
decision_get	GET /decision_model, GET /decision, GET /decision/:id: a döntési modellek listázása, a döntéseid listázása és olvasása.	-
decision_manage	POST /decision: döntés futtatása és mentése.	-
decision_delete	DELETE /decision/:id.	-

Integrációk

Jogosultság	Mihez ad hozzáférést	MCP
integrations_get	GET /integration (a szolgáltatók katalógusa) és az SSH-alagút nyilvános kulcsa.	-
integration_connections_get	GET /integration/connections.	-
integration_connections_manage	Kapcsolatok létrehozása, újracsatlakoztatása és módosítása.	-
integration_connections_delete	Kapcsolat törlése.	-
integration_email_get	Az e-mail-kapcsolat adatainak olvasása. MCP: list_email_connections.	MCP
integration_email_manage	E-mail küldése egy csatlakoztatott fiókon keresztül. MCP: send_email.	MCP
integration_crm_get	A CRM olvasó végpontjai (kapcsolati adatok, kontaktok, üzletek, listák, címkék). MCP: list_crm_connections, search_crm_contacts, list_crm_contacts, search_crm_deals, list_crm_deals, list_crm_lists, list_crm_tags.	MCP
integration_crm_manage	CRM-kontaktok létrehozása és szerkesztése, üzletek létrehozása. MCP: add_crm_contact, edit_crm_contact, create_crm_deal. Ehhez magán a CRM-kapcsolaton is engedélyezni kell az írási hozzáférést.	MCP
integration_database_get	Az adatbázisséma és a kapcsolati adatok olvasása. MCP: list_database_connections, list_database_tables, describe_database_tables.	MCP
integration_database_manage	Lekérdezés futtatása egy csatlakoztatott adatbázison. MCP: run_database_query. Azt, hogy a lekérdezés mit tehet, a kapcsolat saját jogosultsági szintje határozza meg.	MCP
integration_storage_get	Böngészés, keresés és bejegyzések olvasása egy csatlakoztatott felhőtárhelyen. MCP: list_storage_connections, browse_storage_folder, search_storage_files, get_storage_entry.	MCP
integration_storage_manage	Fájlok importálása egy csatlakoztatott felhőtárhelyről, illetve fájlok exportálása oda. MCP: import_storage_files, export_file_to_storage.	MCP

Jogosultságok, amelyek jelenleg semmihez nem adnak hozzáférést

A listában a prompt_variables_get, prompt_categories_get, prompt_categories_manage, prompt_categories_delete, image_generation_get és image_generation_delete jogosultságot is láthatod. Jelenleg egyetlen ügyfeleknek szóló végpont vagy MCP-eszköz sem használja őket, így a bejelölésüknek nincs hatása.

Csak munkatársaknak, nem adható ki

A statistics_get, ai_models_manage, invite_codes_get, invite_codes_manage és invite_codes_delete jogosultság a StickyPrompts munkatársainak van fenntartva. Ezek nem jelennek meg a jogosultságok listájában, és ha megpróbálod őket egy kulcshoz rendelni, a kérést a rendszer 403 {"error":"You are using permissions that are restricted"} válasszal elutasítja. Ezért nem jelenik meg soha a get_usage_statistics MCP-eszköz az ügyfelek kulcsainál. A munkaterület felhasználását az adminisztrátorok az alkalmazásban láthatják, lásd: Felhasználás, kreditek és számlázás.

Javasolt jogosultságcsomagok

Indulj ki ezek egyikéből, és csak azt add hozzá, amire az integrációdnak a gyakorlatban szüksége lesz.

Csak olvasó riportkészítő bot

Adatbázisból és a dokumentumaidból válaszol kérdésekre, de semmit nem ír vissza.

Jogosultságok	Miért
ai_models_get, custom_run	Modell kiválasztása és az eredmények összefoglalása.
integration_database_get	A kapcsolat megkeresése és a séma kiolvasása.
integration_database_manage	Enélkül egyetlen lekérdezést sem futtathat. Az adatbázist Read only szinttel csatlakoztasd, hogy csak SELECT utasításokat fogadjon el.
knowledge_bases_get	Keresés a dokumentumokban, kontextusként.

Chatbot

Egy frontend (például egy belső Slack-bot), amely az ügynökeiddel és a tudásbázisaiddal dolgozik.

Jogosultságok	Miért
ai_models_get	Modell kiválasztása az új beszélgetésekhez.
conversations_manage, conversations_get	Beszélgetések indítása, üzenetek küldése és a válaszok olvasása.
agents_get	Ügynökök megkeresése @mention említéshez vagy közvetlen beszélgetéshez.
knowledge_bases_get	Tudásbázisok átadása egy beszélgetésnek.

Tartalomgenerátor

Kitölti a mentett promptjaidat, és szöveget, valamint képeket készít.

Jogosultságok	Miért
ai_models_get	Modell kiválasztása.
prompts_get, run_prompt	Mentett promptok megkeresése és futtatása változókkal.
custom_run	Egyszeri generálás mentett prompt nélkül.
image_generation_manage, files_get	Képek generálása és az elkészült fájlok lekérése.

CRM-asszisztens

Kontaktokat és üzleteket keres, naprakészen tartja a CRM-et, és utánkövető e-maileket küld.

Jogosultságok	Miért
integration_crm_get	Kontaktok és üzletek keresése és listázása.
integration_crm_manage	Kontaktok hozzáadása és szerkesztése, üzletek létrehozása. A CRM-kapcsolaton be kell kapcsolni az Allow write access beállítást.
integration_email_get, integration_email_manage	Az e-mail-kapcsolat megkeresése és az utánkövető e-mail elküldése.
ai_models_get, custom_run	Az e-mail szövegének megfogalmazása.

Kapcsolódó oldalak