MCP Server — Endpoints

Todas as respostas seguem o formato {"success": bool, "data" | "error": {...}, "meta": {"timestamp": ...}}.

GET /mcp/health

Público, sem autenticação. Confirma que o serviço está no ar.

curl --silent https://api.conexaoazul.com/mcp/health

{"success": true, "data": {"status": "ok", "mcp_server_version": "1.0.0"}, "meta": {"timestamp": "2026-07-24T04:24:52.930070+00:00"}}

GET /mcp/models

Lista os modelos habilitados para o usuário autenticado, com nome técnico e nome de exibição.

curl --silent \
  --header "X-API-Key: ${MCP_API_KEY}" \
  https://api.conexaoazul.com/mcp/models

Resposta (formato):

{
  "success": true,
  "data": {
    "models": [
      { "model": "crm.lead", "name": "Lead/Opportunity" }
    ]
  },
  "meta": { "timestamp": "..." }
}

Sem chave ou com chave inválida, retorna 401:

{"success": false, "error": {"message": "Authentication required. Provide a valid API key (X-API-Key header) or session cookie.", "code": "E401"}, "meta": {"timestamp": "..."}}

GET /mcp/models/{model}/access

Verifica se um modelo específico está habilitado para o usuário e retorna as operações permitidas (read, create, write, unlink).

curl --silent \
  --header "X-API-Key: ${MCP_API_KEY}" \
  https://api.conexaoazul.com/mcp/models/crm.lead/access

Status	Situação
200	Modelo habilitado — retorna as operações permitidas
401	Chave ausente ou inválida
403	Modelo existe no Odoo, mas não está habilitado para MCP
404	Modelo não existe na instância
503	MCP Server desabilitado globalmente

Limites

O MCP Server aplica rate limiting por usuário (configurável pela Conexão Azul). Requisições acima do limite retornam 429.