Riferimento delle autorizzazioni

Le autorizzazioni stabiliscono cosa può fare una chiave API. Le spunti quando crei o modifichi una chiave in Settings > API keys, e puoi cambiarle in seguito senza ruotare la chiave. Una chiave non ottiene mai più di quanto abbia il suo proprietario: le autorizzazioni restringono soltanto ciò che puoi già fare nell’app.

Come funzionano le autorizzazioni

• Ogni route REST accetta un elenco di autorizzazioni. Alla chiave ne basta una qualsiasi. Le pagine di riferimento le mostrano su ogni endpoint, ciascuna con un link alla sua riga qui sotto.
• Ogni strumento MCP richiede esattamente un’autorizzazione. Una chiave che non ce l’ha non vede lo strumento in tools/list, e se prova a chiamarlo riceve lo stesso errore di uno strumento inesistente.
• Le autorizzazioni contrassegnate con MCP valgono in entrambi i contesti. Proteggono almeno uno strumento MCP oltre alle route REST. Tutte le altre valgono solo per REST. Lo stesso badge compare accanto alle autorizzazioni nell’app.
• I tre verbi. _get legge, _manage crea, aggiorna ed esegue, _delete elimina. L’eliminazione è sempre separata, così puoi dare a un’integrazione accesso in scrittura senza il potere di cancellare.
• Le regole del workspace valgono comunque. Accesso ai modelli, residenza dei dati e guardrail vengono applicati a ogni chiamata, e le connessioni delle integrazioni mantengono il proprio livello di accesso (per esempio, una connessione a database impostata su Read only accetta solo SELECT, qualunque autorizzazione abbia la chiave).

Quando a una chiave manca un’autorizzazione, REST risponde:

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

Tutte le autorizzazioni

Chat e conversazioni

Autorizzazione	Cosa sblocca	MCP
conversations_get	Leggere le conversazioni e i loro messaggi, seguire una conversazione in tempo reale tramite il suo WebSocket, elencare i file di una conversazione, esportare i messaggi. MCP: get_conversation, list_conversations.	MCP
conversations_manage	Creare conversazioni e inviare messaggi, fare fork, riprovare, condividere, confrontare modelli (sotto-conversazioni), aggiungere o rimuovere agenti da una conversazione. MCP: send_message.	MCP
conversations_delete	DELETE /conversation/:id. MCP: delete_conversation.	MCP
search	GET /search sui tuoi prompt e sulle tue conversazioni. MCP: search.	MCP

Prompt ed esecuzioni

Autorizzazione	Cosa sblocca	MCP
prompts_get	Elencare e leggere prompt, preferiti, cronologia delle esecuzioni, istanze, condivisioni e file dei prompt. MCP: list_prompts, get_prompt.	MCP
prompts_manage	Creare, aggiornare, duplicare, spostare e condividere prompt; versioni, preferiti, istanze e file dei prompt.	-
prompts_delete	DELETE /prompt/:id.	-
prompt_variables_manage	POST /variable, PUT /variable/:id.	-
prompt_variables_delete	DELETE /variable/:id.	-
run_prompt	Eseguire prompt salvati e istanze (POST /instance/:id/run, le scorciatoie /run/prompt/...). MCP: run_prompt.	MCP
custom_run	POST /run: inviare testo libero a un modello senza un prompt salvato. MCP: custom_run.	MCP
ai_models_get	GET /ai_model, /ai_model/:id, /ai_model/filters, /ai_model/restricted. MCP: list_ai_models.	MCP

Agenti e workflow

Autorizzazione	Cosa sblocca	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	Elencare e leggere i task dei workflow e le loro esecuzioni. MCP: list_workflow_tasks, get_workflow_task.	MCP
workflow_tasks_manage	Creare e aggiornare i task dei workflow, avviare un’esecuzione manuale. MCP: run_workflow_task.	MCP
workflow_tasks_delete	DELETE /workflow-tasks/:id.	-
mcp_get	GET /mcp, GET /mcp/:id: i server MCP remoti che hai configurato (quelli che agenti e chat chiamano).	-
mcp_manage	POST /mcp, PUT /mcp/:id.	-
mcp_delete	DELETE /mcp/:id.	-

