Como conectar um cliente MCP à GoZAP?

A origem pública depende do ambiente onde o servidor está implantado. O caminho do serviço é /mcp; ele aceita JSON-RPC por HTTP e disponibiliza transporte SSE.

“Emita um token com os escopos necessários para as ações que o agente deve executar.”

Como funciona o transporte?

No transporte SSE, o cliente abre GET /mcp/ com Accept: text/event-stream e Authorization: Bearer <JWT>. As chamadas JSON-RPC também podem ser enviadas por POST /mcp/. Por exemplo, para listar ferramentas, envie o método MCP tools/list:

{"jsonrpc":"2.0","id":1,"method":"tools/list"}
Rotas MCP

GET /mcp/ POST /mcp/ POST /mcp/message

Quais escopos existem?

O catálogo declara cinco escopos:

  • instance:status
  • messages:send
  • messages:read
  • contacts:read
  • groups:read

O JWT determina quais ferramentas ficam disponíveis. Não há no catálogo atual um escopo groups:manage.

Quais ferramentas posso chamar?

O catálogo inclui ferramentas de status da instância e envio de mensagens de texto e mídia. Cada ferramenta define seu caminho de API, schema de entrada e escopo.

Exemplos do catálogo

get_instance_status → GET /instance/status send_text_message → POST /send/text send_media_message → POST /send/media

O que os registros de auditoria guardam?

O servidor grava o subdomínio, nome da ferramenta ou método, status, latência, erro e data de criação. O formato não registra todos os parâmetros da chamada.