Documentação · Integrações
Integrações: o que conecta hoje e o que é roadmap
Uma integração no ar (MCP), dois SDKs prontos aguardando publicação e três planejadas que respondem 501 honesto. Esta é a versão técnica do catálogo /integracoes — mesmos fatos, mais detalhe.
Estado de cada integração
| Integração | Status | Detalhe |
|---|---|---|
| MCP (Model Context Protocol) | no ar | Servidor JSON-RPC 2.0 com 5 tools; conecta Claude Desktop e qualquer client MCP às medições. |
| SDK TypeScript | pronto — aguardando publicação | Cliente tipado da API v1, pronto no monorepo (packages/sdk-js); falta publicar no npm. |
| SDK Python | pronto — aguardando publicação | Mesmo cliente em Python (packages/sdk-python); falta publicar no PyPI. |
| Webhooks | planejado | Sprint 4E. /v1/webhooks responde 501 honesto; desenho em /docs/webhooks. |
| Slack | planejado | Sprint 4E. Consumidor dos webhooks; /v1/integrations/slack responde 501. |
| Discord | planejado | Sprint 4E. Consumidor dos webhooks; /v1/integrations/discord responde 501. |
| Zapier | planejado | Sprint 4E. Depende de API keys de cliente (Fase 8); /v1/integrations/zapier responde 501. |
MCP: no ar
O servidor MCP do GenOpt responde em mcp.genopt.ai — JSON-RPC 2.0 sobre HTTP (métodos initialize, ping, tools/list, tools/call), com estas 5 tools. A configuração para Claude Desktop, o endereço de fallback dentro da API e exemplos curl estão em /docs/mcp.
| Tool | Auth | O que faz |
|---|---|---|
| search_brand | Bearer | Busca marcas monitoradas por nome ou domínio; devolve o brandId aceito pelas outras tools. |
| get_confabulations | Bearer | Totais por classe de citação + execuções CONFABULATED, 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ção pública de um hash SHA-256 — com conferência byte a byte se o conteúdo for enviado. |
SDKs: prontos, aguardando publicação
Os SDKs TypeScript e Python existem no monorepo e mapeiam exatamente os endpoints reais da API v1 — scans, confabulações, evidência, ground truth e verificação pública. O que falta é a publicação no npm e no PyPI: até lá, não há pacote para instalar, e não vamos fingir que há. Uso, assinatura das funções e o estado da publicação estão em /docs/sdk.
Slack, Discord e Zapier: planejados (Sprint 4E)
Os três são consumidores dos webhooks — por isso entram depois deles. As rotas já existem na API e respondem 501 Not Implemented com o status real, para que nenhum chamador plausível caia num 404 ambíguo:
$ curl -si https://api.genopt.ai/v1/integrations/slack
HTTP/1.1 501 Not Implemented
content-type: application/json; charset=utf-8
{"status":"planned","roadmap":"Sprint 4E"}A versão não-técnica deste catálogo, com o mesmo rótulo honesto por integração, está em /integracoes.