Conoscenza, file e fogli di calcolo

Autorizzazione	Cosa sblocca	MCP
knowledge_bases_get	Elencare e leggere knowledge base e cartelle. MCP: list_knowledge_bases, search_knowledge_base.	MCP
knowledge_bases_manage	Creare, aggiornare e condividere knowledge base e cartelle; caricare ed eliminare i file delle knowledge base.	-
knowledge_bases_delete	DELETE /knowledge-bases/:id.	-
files_get	GET /file. MCP: list_files, get_file.	MCP
files_manage	POST /file (caricamento), 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	Avviare, mettere in pausa e riprendere l’elaborazione dei fogli di calcolo. MCP: start_spreadsheet_processing, pause_spreadsheet_processing, resume_spreadsheet_processing.	MCP

Progetti, team e workspace

Autorizzazione	Cosa sblocca	MCP
projects_get	Elencare e leggere i progetti, i progetti fissati e i file dei progetti. MCP: list_projects, get_project.	MCP
projects_manage	Creare, aggiornare, fissare e condividere progetti; file dei progetti. 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	Creare e aggiornare team; aggiungere, aggiornare e rimuovere membri.	-
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.	-

Generazione di media e trascrizione

Autorizzazione	Cosa sblocca	MCP
image_generation_manage	POST /image_generation, POST /image_generation/edit. MCP: generate_image, edit_image.	MCP
video_generation_get	Elencare i modelli video, elencare e leggere le generazioni video. MCP: get_video_generation_status.	MCP
video_generation_manage	Creare e riprovare generazioni video. MCP: generate_video.	MCP
video_generation_delete	Eliminare una generazione video. MCP: delete_video_generation.	MCP
tts_generation_get	Elencare i modelli di sintesi vocale, elencare e leggere le generazioni vocali. MCP: get_tts_generation_status.	MCP
tts_generation_manage	Creare e riprovare generazioni vocali. MCP: generate_speech.	MCP
tts_generation_delete	Eliminare una generazione vocale. MCP: delete_tts_generation.	MCP
music_generation_get	Elencare i modelli musicali, elencare e leggere le generazioni musicali. MCP: get_music_generation_status.	MCP
music_generation_manage	Creare e riprovare generazioni musicali. MCP: generate_music.	MCP
music_generation_delete	Eliminare una generazione musicale. MCP: delete_music_generation.	MCP
transcription_get	Elencare i modelli di trascrizione, elencare e leggere le trascrizioni. MCP: get_transcription_status.	MCP
transcription_manage	Creare e riprovare trascrizioni, rinominare i parlanti. MCP: transcribe.	MCP
transcription_delete	Eliminare una trascrizione. MCP: delete_transcription.	MCP

Decisions

Autorizzazione	Cosa sblocca	MCP
decision_get	GET /decision_model, GET /decision, GET /decision/:id: elencare i modelli decisionali, elencare e leggere le tue decisioni.	-
decision_manage	POST /decision: eseguire una decisione e salvarla.	-
decision_delete	DELETE /decision/:id.	-

Integrazioni

