Apidog

Plataforma Colaborativa All-in-one para Desenvolvimento de API

Design de API

Documentação de API

Depuração de API

Mock de API

Testes Automatizados de API

Como Usar o Servidor MCP do WhatsApp

@apidog

@apidog

Updated on abril 1, 2025

Imagine poder automatizar suas interações no WhatsApp, analisar conversas e até integrar assistentes de IA diretamente em seu fluxo de mensagens. Parece algo saído de um filme de ficção científica, certo? Bem, está mais próximo do que você imagina! Bem-vindo ao WhatsApp MCP, onde o Protocolo de Contexto de Modelo (MCP) conecta o WhatsApp a ferramentas de IA como Claude e Cursor. Isso abre um mundo de possibilidades para automatizar suas mensagens e integrar IA em suas comunicações diárias.

imagem do whatsapp

Este tutorial irá guiá-lo pela configuração e domínio desta poderosa integração. Vamos fazê-lo passo a passo, então não se preocupe se você é novo nesse tipo de coisa. Vamos lá!

💡
Integrar o Servidor MCP da Apidog em seu IDE com IA melhora suas capacidades de codificação ao permitir acesso direto às especificações da API dos projetos da Apidog. Esta integração permite que seu assistente de IA gere ou modifique código com base em suas especificações de API, busque por documentação da API, crie modelos de dados e DTOs que se alinham ao seu design de API e adicione comentários e documentação relevantes.
apidog mcp

Ao atuar como uma ponte entre seus projetos da Apidog e o Cursor, o Servidor MCP da Apidog garante que seu assistente de IA tenha acesso aos designs de API mais recentes, complementando o recurso Memory Bank ao fornecer informações estruturadas da API que o Cursor pode consultar durante o desenvolvimento. Para saber mais sobre o Servidor MCP da Apidog, consulte a documentação oficial ou visite a página do NPM. Além disso, considere explorar a Apidog—uma alternativa integrada, poderosa e econômica ao Postman.

botão

Pré-requisitos

Antes de começarmos, vamos garantir que você tenha tudo o que precisa. Isso pode parecer muito, mas não fique intimidad@! Basta seguir junto e você estará pronto para começar.

1. Uma conta no WhatsApp: Obviamente, você precisará de uma conta no WhatsApp para usar isso.

2. Conta no GitHub: Você precisará de uma conta no GitHub para clonar o repositório. Se você não tiver uma, crie uma conta gratuita em GitHub.

3. Aplicativo de Desktop Claude: Para seguir este tutorial, você precisará ter configurado e instalado o Aplicativo de Desktop Claude.

4. Conhecimento Básico em Linha de Comando: Você deve estar confortável em abrir um terminal (ou linha de comando) e executar comandos básicos.

5. Git: O Git é utilizado para clonar o repositório. Certifique-se de que você tem o Git instalado em seu sistema. Você pode baixá-lo em Git-SCM.

6. Go: Usaremos Go para executar um arquivo. Instruções para instalação podem ser encontradas em Go Downloads.

7. Python: Esta ferramenta precisará do Python. Um link para download pode ser encontrado em Python Downloads.

8. Gerenciador de pacotes uv: Para instalar o gerenciador de pacotes uv, siga as instruções fornecidas no guia de instalação que virá a seguir.

Parte 1: Entendendo o WhatsApp MCP

O que exatamente é o WhatsApp MCP?

WhatsApp MCP é um projeto de código aberto que atua como uma ponte entre o WhatsApp Web e modelos de IA usando o Protocolo de Contexto de Modelo (MCP). Em termos simples, permite que modelos de IA como Claude e Cursor "conversem" com o WhatsApp e realizem ações programaticamente.

Pense assim: WhatsApp é uma linguagem, MCP é o tradutor e modelos de IA são os falantes. O WhatsApp MCP permite que a IA "fale" WhatsApp e interaja com suas mensagens de uma maneira totalmente nova.

Componentes Chave do WhatsApp MCP

Servidor da API do WhatsApp: Este componente conecta-se ao WhatsApp Web e fornece uma maneira para modelos de IA interagirem com o WhatsApp através de um conjunto de comandos (endpoints REST). É a "boca" da IA.

Servidor MCP: Este componente implementa o Protocolo de Contexto de Modelo, permitindo a comunicação e coordenação entre os modelos de IA e o Servidor da API do WhatsApp. É o "cérebro" que diz à "boca" o que dizer e fazer.

Parte 2: Configurando o WhatsApp MCP

Ok, agora vamos para a parte divertida! Vamos colocar o Servidor WhatsApp MCP em funcionamento.

Passo 1: Clonar o Repositório

Primeiro, precisamos obter o código do WhatsApp MCP. Abra seu terminal e execute o seguinte comando:

git clone https://github.com/lharries/whatsapp-mcp
cd whatsapp-mcp

Isso fará o download do código do GitHub e colocá-lo em uma pasta chamada whatsapp-mcp em seu computador. O comando cd whatsapp-mcp então o levará para essa pasta.

Passo 2: Baixar e Instalar o Go

Certifique-se de que você tenha o Go instalado em seu computador. Por favor, vá para Go Downloads para baixar e instalar o Go.

imagem de instalação do golang

Passo 3: Baixar e Instalar o Python

Certifique-se de que você tenha o Python instalado em seu computador. Por favor, vá para Python Downloads para baixar e instalar o Python.

