Protocolo MCP

Conecte qualquer cliente MCP — configuração do endpoint, autenticação, descoberta de ferramentas e exemplos para Claude, ChatGPT e agentes.

Visão geral

A API é baseada em REST, devolve JSON e é encriptada E2E. Todos os endpoints requerem autenticação via Keycloak SSO (token bearer OAuth2). O isolamento de inquilinos é aplicado em todos os níveis.

Autenticação

Todos os pedidos de API requerem um token Bearer obtido do Keycloak. O token tem âmbito de inquilino e expira após 1 hora. Tokens de atualização são fornecidos para sessões de longa duração.

Endpoints principais

POST /api/missions — submete uma nova missão. GET /api/missions/:id — obtém o estado da missão. GET /api/brain/query — consulta o Brain/RAG. GET /api/hit — lista aprovações HIT pendentes. POST /api/hit/:id/approve — aprova um item HIT.

Exemplos de código

Consulte a referência da API para exemplos de curl, Python e JavaScript. O protocolo MCP permite a descoberta e execução direta de ferramentas a partir de qualquer cliente compatível com MCP.

Limites de taxa

Os limites de taxa são por inquilino e por nível. Starter: 100 req/min. Business: 500 req/min. Professional: 2.000 req/min. Enterprise: personalizado. Todos os limites são expansíveis até 2x durante 10 segundos.