MCP
Conectați instrumente AI la Tillor prin https://mcp.tillor.dev
Ultima actualizare la
Prin MCP (Model Context Protocol), instrumente precum Cursor, Claude, ChatGPT și Gemini pot apela API-ul Tillor în numele dumneavoastră. Vă autentificați o singură dată prin OAuth; în configurație nu trebuie să apară nicio cheie API.
URL: https://mcp.tillor.dev
Ce puteți face cu el
După conectare, în instrumentul AI puteți:
- să vizualizați categoriile API și endpointurile (din specificația OpenAPI)
- să apelați endpointuri cu drepturile dumneavoastră în organizația aleasă
Totul trece prin același API REST ca API-ul HTTP. Ce aveți voie să faceți depinde de contul dumneavoastră Tillor și de permisiunile din organizația respectivă. Conectarea prin OAuth cere permisiunea Autorizare aplicații OAuth (oauth:consent) în cel puțin o organizație. Fără această permisiune, consimțământul eșuează, iar tokenurile OAuth existente nu mai funcționează.
Autentificare
- Instrumentul se conectează la
https://mcp.tillor.devfără token - Descoperirea și înregistrarea OAuth se desfășoară pe gazda MCP; autentificarea și consimțământul se fac în Tillor
- Aprobați accesul în browser
- Apoi instrumentul trimite un token Bearer la fiecare apel MCP
Trimiteți organizația ca antet atunci când instrumentul permite acest lucru (Cursor, Gemini CLI):
X-Tillor-Org-Id: org_abc123Fără acest antet (ChatGPT, aplicația Gemini, Claude) transmiteți organizationId la call_api_endpoint. Rutele de organizație se află sub /orgs/{organizationId}; API-ul completează apoi singur antetul.
Nu este nevoie de cheie API
Pentru serverul MCP găzduit folosiți OAuth (Connect / Authorize în instrument). Pentru scripturi și integrări proprii continuați să folosiți chei API.
Conectare
Alegeți instrumentul:
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.
Sau deschideți selectorul de instalare pentru Cline, Zed, Warp, Codex și restul.
Instrumente
| Instrument | Scop |
|---|---|
list_api_categories | Listează categoriile API |
list_api_endpoints | Endpointurile dintr-o categorie, cu schema de intrare |
get_api_endpoint_schema | Schema unui singur endpoint, după nume |
call_api_endpoint | Apelează un endpoint |
Numele endpointurilor nu sunt instrumente separate: folosiți call_api_endpoint.
Referința REST completă rămâne OpenAPI. MCP este un strat peste aceasta, nu un API de produs separat.
Legate de acest subiect
- API HTTP - chei API, antete și base URL
- OpenAPI - specificația completă a API-ului
- Referința API - fiecare endpoint, de încercat în browser