MCP
Collega strumenti di AI a Tillor tramite https://mcp.tillor.dev
Ultimo aggiornamento il
Con MCP (Model Context Protocol) strumenti come Cursor, Claude, ChatGPT e Gemini possono chiamare l'API di Tillor al posto tuo. Accedi una sola volta tramite OAuth; nella tua configurazione non deve comparire nessuna chiave API.
URL: https://mcp.tillor.dev
Cosa puoi fare
Dopo il collegamento, nello strumento di AI puoi:
- Consultare le categorie API e gli endpoint (dalla specifica OpenAPI)
- Chiamare gli endpoint con i tuoi diritti nell'organizzazione scelta
Il tutto passa dalla stessa API REST dell'API HTTP. Ciò che puoi fare dipende dal tuo account Tillor e dai tuoi permessi in quell'organizzazione. Il collegamento tramite OAuth richiede il permesso Autorizzare app OAuth (oauth:consent) in almeno un'organizzazione. Senza questo permesso il consenso non riesce e i token OAuth esistenti smettono di funzionare.
Autenticazione
- Lo strumento si collega a
https://mcp.tillor.devsenza token - Discovery e registrazione OAuth passano dall'host MCP; login e consenso avvengono su Tillor
- Approvi l'accesso nel browser
- Lo strumento invia poi un token Bearer con le chiamate MCP
Invia la tua organizzazione come header quando lo strumento lo supporta (Cursor, Gemini CLI):
X-Tillor-Org-Id: org_abc123Senza quell'header (ChatGPT, app Gemini, Claude) indichi organizationId in call_api_endpoint. Le route dell'organizzazione si trovano sotto /orgs/{organizationId}; l'API compila allora l'header da sola.
Nessuna chiave API necessaria
Per il server MCP ospitato usi OAuth (Connect / Authorize nello strumento). Per script e integrazioni proprie continui a usare le chiavi API.
Collegamento
Scegli il tuo strumento:
Snelste weg: voeg Tillor toe in Cursor. Of zet dit in ~/.cursor/mcp.json (globaal) of .cursor/mcp.json (project):
{
"mcpServers": {
"Tillor": {
"url": "https://mcp.tillor.dev",
"headers": {
"X-Tillor-Org-Id": "org_abc123"
}
}
}
}Vervang org_abc123 door je organisatie-ID. Herlaad de MCP-servers en kies bij Tillor Connect of Authorize.
Oppure apri il selettore di installazione per Cline, Zed, Warp, Codex e tutti gli altri.
Strumenti
| Strumento | Scopo |
|---|---|
list_api_categories | Elenca le categorie API |
list_api_endpoints | Endpoint di una categoria, con schema di input |
get_api_endpoint_schema | Schema di un singolo endpoint per nome |
call_api_endpoint | Chiama un endpoint |
I nomi degli endpoint non sono strumenti a sé: usa call_api_endpoint.
Il riferimento REST completo resta OpenAPI. MCP è un livello costruito sopra, non un'API di prodotto separata.
Correlati
- API HTTP - chiavi API, header e base URL
- OpenAPI - specifica completa dell'API
- Riferimento API - ogni endpoint, da provare nel browser