Autorizzazione	Cosa sblocca	MCP
integrations_get	GET /integration (il catalogo dei provider) e la chiave pubblica del tunnel SSH.	-
integration_connections_get	GET /integration/connections.	-
integration_connections_manage	Collegare, ricollegare e aggiornare le connessioni.	-
integration_connections_delete	Eliminare una connessione.	-
integration_email_get	Leggere le informazioni della connessione email. MCP: list_email_connections.	MCP
integration_email_manage	Inviare email tramite un account collegato. MCP: send_email.	MCP
integration_crm_get	Route di lettura del CRM (informazioni sulla connessione, contatti, trattative, liste, tag). 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	Creare e modificare contatti del CRM, creare trattative. MCP: add_crm_contact, edit_crm_contact, create_crm_deal. Anche la connessione al CRM deve consentire l’accesso in scrittura.	MCP
integration_database_get	Leggere lo schema del database e le informazioni sulla connessione. MCP: list_database_connections, list_database_tables, describe_database_tables.	MCP
integration_database_manage	Eseguire una query su un database collegato. MCP: run_database_query. Cosa può fare la query lo stabilisce il livello di autorizzazione della connessione stessa.	MCP
integration_storage_get	Sfogliare, cercare e leggere elementi su un cloud drive collegato. MCP: list_storage_connections, browse_storage_folder, search_storage_files, get_storage_entry.	MCP
integration_storage_manage	Importare file da un cloud drive collegato ed esportarli verso di esso. MCP: import_storage_files, export_file_to_storage.	MCP

Autorizzazioni che al momento non sbloccano nulla

Nell’elenco potresti vedere prompt_variables_get, prompt_categories_get, prompt_categories_manage, prompt_categories_delete, image_generation_get e image_generation_delete. Oggi nessuna route o strumento MCP destinato ai clienti le usa, quindi spuntarle non ha alcun effetto.

Riservate al personale, non assegnabili

statistics_get, ai_models_manage, invite_codes_get, invite_codes_manage e invite_codes_delete sono riservate al personale di StickyPrompts. Non compaiono nell’elenco delle autorizzazioni, e una richiesta di assegnarle a una chiave viene rifiutata con 403 {"error":"You are using permissions that are restricted"}. Per questo lo strumento MCP get_usage_statistics non compare mai con le chiavi dei clienti. Gli amministratori trovano l’utilizzo del workspace nell’app, in Utilizzo, crediti e fatturazione.

Set di autorizzazioni consigliati

Parti da uno di questi set e aggiungi solo ciò che si rivela davvero necessario per la tua integrazione.

Bot di reportistica in sola lettura

Risponde a domande partendo da un database e dai tuoi documenti, senza scrivere nulla.

Autorizzazioni	Perché
ai_models_get, custom_run	Scegliere un modello e riassumere i risultati.
integration_database_get	Trovare la connessione e leggere lo schema.
integration_database_manage	Necessaria per eseguire qualsiasi query. Collega il database come Read only, così vengono accettate solo istruzioni SELECT.
knowledge_bases_get	Cercare nei documenti per avere contesto.

Chatbot

Un front end (per esempio un bot Slack interno) che dialoga con i tuoi agenti e la tua conoscenza.

Autorizzazioni	Perché
ai_models_get	Scegliere il modello per le nuove conversazioni.
conversations_manage, conversations_get	Avviare conversazioni, inviare messaggi e leggere le risposte.
agents_get	Trovare gli agenti da menzionare con @mention o con cui chattare.
knowledge_bases_get	Passare knowledge base a una conversazione.

Generatore di contenuti

Compila i tuoi prompt salvati e produce testi e immagini.

Autorizzazioni	Perché
ai_models_get	Scegliere un modello.
prompts_get, run_prompt	Trovare i prompt salvati ed eseguirli con le variabili.
custom_run	Generazioni singole senza un prompt salvato.
image_generation_manage, files_get	Generare immagini e recuperare i file risultanti.

Assistente CRM

Cerca contatti e trattative, mantiene aggiornato il CRM e invia i follow-up.

Autorizzazioni	Perché
integration_crm_get	Cercare ed elencare contatti e trattative.
integration_crm_manage	Aggiungere e modificare contatti, creare trattative. La connessione al CRM deve avere attivo Allow write access.
integration_email_get, integration_email_manage	Trovare la connessione email e inviare il follow-up.
ai_models_get, custom_run	Scrivere la bozza del testo dell’email.

Pagine correlate