imagem de instalação do python

Passo 4: Instalar o Gerenciador de Pacotes uv

Certifique-se de que você tenha o uv instalado em seu computador. Para instalá-lo, você pode executar o seguinte comando no terminal.

pip install uv

Passo 5: Executar a Ponte do WhatsApp

Vamos iniciar a parte "whatsapp-bridge", este é o arquivo Go.

cd whatsapp-bridge
go run main.go

Se for bem-sucedido, informará o seguinte:

2025/03/30 13:55:15 Servidor ouvindo na porta 8001

Passo 6: Integrar com o Claude Desktop

Aqui é onde conectamos o WhatsApp MCP ao Claude.

  1. Abra o Claude Desktop e vá para Configurações.
  2. Selecione Desenvolvedor e clique no botão de configurações para abrir o arquivo claude_desktop_config.json.

Adicione a seguinte configuração ao arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH}}/.local/bin/uv", // Execute `which uv` e coloque a saída aqui
      "args": [
        "--directory",
        "{{PATH}}/whatsapp-mcp/whatsapp-mcp-server", // cd no repositório, execute `pwd` e adicione a saída aqui + "/whatsapp-mcp-server"
        "run",
        "main.py"
      ]
    }
  }
}

Notas Importantes:

  1. comando: Você precisa substituir "{{PATH}}/.local/bin/uv" pelo caminho real para o executável uv em seu sistema. Para encontrar esse caminho, execute o comando which uv em seu terminal e cole a saída aqui.
  2. args: Você precisa substituir "{{PATH}}/whatsapp-mcp/whatsapp-mcp-server" pelo caminho completo para o diretório whatsapp-mcp-server em seu sistema. Para encontrar esse caminho:
  • cd no diretório whatsapp-mcp que você clonou anteriormente.
  • Execute o comando pwd em seu terminal. Isso imprimirá o caminho completo para esse diretório.
  • Adicione /whatsapp-mcp-server ao final desse caminho.
  • Cole o resultado na seção "args".

Passo 7: Reinicie o Cursor

Feche completamente o Cursor. Certifique-se de fechá-lo pelo gerenciador de tarefas (ou monitor de atividades no Mac) para garantir que ele esteja totalmente encerrado. Então, reinicie o Cursor.

Parte 3: Usando o WhatsApp MCP

Agora que você tem tudo configurado corretamente, vamos explorar algumas maneiras de usar o WhatsApp MCP.

Caso de Uso 1: Envio de Mensagens Automatizado

Você pode configurar o Claude (ou outros modelos de IA) para enviar mensagens em seu nome. Por exemplo:

/ask "Envie uma mensagem para John Doe no WhatsApp: 'Olá, como você está?'"
resultado do exemplo 1

Nos bastidores:

Claude aciona o servidor WhatsApp MCP.

O servidor usa a API do WhatsApp para enviar a mensagem.

Caso de Uso 2: Análise de Conversas

Você pode usar Claude para analisar suas conversas no WhatsApp. Por exemplo:

/ask "Analise a última conversa com Jane no WhatsApp"

Claude processará a conversa usando modelos de IA e retornará insights, como análise de sentimento, extração de tópicos e temas principais.

resultado do exemplo 2

Parte 4: Recursos Avançados e Segurança

Gerenciamento de Sessões do WhatsApp

O WhatsApp MCP permite gerenciar várias sessões do WhatsApp programaticamente. Isso inclui criar e gerenciar grupos, enviar arquivos e recuperar histórico de chats. Esses são casos de uso mais avançados que exigem uma exploração mais aprofundada da API do WhatsApp e da documentação do MCP.

Melhores Práticas de Segurança

A segurança é primordial ao lidar com dados pessoais de mensagens. Aqui estão algumas melhores práticas cruciais:

  • Consentimento do Usuário: Sempre obtenha consentimento explícito dos usuários antes de acessar seus dados do WhatsApp. A transparência é fundamental.
  • Privacidade de Dados: Proteja os dados dos usuários com controles de acesso apropriados e criptografia. Siga as regulamentações de privacidade de dados como GDPR e CCPA.
  • Segurança das Ferramentas: Trate as ferramentas com cautela, pois elas representam a execução de código arbitrário. Compreenda os riscos envolvidos antes de executar qualquer código.

Parte 5: Solução de Problemas e Perguntas Frequentes

Esta seção inclui problemas comuns e suas soluções:

  1. "Não estou recebendo mensagens." (Verifique as chaves da API, o status do servidor, a conectividade da rede)
  2. "Claude não está respondendo aos meus comandos." (Verifique a configuração do MCP, verifique as configurações do Claude)
  3. "Minha conta do WhatsApp está bloqueada." (Evite enviar spam ou violar os termos de serviço do WhatsApp)

Considerações Finais

Agora você configurou e testou com sucesso o WhatsApp MCP, abrindo a porta para um mundo de mensagens automatizadas e aprimoradas por IA. Desde automatizar tarefas mundanas até obter insights valiosos de suas conversas, o WhatsApp MCP capacita você a aproveitar o poder da IA em suas comunicações diárias. Isso é apenas o começo! Experimente diferentes modelos de IA, explore as capacidades da API do WhatsApp e crie fluxos de trabalho personalizados para realmente personalizar sua experiência de mensagens. Abrace o futuro da comunicação com o WhatsApp MCP!

imagem do Apidog Ui
botão