WhatsApp by GREEN-API

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

Connexion au serveur MCP GREEN-API

MCP (Model Context Protocol) est une norme ouverte qui permet aux assistants IA de se connecter à des outils et à des sources de données externes. GREEN-API fournit son propre serveur MCP, qui permet aux assistants IA d’interagir directement avec l’API WhatsApp : envoyer des messages, gérer des groupes, accéder à l’historique des discussions et bien plus encore.

Ces instructions vous aideront à connecter le serveur MCP à Claude Desktop à l’aide du service WhatsApp GREEN-API.

Vous pouvez connecter MCP à l’aide du protocole /mcp ou /sse. Le protocole /mcp est recommandé pour la connexion.

Table des matières

Prérequis minimaux

1. Compte GREEN-API : inscrivez-vous sur le site en choisissant l’une des offres tarifaires.
2. Une instance autorisée dans votre console GREEN-API.
3. Claude : créez un compte sur la plateforme.
4. Claude Desktop installé : téléchargez-le depuis le site officiel.

Présentation

Cette intégration vous permet de :

1. Recevoir des messages WhatsApp
2. Envoyer des messages WhatsApp à vos clients
3. Utiliser les méthodes de l’API WhatsApp de GREEN-API

Configuration de la connexion étape par étape

Cette méthode de connexion repose sur un serveur GREEN-API configuré qui utilise l’authentification OAuth basée sur le numéro de l’instance. Elle ne nécessite pas l’installation de packages supplémentaires sur la machine locale : le serveur est déjà déployé et accessible à l’adresse mcp.green-api.com.

Étape 1 : Ajouter un serveur MCP personnalisé à Claude Desktop

1. Lancez l’application Claude Desktop
2. Ouvrez les paramètres : Personnaliser → Connecteurs
3. Cliquez sur l’icône + et sélectionnez Ajouter un connecteur

• Nom du serveur : GREEN-API (ou tout autre nom descriptif, tel que WhatsApp by GREEN-API)
• URL du serveur : https://mcp.green-api.com/mcp
• Paramètres avancés : Numéro d’instance (Vous devez saisir au moins un caractère, mais vous devrez saisir manuellement le nom de l’instance à chaque fois pour lancer l’autorisation)
• Secret client OAuth : (Nous vous recommandons de laisser ce champ vide lors de la configuration de la connexion ; vous pourrez y saisir le jeton de votre instance ultérieurement, pendant l’autorisation)

Étape 2 : Connecter un compte au serveur MCP

Dans l’onglet Connecteurs, sélectionnez l’onglet GREEN-API et cliquez sur le bouton Connect.

Si vous n’avez pas indiqué le API Token, une fenêtre d’autorisation avec une invite s’ouvrira dans votre navigateur.

Collez le Instance ID et le API Token depuis votre console GREEN-API

[!note] Paramètres de restriction avancés Une fois la connexion établie, vous pouvez autoriser ou interdire à votre agent d’exécuter certaines méthodes potentiellement dangereuses.

Étape 3 : Tester la connexion

Créez une nouvelle discussion avec votre agent IA. Dans le champ de saisie, demandez une phrase telle que My WhatsApp instance state.

L’IA peut vous demander des autorisations supplémentaires, puis renvoyer une phrase telle que WhatsApp get state. Your instance is in the ✅ authorized state — authorized and functioning properly!.

Félicitations, votre serveur MCP fonctionne correctement.

Envoyer un message

Grâce au serveur MCP, vous pouvez facilement envoyer un message à un numéro WhatsApp. Pour ce faire, saisissez simplement une phrase comme celle-ci :

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