O Kaption expõe o WhatsApp a apps e agentes de IA por meio de um único servidor MCP. Esta página lista todos os endpoints, documentos e repositórios de que você precisa.
Endereço do servidor MCP
https://mcp.kaptionai.com/mcpUm servidor MCP remoto via Streamable HTTP. Ele usa JSON-RPC 2.0 e funciona com qualquer cliente MCP compatível com OAuth. As ferramentas rodam na extensão ou no app para computador do Kaption, no próprio computador do usuário, então o usuário precisa estar com o Kaption aberto.
OAuth 2.1 com PKCE (S256) e registro dinâmico de clientes. Há um único escopo, kaption:access. Os usuários fazem login com o número de telefone e um código enviado a eles pelo WhatsApp, e depois escolhem quanto tempo a conexão dura. Os tokens de acesso expiram depois de uma hora. Chamadas sem token recebem HTTP 401 com um cabeçalho WWW-Authenticate que aponta para os metadados do recurso protegido.
Streamable HTTP. Também há um endpoint SSE em /sse para clientes mais antigos.
mcp.kaptionai.com/mcpMetadados do recurso protegido (RFC 9728), com link para o servidor de autorização.
mcp.kaptionai.com/.well-known/oauth-protected-resource/mcpDescrição OpenAPI 3.1 do endpoint HTTP, do esquema OAuth e das respostas de erro.
kaptionai.com/openapi.jsonNome, endpoints remotos, pacote e detalhes de autenticação no formato server.json do MCP Registry.
kaptionai.com/.well-known/mcp.jsonLinkset RFC 9727 que lista os serviços deste domínio.
kaptionai.com/.well-known/api-catalogUm guia do site em texto simples para agentes de IA: o que o Kaption faz e quando usá-lo.
kaptionai.com/llms.txtO pacote npm para clientes que rodam servidores locais. Requer Node.js 18 ou mais recente.
www.npmjs.com/package/@kaptionai/mcp-extensionO código-fonte do relay na nuvem é público. Cada deploy é assinado e registrado em um log público.
github.com/Kaption-AI/mcp-extension-remoteO servidor na nuvem expõe estas ferramentas. A partir do Kaption 0.94, send_message funciona a menos que o usuário tenha desativado “Permitir que os assistentes enviem mensagens deste computador” no Kaption para essa conta de WhatsApp; um assistente não pode mudar essa opção, e mesmo assim deve confirmar o texto e o destinatário com o usuário. Ele coloca na fila uma mensagem, com no máximo um anexo de 8 MiB, para um chat existente com uma pessoa ou um grupo compatível, para a primeira entrega permitida, e “na fila” não é prova de entrega. Com a opção desativada, a IA pode deixar um rascunho ou agendar uma mensagem para uma pessoa. Chats que o usuário trancou no WhatsApp nunca ficam visíveis.
querylist_contactsget_contactget_contact_groupslist_groupsget_groupexport_contactsdownload_mediaget_analyticssummarize_conversationmanage_chatmanage_remindersmanage_listsmanage_labelsmanage_notesmanage_scheduled_messagessend_messagecall_recordingsRelate vulnerabilidades de forma privada para security@kaptionai.com. Por favor, não abra uma issue pública.
Todo erro que o servidor gera é um documento de problema RFC 9457, servido como application/problem+json, com type, title, status, detail e um code legível por máquina. Decida pelo code; o detail é para pessoas. Erros nunca são HTML.
Dentro do transporte MCP (/mcp e /sse), erros de protocolo são objetos de erro JSON-RPC, como a especificação MCP exige, e uma ferramenta que falha devolve um resultado com isError: true.
| Status | Códigos |
|---|---|
| 400 | bad_requestinvalid_jsoninvalid_inputinvalid_content_typeinvalid_phonemissing_credentialsmissing_parametersinvalid_account_idinvalid_connection_idinvalid_authorization_requestinvalid_oauth_stateinvalid_sessionotp_invalidotp_expiredotp_attempts_exceededverification_expiredconnect_code_malformedconnect_code_expired |
| 401 | unauthorizedauthentication_requiredinvalid_tokenmissing_bearer_tokeninvalid_credentials |
| 403 | forbidden |
| 404 | not_foundnot_configuredreviewer_not_configured |
| 405 | method_not_allowed |
| 406 | not_acceptable |
| 409 | conflict |
| 410 | gone |
| 413 | payload_too_large |
| 415 | unsupported_media_type |
| 422 | unprocessable_content |
| 426 | upgrade_required |
| 429 | rate_limited |
| 500 | internal_errorotp_send_failedauthorization_failed |
| 501 | not_implemented |
| 502 | bad_gatewayupstream_errorhandshake_unavailable |
| 503 | service_unavailable |
| 504 | gateway_timeout |
Pedidos limitados recebem 429 com o cabeçalho Retry-After (segundos) e code rate_limited. Respostas contadas trazem RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset (segundos) da política mais perto de acabar, e RateLimit-Policy lista todas as que se aplicam.
| Política | Limite | Janela | Contado em |
|---|---|---|---|
| otp-send-account | 50 | 60 min (fixa) | /authorize/send-otp, /ext-auth/send-otp |
| otp-send-ip | 100 | 60 min (fixa) | /authorize/send-otp, /ext-auth/send-otp, /authorize/resend-otp |
| otp-resend-account | 3 | 10 min (fixa) | /authorize/resend-otp |
| connect-code-redeem-ip | 20 | 10 min (reinicia a cada tentativa) | /connect/remember, /authorize/connect-code |
| connect-code-start-account | 10 | 60 min (reinicia a cada tentativa) | /ext/connect-code/start |
| reviewer-login-ip | 10 | 15 min (reinicia a cada tentativa) | /authorize/reviewer-login |
As chamadas de ferramentas têm uma cota definida pelo plano do Kaption (https://kaptionai.com/pt/pricing/). Acima disso, a chamada recebe um erro de ferramenta MCP com um link para os preços; a conexão continua aberta e não é um HTTP 429. Listar ferramentas, conectar e chamadas que falham não contam. Envio em massa ou não solicitado continua proibido pelos termos, e o acesso pode ser suspenso para proteger o serviço.
A interface pública do Kaption é o servidor MCP. O arquivo OpenAPI descreve esse endpoint HTTP para que ferramentas que leem OpenAPI consigam encontrá-lo; as operações em si são ferramentas MCP chamadas via JSON-RPC.
Não. Toda chamada, incluindo initialize e tools/list, precisa de um token. Os nomes das ferramentas estão listados nesta página e no cartão do servidor.
Claude, ChatGPT, Cursor e outros clientes compatíveis com servidores MCP remotos com OAuth. Clientes que rodam servidores locais podem usar o pacote npm.