Panoramica per sviluppatori

Tutto ciò che il tuo team crea in StickyPrompts - prompt, agenti, knowledge base, workflow, CRM e database collegati - è disponibile anche per il tuo codice. Puoi usarlo tramite una semplice API REST in JSON, oppure collegare un client MCP e lasciare che un assistente IA lo usi come un insieme di strumenti. Entrambi girano sullo stesso motore della web app, quindi valgono gli stessi modelli, gli stessi guardrail e le stesse regole di accesso.

Cosa puoi creare

REST o MCP?

	API REST	Server MCP
URL di base	https://api.stickyprompts.com/api/v1	https://api.stickyprompts.com/mcp/ (mantieni la barra finale)
Ideale per	Il tuo codice: backend, script, job pianificati	Client IA che parlano il Model Context Protocol
Forma	Endpoint per risorsa (GET /conversation, POST /run, …)	Strumenti (send_message, search_knowledge_base, send_email, …)
Copertura	La più ampia: crei e gestisci prompt, agenti, workflow, file, progetti, team e media	Un insieme mirato di strumenti per leggere, eseguire e agire
Autenticazione	Authorization: Bearer STICKY-API-...	Lo stesso header e la stessa chiave

Scegli REST quando è il tuo codice a decidere cosa succede. Scegli MCP quando vuoi che sia un modello a decidere quale strumento chiamare. Molti team usano entrambi con un’unica chiave: MCP nell’editor, REST nei job di produzione.

Alcune funzioni esistono da una parte sola. La ricerca semantica all’interno di una knowledge base è uno strumento MCP (search_knowledge_base) senza equivalente REST. Il caricamento dei file, invece, è solo REST: il server MCP può importare file da Google Drive con import_storage_files, ma non ha uno strumento di upload.

Una chiave per entrambi

Le chiavi API le crei tu, in Settings > API keys. Ogni chiave ha un nome e un insieme di autorizzazioni, e la chiave completa viene mostrata una sola volta. La stessa chiave autentica sia le chiamate REST sia le sessioni MCP:

Authorization: Bearer STICKY-API-<64 characters>

Per i dettagli, consulta Chiavi API e autenticazione.

Una chiave agisce come te, entro i limiti delle sue autorizzazioni

Una chiave non è un account di servizio separato. Agisce come l’utente che l’ha creata: vede il tuo workspace, i tuoi progetti e ciò che è stato condiviso con te, niente di più. Le sue autorizzazioni restringono poi ulteriormente questo perimetro. Una chiave che ha solo knowledge_bases_get può leggere le knowledge base che puoi leggere tu, ma non può toccare le tue conversazioni.

• Non esistono chiavi per workspace o per progetto. Definisci l’ambito di una chiave scegliendone le autorizzazioni.
• Le regole del workspace valgono comunque per ogni chiamata: l’accesso ai modelli, la residenza dei dati e i guardrail funzionano esattamente come nell’app.
• Via MCP, uno strumento per cui la tua chiave non ha l’autorizzazione non compare proprio nell’elenco degli strumenti.

L’elenco completo è nel riferimento delle autorizzazioni.

L’utilizzo conta come quello dell’app

Le chiamate API e MCP seguono lo stesso percorso di esecuzione, quote e fatturazione della web app. L’utilizzo viene attribuito al proprietario della chiave e al suo workspace come qualsiasi altro utilizzo e attinge agli stessi crediti. Non esiste un listino prezzi separato per l’API. Quando il workspace ha esaurito la quota, le chiamate REST che avviano lavoro a pagamento restituiscono 429 Quota exceeded (vedi Errori, paginazione e quote).

Niente webhook: recupera i risultati con il polling

L’API non invia webhook. La maggior parte delle chiamate è sincrona e restituisce il risultato completo. Per i lavori di lunga durata - video, sintesi vocale, musica e trascrizione via REST, elaborazione di fogli di calcolo, esecuzioni dei workflow - avvii il job e poi ne interroghi lo stato a intervalli regolari. Una conversazione avviata con l’endpoint di streaming si può seguire in tempo reale tramite il suo WebSocket, dove ogni frame contiene l’intero messaggio generato fino a quel momento.

Inizia da qui

Server MCP

Riferimento API REST