Desenvolvedores

Construa com o Kaption usando MCP

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/mcp

O endpoint

Um 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.

Autenticação

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.

Referência

Endpoints e documentos

Ferramentas

Ferramentas

O servidor na nuvem expõe estas ferramentas. Nenhuma delas envia uma mensagem na hora: 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.

  • query
  • list_contacts
  • get_contact
  • get_contact_groups
  • list_groups
  • get_group
  • export_contacts
  • download_media
  • get_analytics
  • summarize_conversation
  • manage_chat
  • manage_reminders
  • manage_lists
  • manage_labels
  • manage_notes
  • manage_scheduled_messages
  • call_recordings
Bom saber

Limites

  • As ferramentas só funcionam enquanto o usuário está com o Kaption aberto: o WhatsApp Web com a extensão, ou o app para computador.
  • O acesso tem limite de frequência. Mensagens em massa ou não solicitadas violam os termos.
  • Uma mensagem agendada vai para uma pessoa e tem no máximo 800 caracteres.
Desenvolvedores

Segurança

Relate vulnerabilidades de forma privada para security@kaptionai.com. Por favor, não abra uma issue pública.

Perguntas

Existe uma API REST?

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.

Posso listar as ferramentas sem fazer login?

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.

Quais clientes funcionam?

Claude, ChatGPT, Cursor e outros clientes compatíveis com servidores MCP remotos com OAuth. Clientes que rodam servidores locais podem usar o pacote npm.

Transcreva um áudio agora