Servidor MCP

Coloque um agente de IA num WhatsApp de verdade.

O PlugueZap expõe o seu WhatsApp como um servidor Model Context Protocol (MCP). Qualquer agente que fala o protocolo, Claude, ChatGPT, Cursor ou o seu próprio, conecta e passa a ler, responder e executar ações reais.

mcp.json

{
  "mcpServers": {
    "pluguezap": {
      "type": "http",
      "url": "https://pluguezap.com.br/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE"
      }
    }
  }
}

Como funciona

Três saltos do prompt ao WhatsApp.

Cliente MCP

Seu agente

Claude, ChatGPT, Cursor ou um agente próprio, qualquer cliente que fale MCP, sem SDK.

Servidor PlugueZap

Tradução do protocolo

Recebe as chamadas JSON-RPC, valida sua chave e traduz para ações na sessão do WhatsApp.

Número real

A ação acontece no número conectado, mensagem enviada, grupo criado, reação aplicada.

Ferramentas

Mais de 40 ferramentas, num endpoint só.

Tudo que a sua equipe faz no painel, o seu agente faz por MCP, do envio simples à administração de grupos.

Mensagens

enviar_mensagemenviar_midiaenviar_figurinhaenviar_localizacaoenviar_contatoenviar_enquetelistar_conversasler_conversa

Ações sobre mensagens

responder_mensagemreagir_mensagemeditar_mensagemapagar_mensagemmarcar_como_lidadefinir_presenca

Contatos & perfil

verificar_numerofoto_perfilinfo_contatobloquear_contatoatualizar_perfil

Grupos

criar_grupolistar_gruposinfo_grupolink_grupoinfo_convite_grupoentrar_gruposair_grupo

Administração de grupos

gerenciar_participantesnome_grupodescricao_grupofoto_grupoconfig_gruporevogar_link_grupomensagens_temporarias_grupo

Conversas, conta & conexão

arquivar_conversafixar_conversasilenciar_conversamarcar_nao_lidaapagar_conversastatus_whatsappparear_contadesconectarlogout

Conectar

Conectado em três passos.

Pegue sua chave

No painel, abra a instância → Dados de conexão e copie a chave de API daquela linha.

Adicione o servidor

No Claude Code, um comando. Em outros clientes, cole o mcp.json acima.

claude mcp add --transport http pluguezap \
https://pluguezap.com.br/mcp \
--header "Authorization: Bearer SUA_CHAVE"

Mande a primeira mensagem

O agente já enxerga as ferramentas e opera o número.

> enviar_mensagem({"para": "5548999990000", "texto": "Olá, via MCP!"})

Especificações

Detalhes técnicos.

TransporteMCP via HTTP (JSON-RPC). Endpoint único: https://pluguezap.com.br/mcp

AutenticaçãoChave da instância em Authorization: Bearer, em x-api-key, ou embutida na URL (/mcp/<chave>) para conectores que só aceitam URL.

EscopoCada chave pertence a uma instância, o agente opera exatamente aquele número.

ClientesQualquer cliente MCP: Claude Code, Claude Desktop, Cursor, ChatGPT ou agente próprio.

Rodar localPrefere rodar o MCP na sua máquina? Use o servidor local (stdio) com a variável WMCP_API_KEY, reaproveitando as mesmas ferramentas.

Dúvidas

Perguntas comuns.

O PlugueZap é afiliado ao WhatsApp ou à Meta?

Não. É um serviço independente que conecta direto com o WhatsApp, fora da API oficial da Meta. Isso fica fora dos termos de uso do WhatsApp, que pode restringir um número que considere mal utilizado.

É um WhatsApp de verdade ou sandbox?

Um número real, pareado como no WhatsApp Web. As mensagens saem e chegam de verdade.

O agente precisa ficar consultando por novas mensagens?

Ele pode ler as conversas quando quiser pelas ferramentas de leitura. O recebimento em tempo real aparece no painel, e a API/MCP permite buscar o histórico a qualquer momento.

Uma conta enxerga as mensagens de outra?

Não. Cada instância é isolada, e cada chave opera apenas o seu próprio número.

E se o WhatsApp restringir a linha?

Como qualquer conexão fora da API oficial, há esse risco. Use proxy por instância e os guardrails de envio, comece com uma linha que você possa dispensar e mantenha o tráfego pessoal.

Dê um WhatsApp ao seu agente.

Crie a conta, conecte uma linha e pegue a chave de API para plugar a sua IA.

Criar conta Ver todos os recursos