MCP
Ligue ferramentas de IA ao Tillor através de https://mcp.tillor.dev
Última atualização em
Com o MCP (Model Context Protocol), ferramentas como o Cursor, o Claude, o ChatGPT e o Gemini chamam a API do Tillor por si. Inicia sessão uma vez através de OAuth; na sua configuração não precisa de constar nenhuma chave de API.
URL: https://mcp.tillor.dev
O que pode fazer com isto
Depois de ligado, na ferramenta de IA pode:
- Consultar categorias de API e endpoints (a partir da especificação OpenAPI)
- Chamar endpoints com os seus direitos na organização escolhida
Tudo passa pela mesma API REST que a API HTTP. O que pode fazer depende da sua conta Tillor e das suas permissões nessa organização. Para ligar através de OAuth é necessária a permissão Autorizar aplicações OAuth (oauth:consent) em pelo menos uma organização. Sem essa permissão, o consentimento falha e os tokens OAuth existentes deixam de funcionar.
Autenticação
- A ferramenta liga-se a
https://mcp.tillor.devsem token - A descoberta e o registo OAuth decorrem no anfitrião MCP; o início de sessão e o consentimento no Tillor
- Aprova o acesso no navegador
- Depois disso, a ferramenta envia um token Bearer nas chamadas MCP
Envie a sua organização como cabeçalho quando a ferramenta o suportar (Cursor, Gemini CLI):
X-Tillor-Org-Id: org_abc123Sem esse cabeçalho (ChatGPT, aplicação Gemini, Claude), indique organizationId em call_api_endpoint. As rotas da organização ficam em /orgs/{organizationId}; a API preenche então o cabeçalho por si.
Não é necessária chave de API
Para o servidor MCP alojado, utilize OAuth (Connect / Authorize na ferramenta). Para scripts e integrações próprias, continue a utilizar chaves de API.
Ligar
Escolha a sua ferramenta:
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.
Ou abra o seletor de instalação para Cline, Zed, Warp, Codex e as restantes.
Ferramentas
| Ferramenta | Finalidade |
|---|---|
list_api_categories | Lista as categorias de API |
list_api_endpoints | Endpoints de uma categoria, com esquema de entrada |
get_api_endpoint_schema | Esquema de um endpoint pelo nome |
call_api_endpoint | Chama um endpoint |
Os nomes dos endpoints não são ferramentas separadas: utilize call_api_endpoint.
A referência REST completa continua a ser o OpenAPI. O MCP é uma camada por cima dela, não uma API de produto separada.
Relacionado
- API HTTP - Chaves de API, cabeçalhos e URL base
- OpenAPI - Especificação completa da API
- Referência da API - Todos os endpoints, para experimentar no navegador