Docs

MCP em uma página

Os atores do Model Context Protocol e a mensagem que o Xokepoint autoriza.

O Model Context Protocol é o padrão aberto que liga modelos de linguagem a tools e dados. O MCP host é o ambiente onde o agente roda, o MCP client é a parte do host que fala o protocolo, e o MCP server expõe tools que chamam as APIs de verdade. Sem o Xokepoint, o client fala direto com o server. Com ele, toda mensagem passa pelo PEP.

A mensagem que importa para a autorização é tools/call, em JSON-RPC 2.0. Ela tem o nome da tool e os argumentos que o modelo escolheu:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "create_issue",
    "arguments": {"repository": "acme/payments", "title": "Falha no checkout"}
  }
}

O detalhe que muda tudo está em arguments. A mesma tool, create_issue, pode ser inofensiva num repositório de testes e grave no repositório de pagamentos. Uma autorização que olha só o nome da tool não vê essa diferença. Por isso o Xokepoint lê os argumentos e, quando o mapping da tool diz qual argumento é o recurso, decide sobre ele (Mapping COAZ-MCP).

O Xokepoint também só aceita tools que o administrador revisou. Cada MCP server registrado tem um catálogo aprovado, com o inputSchema de cada tool. Quando o server publica uma tool nova, ela fica fora do catálogo até a revisão. Um server que muda sem aviso não ganha tools novas por isso.