WhatsApp by GREEN-API

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

Conexión del servidor MCP de GREEN-API

MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas y fuentes de datos externas. GREEN-API ofrece su propio servidor MCP, que permite a los asistentes de IA interactuar directamente con la API de WhatsApp: enviar mensajes, administrar grupos, acceder al historial de chats y mucho más.

Estas instrucciones te ayudarán a conectar el servidor MCP a Claude Desktop mediante el servicio de WhatsApp de GREEN-API.

Puedes conectar MCP mediante el protocolo /mcp o /sse. Se recomienda el protocolo /mcp para la conexión.

Tabla de contenidos

Requisitos mínimos

1. Cuenta de GREEN-API: regístrate en el sitio con uno de los planes de precios.
2. Una instancia autorizada en tu consola de GREEN-API.
3. Claude: crea una cuenta en la plataforma.
4. Claude Desktop instalado: descárgalo del sitio web oficial.

Descripción general

Esta integración te permite:

1. Recibir mensajes de WhatsApp
2. Enviar mensajes de WhatsApp a tus clientes
3. Usar los métodos de WhatsApp API by GREEN-API

Configuración de la conexión paso a paso

Este método de conexión se implementa mediante un servidor de GREEN-API configurado que utiliza autenticación OAuth basada en el número de instancia. Este método no requiere instalar paquetes adicionales en el equipo local: el servidor ya está implementado y disponible en mcp.green-api.com.

Paso 1: Añadir un servidor MCP personalizado a Claude Desktop

1. Inicia la aplicación Claude Desktop
2. Abre Settings: Customize → Connectors
3. Haz clic en el icono + y selecciona Add connector

• Server Name: GREEN-API (o cualquier otro nombre descriptivo, como GREEN-API MCP WhatsApp Server)
• Server URL: https://mcp.green-api.com/mcp
• Advanced Settings: Instance Number (Debes introducir al menos un carácter, pero tendrás que introducir manualmente el nombre de la instancia cada vez que inicies la autorización)
• OAuth Client Secret: (Recomendamos dejar este campo en blanco al configurar la conexión; más adelante puedes introducir el token de tu instancia durante la autorización)

Paso 2: Conectar una cuenta al servidor MCP

En la pestaña Connectors, selecciona la pestaña GREEN-API y haz clic en el botón Connect.

Si no has especificado API Token, se abrirá una ventana de autorización con un mensaje en el navegador.

Pega Instance ID y API Token desde tu consola de GREEN-API

[!note] Configuración avanzada de restricciones Después de conectarte correctamente, puedes permitir o impedir que tu agente ejecute determinados métodos potencialmente inseguros.

Paso 3: Probar la conexión

Inicia un chat nuevo con tu agente de IA. En el campo de consulta, escribe una frase como My WhatsApp instance state.

Es posible que la IA te solicite permisos adicionales y luego responda con una frase como WhatsApp get state. Your instance is in the ✅ authorized state — authorized and functioning properly!.

Enhorabuena, el servidor MCP funciona correctamente.

Enviar un mensaje

Con el servidor MCP, puedes enviar fácilmente un mensaje a un número de WhatsApp. Para ello, solo tienes que escribir una 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