Como conectar um cliente MCP à GoZAP?

Na operação hospedada, a URL do servidor é https://mcp.gozap.dev/, sem /mcp no final. 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 / com Accept: text/event-stream e Authorization: Bearer <JWT>. As chamadas JSON-RPC também podem ser enviadas por POST /. Por exemplo, para listar ferramentas, envie o método MCP tools/list:

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

GET / POST / POST /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.