Documentação · MCP

Servidor MCP: as tools da GenOpt dentro do seu agente

Um endpoint MCP (JSON-RPC 2.0 sobre HTTP) que expõe busca de marcas, confabulações e verificação de evidência para Claude Desktop e qualquer client MCP. O que está nesta página existe em produção; o que não está, não existe.

Endereço

O caminho canônico será https://mcp.genopt.ai — o subdomínio está em preparo e ainda não resolve. Até lá, o endereço em produção é o fallback dentro da API: https://api.genopt.ai/api/mcp. Transporte: HTTP streamable mínimo — requisições JSON-RPC 2.0 via POST, uma mensagem por requisição. Stream SSE (GET) ainda não é suportado; um GET responde 405 com essa explicação.

Autenticação: Authorization: Bearer com o mesmo token da API (hoje o token interno, de uso server-side — API keys de cliente são a Fase 8 do roadmap). A única tool pública é check_public_hash, pelo mesmo desenho das rotas públicas de evidência: verificar um hash não pede conta a ninguém. Rate limit: 60 requisições por minuto por token.

Configuração no Claude Desktop

Adicione o servidor ao seu claude_desktop_config.json (ou cadastre como connector remoto apontando para a mesma URL). Quando o subdomínio estiver no ar, basta trocar a URL por https://mcp.genopt.ai.

claude_desktop_config.json

{
  "mcpServers": {
    "genopt": {
      "type": "http",
      "url": "https://api.genopt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <SEU_TOKEN>"
      }
    }
  }
}

As 5 tools

Tool	Auth	O que faz
search_brand	Bearer	Busca marcas monitoradas por nome ou domínio; devolve id, nome e domínio.
get_confabulations	Bearer	Totais por classe de citação + execuções CONFABULATED da marca, com filtros engine/intent/window.
verify_evidence	Bearer	Enfileira a reverificação de um run classificado; devolve o jobId da fila.
get_evidence	Bearer	Evidência completa de um run: resposta bruta, SHA-256, status de verificação e histórico.
check_public_hash	público	Verifica um hash SHA-256 de evidência — e, se você enviar o conteúdo, confere byte a byte.

Fluxo típico de um agente: search_brand para achar o id da marca → get_confabulations para ver o que as IAs inventaram → get_evidence ou verify_evidence com o runId de interesse. As tools executam as mesmas consultas das rotas da API v1 — o MCP é uma superfície, não uma segunda fonte de verdade.

Chamando na mão (sem client MCP)

O protocolo é JSON-RPC 2.0 puro — dá para inspecionar com curl. Os métodos suportados são initialize, ping, tools/list e tools/call.

curl

curl -X POST https://api.genopt.ai/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <SEU_TOKEN>' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"search_brand","arguments":{"query":"genopt"}}}'