WA MCP
Allows interaction with WhatsApp through multiple linked sessions, providing tools to check session status, retrieve the authorized profile, list chats, retrieve and search messages, and send text messages.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
WA MCP
Aplicativo Windows em Tauri 2 + React, com múltiplas sessões WhatsApp e um endpoint MCP autenticado por sessão.
Instalar
Baixe o instalador .exe em Releases.
Instale e abra WA MCP. No primeiro acesso, crie o administrador (somente neste computador).
Em Configurações → Aplicativo, configure o token do seu Cloudflare Tunnel.
Em Configurações → Conexões WhatsApp, crie uma conexão e escaneie o QR Code em WhatsApp → Aparelhos conectados. Cada conexão vira uma caixa de entrada do atendimento.
Na aba ChatGPT da conexão, gere o código de autorização, ou gere um token em Acesso MCP para outro cliente MCP.
Autorize somente a conexão e as permissões que deseja compartilhar.
O mesmo aplicativo web abre na janela do Windows e no navegador de outros computadores da rede: o endereço aparece em Configurações → Aplicativo → Acesso pela rede e cada pessoa entra com o próprio login e senha.
O instalador inclui o serviço (em Rust, dentro do próprio aplicativo) e o cloudflared. Não é necessário instalar ferramentas de desenvolvimento para usar o aplicativo. O instalador inicial não tem assinatura Authenticode.
Fechar a janela mantém o aplicativo na bandeja. Clique no ícone verde para abrir novamente; use Sair para encerrar o serviço e o túnel. O computador deve permanecer ligado e conectado à internet.
Por padrão, o WA MCP inicia automaticamente com o Windows (minimizado na bandeja, sem abrir a janela). Desative em Configurações → Aplicativo → Iniciar com o Windows se preferir abrir manualmente.
Atualizações automáticas
A partir da versão 26.10.3, o aplicativo verifica novas releases ao abrir e a cada seis horas. O download ocorre em segundo plano e a assinatura é validada com a chave pública embutida. Quando estiver pronto, clique Reiniciar e atualizar no aviso; o aplicativo encerra seus serviços, instala silenciosamente e reabre. As sessões e o histórico permanecem no perfil do Windows. Também é possível usar Configurações → Aplicativo → Verificar atualizações. Sem internet, a versão atual continua funcionando.
Versões anteriores precisam de uma instalação manual para receber o atualizador. A assinatura do atualizador é independente de Authenticode: ela protege o pacote de atualização, mas não remove avisos do Windows sobre editor desconhecido.
Related MCP server: whatsapp-web-mcp
MCP
Endpoint: https://wamcp.cappyfy.com/mcp/<session-id>
Transporte: Streamable HTTP sem estado. O ChatGPT usa OAuth 2.1 com PKCE S256 e registro dinâmico de cliente (DCR). Outros clientes podem usar o cabeçalho Bearer personalizado.
ChatGPT
Ative o modo de desenvolvedor nas configurações do ChatGPT, se disponível para sua conta/workspace.
Abra Plugins, use + e informe a URL MCP da sessão. Escolha OAuth, deixando Client ID e Client Secret vazios para registro automático.
No WA MCP → Configurações → Conexões WhatsApp → conexão → ChatGPT, escolha Somente leitura ou Leitura e envio e gere um código temporário.
Na página de autorização em
wamcp.cappyfy.com, cole esse código e confirme.
O código é de uso único e expira em dez minutos. O access token dura uma hora; o refresh token é rotacionado, com autorização limitada a 90 dias. A lista Conexões autorizadas permite revogar a conexão imediatamente. O aplicativo e o túnel devem continuar funcionando no PC.
Isso disponibiliza um servidor compatível com plugins MCP do ChatGPT. A instalação na conta deve ser concluída pelo usuário; não representa publicação no diretório público da OpenAI. A disponibilidade da criação de plugins depende da conta e das políticas do workspace.
Metadados por sessão: /.well-known/oauth-protected-resource/mcp/<session-id>. Metadados do emissor: /.well-known/oauth-authorization-server. As ferramentas declaram os escopos OAuth, e get_profile identifica somente a sessão autorizada. O registro de clientes aceita apenas callbacks HTTPS conhecidos do ChatGPT, com correspondência exata no fluxo. Não é anunciado suporte a CIMD, private_key_jwt ou RFC 9207.
Outros clientes
{
"mcpServers": {
"whatsapp": {
"url": "https://wamcp.cappyfy.com/mcp/SEU_ID",
"headers": { "Authorization": "Bearer SEU_TOKEN" }
}
}
}O formato acima é um exemplo; ajuste-o ao seu cliente MCP.
Ferramenta | Permissão |
| Leitura |
| Leitura |
| Leitura |
| Leitura |
| Leitura |
| Leitura |
| Leitura e envio |
Tokens Bearer e tokens OAuth de acesso/renovação são aleatórios, armazenados por hash SHA-256, limitados a uma sessão e revogáveis. A interface cria tokens Bearer válidos por 90 dias. Ferramentas de envio só são anunciadas para tokens com essa permissão. Os registros DCR e seus segredos de cliente persistem no SQLite local para permitir reconexão após reiniciar o aplicativo.
Mensagens, áudios e arquivos
Para enviar texto, autorize a conexão com Leitura e envio e use send_message com o jid real de list_chats e o texto autorizado. Uma conexão existente de somente leitura precisa ser autorizada novamente com envio; atualizar o aplicativo não amplia suas permissões. Se o envio não for confirmado, consulte o histórico antes de repetir.
get_messages e search_messages incluem media com tipo, MIME, nome do arquivo, tamanho, duração e indicação de mensagem de voz quando disponíveis. Use get_media com jid e messageId (o campo id da mensagem) para baixar o anexo. Áudios são retornados como conteúdo de áudio MCP; documentos, imagens e vídeos como recursos binários incorporados, sem links públicos. O cliente MCP precisa suportar esses formatos para reproduzir ou salvar o conteúdo. Não há transcrição automática.
O download exige a sessão conectada, tem limite de 10 MiB e espera de até 30 segundos. Mídias antigas podem ter expirado no WhatsApp. Mensagens já armazenadas antes desta atualização não contêm os dados necessários ao download, salvo se forem sincronizadas novamente. Os dados de download persistem no SQLite; o conteúdo binário é baixado sob demanda e não é salvo em disco pelo servidor. Reinicie o aplicativo atualizado e atualize a lista de ferramentas no cliente para descobrir get_media.
Dados locais
%LOCALAPPDATA%\com.cappyfy.wamcp\
wamcp.sqlite: sessões, conversas, mensagens, hashes dos tokens e auditoria.auth/: credenciais de aparelhos WhatsApp.tunnel.token: credencial local do Cloudflare Tunnel.media/<sessão>/<AAAA>/<MM>/: anexos das conversas.
O SQLite é criado automaticamente no PC da instalação. Nenhum histórico ou token é incluído no instalador ou enviado ao GitHub. Antes de cada atualização que muda o esquema do banco, o app guarda uma cópia em backups/wamcp-v<versão>-<data>.sqlite (ficam as 3 mais novas); para desfazer uma atualização, encerre o app e coloque a cópia no lugar de wamcp.sqlite. Para um backup completo, encerre o aplicativo e copie a pasta de dados. O banco não é criptografado; ele usa as proteções do perfil do Windows.
Túnel
Configure o hostname público para http://127.0.0.1:17382. O aplicativo inicia seu próprio processo cloudflared com um arquivo de token, sem instalar um serviço global do Windows.
Um só aplicativo: desktop e rede
O backend embutido escuta em uma única porta (0.0.0.0:17382) com o app web, a API, o MCP e o OAuth. A janela do Tauri abre http://127.0.0.1:17382/app/; outros computadores da rede abrem http://<ip-deste-pc>:17382/app/ no navegador (o endereço aparece em Configurações > Aplicativo). Todos entram com e-mail e senha; o primeiro administrador só pode ser criado no próprio computador. Iniciar com o Windows, túnel e atualização aparecem apenas na janela do aplicativo. Libere a porta 17382 no firewall do Windows para a rede local.
wamcp.cappyfy.com é o endereço desta implantação. Execute o conector em apenas um computador com estas sessões: réplicas com bancos diferentes não compartilham contas ou tokens. Para outra implantação, adapte publicUrl e configure um hostname/túnel próprio.
Servidor Linux e Docker
O mesmo backend roda num servidor Linux, sem a janela, a bandeja e o túnel do Windows. Com Docker:
C3THEME_TOKEN=<token com leitura do cecon/C3Theme> docker compose up -d --buildO token só é usado para baixar o tema do app durante o build e não fica na imagem.
Os dados ficam no volume
wamcp-data(/datano contêiner), com as cópias automáticas em/data/backups.A imagem já traz o Claude Code e o OpenCode para os agentes de IA. Para escolher outros, use
docker compose build --build-arg AGENT_CLIS="@openai/codex"(vazio: nenhum). Entre na conta de cada um comdocker compose exec wamcp claudeoudocker compose exec wamcp opencode auth login.O primeiro administrador só pode ser criado a partir do próprio servidor. Abra um túnel SSH (
ssh -L 17382:127.0.0.1:17382 seu-servidor), acessehttp://127.0.0.1:17382/app/no seu computador e crie a conta. Depois, pareie o WhatsApp pelo app, como no Windows.O compose usa a rede do host e escuta só em
127.0.0.1. Para acessar de fora, ponha um proxy com HTTPS na frente (Caddy, nginx) ou troqueWAMCP_BINDpara0.0.0.0.
Sem Docker: instale as dependências como no CI (pnpm install, com o C3Theme), rode pnpm run build, depois cargo build --manifest-path src-tauri/Cargo.toml -p wamcp-server --release, e rode src-tauri/target/release/wamcp-server com WAMCP_WEB_DIR=dist e WAMCP_DATA_DIR=/caminho/dos/dados.
Canal do GitHub
Em Configurações → Canais, conecte um repositório GitHub com um token fine-grained que tenha escrita em Issues, Pull requests e Webhooks. O app cria a caixa de entrada e o webhook no repositório; ao conectar, a tela mostra o que aconteceu passo a passo (token autenticado, repositório acessível e webhook criado ou o motivo exato da recusa), com a URL/segredo para cadastrar à mão se necessário.
Se o token não puder criar o webhook, use Tentar criar webhook de novo (com o token já salvo) ou cadastre-o no GitHub em Settings → Webhooks → Add webhook com a URL e o segredo mostrados. Enquanto o webhook não existir, nenhum evento chega — o app avisa isso na própria tela do canal.
As entregas do GitHub (o ping de teste e cada evento, com o status HTTP respondido) aparecem na conexão e na tela do canal, com botão Atualizar; assim dá para ver na hora se o repositório está entregando. Os eventos acompanhados são pull_request, pull_request_review, pull_request_review_comment, issues, issue_comment, workflow_run e push.
Eventos no ChatGPT
O servidor oferece message.created para novas mensagens recebidas, com filtro opcional por conversa e entrega HTTPS assinada. A assinatura é criada pelo ChatGPT somente quando o usuário pede monitoramento; a atualização não ativa automações por conta própria. Consulte MCP_EVENTS.md para limites, segurança e o teste completo após atualizar e reescanear o plugin.
Contribuindo
Quer contribuir com o WA MCP? Abaixo está o necessário para rodar o projeto localmente; para padrões de código, limites de arquivo, testes exigidos e o fluxo de PR, consulte CONTRIBUTING.md.
Requisitos: Windows x64, Node.js 24, Rust estável, Visual Studio Build Tools com C++ e WebView2.
npm ci
npm run desktopPrévia web: execute npm run server (backend Rust em src-tauri/server) e npm run dev, e abra http://127.0.0.1:1420; o Vite encaminha a API para a porta 17382. No primeiro acesso local, crie o administrador.
npm run check
npm run test:e2e
npm run desktop:buildPlugins
O que os agentes de IA sabem fazer vem dos plugins. Em Configurações → Plugins, cole ou escolha um plugin.json com skills, ferramentas (HTTP ou servidor MCP) e as credenciais que elas usam. Depois libere as ferramentas para cada agente em Motor de agentes. As credenciais ficam seladas no app e o modelo nunca as vê. Exemplo mínimo:
{
"id": "delivery",
"name": "Delivery",
"version": "1.0.0",
"skills": [{ "name": "Atender pedido", "instructions": "Anote o pedido, confirme o endereço e o total." }],
"credentials": [{ "name": "token", "help": "Chave da API da loja" }],
"tools": [
{
"name": "anotar_pedido",
"description": "Registra um pedido na loja",
"input_schema": { "type": "object", "properties": { "item": { "type": "string" } } },
"side_effects": true,
"endpoint": { "kind": "http", "url": "https://loja.example/api/pedido", "credential": "token" }
}
]
}Para que o app busque as atualizações, instale pelo endereço do plugin.json (HTTPS): o botão Atualizar baixa de novo e instala quando a versão (1.2.3) é maior, mantendo credenciais, estado e permissões. Uma versão mais antiga que a instalada é recusada. Use "kind": "mcp" para chamar uma ferramenta de um servidor MCP (remote_name se o nome lá for outro). Três marcas protegem os dados:
"internal_only": true: a ferramenta nunca roda em resposta a uma mensagem de cliente, só em rotinas e pedidos internos."contact_scoped": true: quando um cliente escreve, o app põe o contato da conversa emcontato(telefone,nome), e o modelo não consegue pedir dados de outra pessoa."sensitive": true(e"side_effects": true): a ferramenta espera a aprovação de uma pessoa, conforme a política do agente.
Um plugin também pode sugerir rotinas ("schedules": [{"name", "cron", "prompt"}]), que o administrador cria em Plugins → Criar rotina escolhendo os agentes. As ferramentas só valem para agentes que rodam no motor (runtime OpenCode). O app traz o plugin Mensagens, cuja ferramenta mensagens.enviar_whatsapp deixa o agente escrever primeiro para um contato, sempre com aprovação na política padrão. O plugin de exemplo completo é o Contador.
Arquitetura e qualidade
Arquitetura hexagonal: domínio puro, casos de uso com portas injetadas, adaptadores de entrada HTTP/MCP e de saída SQLite/WhatsApp. Consulte ARCHITECTURE.md.
TypeScript estrito na interface, ESLint, regras React Hooks e Prettier.
Limite físico de 300 linhas por arquivo de código, incluindo CSS e Rust.
Verificação automática de direção das dependências e consistência de versão.
Testes de autorização, isolamento, persistência, SDK MCP e interface com Playwright.
Rustfmt, Clippy com warnings tratados como erros e auditoria npm.
Dependabot semanal para npm, Cargo e Actions.
Versão e release
Formato: YY.MM.incremental. Primeira versão: 26.10.1. O incremental reinicia em 1 a cada mês. Para compatibilidade com SemVer/Tauri, meses de 1 a 9 não têm zero à esquerda nos metadados, por exemplo 27.1.1.
npm run format
cargo check --manifest-path src-tauri/Cargo.toml
git add .
git commit -m "feat: descreva a alteração"
git push origin SUA_BRANCH
gh pr create --base mainTrabalhe em uma branch e abra PR para main. A proteção da branch exige os checks quality e windows aprovados e a branch atualizada antes do merge, inclusive para administradores. Não envie diretamente para main nem crie tags para publicar.
O CI roda somente no PR. Depois do merge, Windows release consulta os resultados já aprovados do PR e executa apenas o bump automático e o build/publicação do instalador assinado, sem repetir testes, auditoria ou Clippy. A versão usa o mês UTC e o próximo incremental acima das versões existentes. O bump sincroniza os metadados apenas na cópia usada para compilar; não cria commits diretos na main protegida. A tag aponta para o commit mergeado. Antes de publicar, o fluxo confirma novamente que esse ainda é o commit atual e que o CI do PR segue aprovado. Tags avulsas, pushes sem PR e execução manual não publicam. Não há credenciais Cloudflare ou WhatsApp no CI.
O CI usa o secret TAURI_SIGNING_PRIVATE_KEY para assinar o instalador e publica .exe.sig e latest.json. A chave privada deve ser preservada fora do repositório; sua perda impede atualizar instalações que confiam na chave pública atual. O feed aponta para os artefatos da release, publicados juntos após todos os checks.
Limites desta versão
A integração usa whatsapp-rust, um cliente não oficial do WhatsApp Web, sem afiliação à Meta. Pode exigir novo pareamento após mudanças do serviço. Instalações que usavam a versão anterior (Baileys) precisam ler o QR de novo; conversas, contatos e histórico já salvos são mantidos.
O histórico depende do conteúdo disponibilizado pelo WhatsApp na sincronização; não há garantia de recuperar todo o histórico antigo.
Anexos são baixados sob demanda pelo MCP, até 10 MiB; disponibilidade depende do WhatsApp e da sincronização.
Envio MCP de texto; sem envio de mídia.
O ícone é próprio, inspirado em um balão verde de conversa.
Referências
Licença MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
Hosted WhatsApp MCP server: send and read messages from your own linked number. OAuth sign-in.
Hosted WhatsApp MCP server: read, search and reply to your own WhatsApp chats from your AI.
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
Related MCP Servers
- AlicenseBqualityCmaintenanceAn MCP server that enables interaction with WhatsApp using the Baileys library and Streamable HTTP transport. It supports managing contacts, chats, and messages, while providing a web admin UI for QR code authentication and media handling.4285MIT
- FlicenseBqualityDmaintenanceRead-only MCP server for WhatsApp Web allowing listing chats and reading recent messages, without sending or mutating WhatsApp state.3-
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to send and read WhatsApp messages, download media, and inspect chats, groups, and session status through the waxum REST API gateway over stdio or Streamable HTTP.MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to read WhatsApp chats and send, reply, react to, and schedule messages on the WhatsApp Desktop already logged in locally. All traffic stays on 127.0.0.1, with human-like pacing and verified delivery rather than cloud APIs or QR logins.2MIT