WhatsApp by GREEN-API

oficial

Servidor MCP oficial da GREEN-API. Envie e receba mensagens do WhatsApp e gerencie conversas, grupos e contatos.

Ver em green-api.com

O que você pode fazer com WhatsApp By GREEN API MCP?

  • Verificar o estado da instância — Peça ao assistente o estado da sua instância do WhatsApp para confirmar se ela está autorizada e funcionando.
  • Enviar mensagens pelo WhatsApp — Peça ao assistente para enviar uma mensagem para um número específico do WhatsApp, por exemplo: "Envie 'Olá, mundo' para +71234567891".
  • Receber mensagens pelo WhatsApp — Use a integração para receber mensagens do WhatsApp enviadas pelos seus clientes.
  • Chamar métodos do GREEN-API — Peça ao assistente para usar a API do WhatsApp por meio dos métodos do GREEN-API para operações compatíveis.
  • Restringir métodos inseguros — Após a conexão, permita ou proíba o agente de executar determinados métodos potencialmente inseguros.

Servidor MCP hospedado

npx add-mcp 'https://mcp.green-api.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Conectando o servidor MCP do GREEN-API

MCP (Model Context Protocol) — um padrão aberto que permite que assistentes de IA se conectem a ferramentas e fontes de dados externas. GREEN-API oferece seu próprio servidor MCP, permitindo que assistentes de IA interajam diretamente com a API do WhatsApp — enviando mensagens, gerenciando grupos, acessando o histórico de conversas e muito mais.

Estas instruções ajudarão você a conectar o servidor MCP ao Claude Desktop usando o serviço WhatsApp do GREEN-API.

Você pode conectar o MCP usando o protocolo /mcp ou /sse. O protocolo /mcp é o preferido para a conexão.

Índice

Requisitos mínimos

  1. Conta do GREEN-API – cadastre-se no site em um dos planos de preços.
  2. Uma instância autorizada no seu console do GREEN-API.
  3. Claude – crie uma conta na plataforma.
  4. Claude Desktop instalado – baixe-o no site oficial.

Visão geral

Esta integração permite que você:

  1. Receba mensagens do WhatsApp
  2. Envie mensagens do WhatsApp para seus clientes
  3. Use os métodos da API do WhatsApp do GREEN-API

Configuração da conexão passo a passo

Este método de conexão é implementado por meio de um servidor GREEN-API configurado que usa autenticação OAuth baseada no número da instância. Este método não requer a instalação de pacotes adicionais na máquina local — o servidor já está implantado e acessível em mcp.green-api.com.

Etapa 1: Adicionar um servidor MCP personalizado ao Claude Desktop

  1. Inicie o aplicativo Claude Desktop
  2. Abra as configurações: Personalizar → Conectores
  3. Clique no ícone + e selecione Adicionar conector

add

  • Nome do servidor: GREEN-API (ou qualquer outro nome descritivo, como GREEN-API MCP WhatsApp Server)
  • URL do servidor: https://mcp.green-api.com/mcp
  • Configurações avançadas: Número da instância (Você deve inserir pelo menos um caractere, mas precisará inserir manualmente o nome da instância sempre que iniciar a autorização)
  • Segredo do cliente OAuth: (Recomendamos deixar este campo em branco ao configurar a conexão; você poderá inserir o token da instância nele posteriormente, durante a autorização)

Etapa 2: Conectar uma conta ao servidor MCP

Na guia Conectores, selecione a guia GREEN-API e clique no botão Connect.

Se você não tiver especificado o API Token, uma janela de autorização com uma solicitação será aberta no navegador.

login

Cole o Instance ID e o API Token do seu console do GREEN-API

sucess

[!note] Configurações avançadas de restrição Após uma conexão bem-sucedida, você pode permitir ou proibir que seu agente execute determinados métodos potencialmente inseguros.

restricts

Etapa 3: Testar a conexão

Inicie uma nova conversa com seu agente de IA. No campo de consulta, digite uma frase como My WhatsApp instance state.

A IA poderá perguntar sobre permissões adicionais e, em seguida, retornar uma frase como WhatsApp get state. Your instance is in the ✅ authorized state — authorized and functioning properly!.

Parabéns, seu servidor MCP está funcionando corretamente.

Enviar uma mensagem

Com o servidor MCP, você pode enviar facilmente uma mensagem para um número do WhatsApp. Para isso, basta digitar uma frase como esta:

Send the phrase "Hello world" to my friend! And tell him I set up the GREEN-API MCP server in less than 10 minutes.
My friend's WhatsApp number is +71234567891