Connecter WhatsApp Business à Claude ou Cursor avec le MCP

Le Model Context Protocol (MCP) permet à un assistant IA comme Claude ou Cursor d'accéder à des outils et des données externes de manière standardisée. Appliqué à WhatsApp Business, il permet d'interroger vos statistiques de campagnes, de consulter vos contacts ou de préparer un template directement depuis votre assistant habituel, sans passer par une interface web. Cet article explique ce qu'est le MCP, comment connecter un compte Whakup à Claude ou Cursor, et quelles précautions prendre.

Qu'est-ce que le Model Context Protocol ?

Le MCP est un protocole ouvert, publié par Anthropic fin 2024, qui définit comment une application d'IA (le client) communique avec un service externe (le serveur). Le serveur expose des outils, décrits avec leur nom, leur rôle et leurs paramètres. L'assistant lit ces descriptions et décide d'appeler un outil lorsque votre demande le justifie.

Concrètement, si vous demandez à Claude « Combien de contacts compte mon groupe Prospects ? », l'assistant appelle l'outil adapté du serveur MCP, reçoit la réponse et la reformule pour vous.

Le MCP présente trois avantages par rapport à une intégration sur mesure :

Un seul standard pour plusieurs assistants : Claude Desktop, Claude Code, Cursor et d'autres clients compatibles.
Des outils décrits que l'assistant sait utiliser sans code supplémentaire de votre part.
Une authentification classique, par clé API dans un en-tête HTTP.

Ce que permet le serveur MCP de Whakup

Whakup expose un serveur MCP à l'adresse https://api.whakup.com/v1/mcp. Il propose 15 outils : 11 en lecture et 4 en écriture.

Les outils en lecture

Ils permettent à l'assistant de consulter :

vos contacts et vos groupes ;
vos campagnes et leurs statistiques ;
vos templates ;
vos conversations ;
vos automatisations.

Les outils en écriture

Ils permettent de préparer le travail :

créer ou mettre à jour des contacts ;
gérer les groupes ;
créer des brouillons de templates ;
créer des brouillons de campagnes.

Ce que le serveur ne fait pas

Le serveur MCP de Whakup n'envoie jamais de message. Il prépare des brouillons, mais le lancement d'une campagne reste une action que vous effectuez depuis Whakup. Ce choix limite les risques liés à un assistant qui interpréterait mal une consigne.

Prérequis

Avant de commencer, vérifiez les points suivants :

Un compte Whakup avec accès API. Le MCP utilise la même clé que l'API, réservée à l'offre Business. Les détails sont sur la page tarifs.
Une clé API. Elle se crée dans le tableau de bord (Réglages, puis Clés API). Elle commence par wk_ et n'est affichée qu'une seule fois : conservez-la dans un gestionnaire de secrets.
Un client compatible MCP : Claude Code, Claude Desktop ou Cursor, par exemple.

Configurer Claude Code

Dans un terminal, une seule commande suffit :

claude mcp add --transport http whakup https://api.whakup.com/v1/mcp \
  --header "Authorization: Bearer wk_votre_cle"

Le serveur est ensuite disponible dans vos sessions Claude Code. Vous pouvez vérifier qu'il est bien chargé avec la commande de liste des serveurs MCP de Claude Code.

Configurer Cursor

Dans Cursor, ajoutez le serveur dans le fichier .cursor/mcp.json de votre projet :

{
  "mcpServers": {
    "whakup": {
      "url": "https://api.whakup.com/v1/mcp",
      "headers": { "Authorization": "Bearer wk_votre_cle" }
    }
  }
}

Si ce fichier est versionné dans un dépôt Git, ne mettez pas la clé en clair. Utilisez plutôt une configuration locale non versionnée.

Configurer Claude Desktop

Claude Desktop passe par un petit relais (mcp-remote) qui nécessite Node.js. Dans le fichier claude_desktop_config.json :

{
  "mcpServers": {
    "whakup": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.whakup.com/v1/mcp", "--header", "Authorization:${WHAKUP_AUTH}"],
      "env": { "WHAKUP_AUTH": "Bearer wk_votre_cle" }
    }
  }
}

Redémarrez Claude Desktop pour que le serveur soit pris en compte. La configuration prête à copier, avec votre clé, est aussi disponible dans le tableau de bord Whakup (Réglages, Clés API, Assistant IA).

La documentation complète se trouve sur la page développeurs.

Exemples d'usages

Une fois le serveur connecté, vous dialoguez avec votre assistant comme d'habitude. Quelques exemples de demandes :

« Résume les résultats de mes trois dernières campagnes et indique les principales causes d'échec. »
« Liste les conversations qui attendent une réponse. »
« Crée un brouillon de template utilitaire pour confirmer un rendez-vous, avec une variable pour la date. »
« Ajoute ces cinq contacts au groupe Salon 2026. »
« Prépare un brouillon de campagne avec le template promo_rentree pour le groupe Clients fidèles. »

Pour un développeur, l'intérêt est de pouvoir travailler sur une intégration (un site, un back-office) tout en interrogeant les données réelles du compte depuis Cursor, par exemple pour vérifier le nom exact d'un groupe ou la structure d'un template.

Sécurité : les bonnes pratiques

Connecter un assistant IA à un compte professionnel demande quelques précautions.

Traiter la clé comme un mot de passe

La clé API donne accès à vos contacts et à vos données de campagnes. Ne la partagez pas, ne la publiez pas dans un dépôt public et ne l'exposez jamais côté navigateur. Whakup ne stocke qu'une empreinte (hash SHA-256) de la clé, ce qui explique qu'elle ne soit affichée qu'une fois.

Révoquer en cas de doute

Si une clé a pu fuiter, révoquez-la immédiatement depuis le tableau de bord et créez-en une nouvelle. La révocation est immédiate.

Relire les actions d'écriture

Les clients MCP demandent généralement une confirmation avant d'exécuter un outil. Gardez cette confirmation activée pour les outils d'écriture : l'assistant peut se tromper de groupe ou de contact. Rappelez-vous aussi que l'ajout de contacts à un groupe peut déclencher une automatisation « Ajout à un groupe ».

Respecter les limites de débit

Le serveur MCP applique les mêmes limites que l'API (1 200 requêtes par minute et par clé). Un assistant qui boucle sur de nombreux appels peut les atteindre. En cas de réponse 429, l'en-tête Retry-After indique combien de secondes attendre.

MCP ou assistant intégré : que choisir ?

Whakup propose aussi un assistant IA intégré à l'application. Les deux approches sont complémentaires.

Critère	Assistant intégré	MCP
Où l'utiliser	Dans l'interface Whakup	Dans Claude, Cursor ou un autre client
Offre requise	À partir de Basique	Business (accès API)
Aperçu des templates	Bulle WhatsApp et vérification des règles Meta	Texte dans l'assistant
Profil d'entreprise (ton, langue)	Oui	Non
Combinaison avec d'autres outils	Non	Oui, avec vos autres serveurs MCP

L'assistant intégré convient aux équipes marketing. Le MCP s'adresse plutôt aux développeurs, aux agences et aux utilisateurs avancés qui travaillent déjà dans Claude ou Cursor et veulent y croiser plusieurs sources de données.

FAQ

Le MCP permet-il d'envoyer des messages WhatsApp depuis Claude ?

Non. Le serveur MCP de Whakup n'envoie jamais de message. Il permet de consulter vos données et de préparer des contacts, des groupes et des brouillons de templates et de campagnes. L'envoi se fait depuis Whakup, ou via l'endpoint d'envoi de l'API si vous développez une intégration.

Quelle offre faut-il pour utiliser le MCP ?

Le MCP utilise une clé API, réservée à l'offre Business. L'assistant IA intégré à l'application est, lui, disponible à partir de l'offre Essentiel.

Le MCP fonctionne-t-il avec d'autres assistants que Claude et Cursor ?

Oui, avec tout client compatible MCP qui sait se connecter à un serveur distant en HTTP avec un en-tête d'authentification. Le transport utilisé est Streamable HTTP.

Mes données sont-elles visibles par le fournisseur de l'assistant ?

Les réponses des outils sont transmises au modèle utilisé par votre client MCP, selon les conditions de ce fournisseur. Vérifiez la politique de confidentialité de votre client et limitez les demandes aux données nécessaires.

Démarrer

Pour connecter votre compte WhatsApp Business à Claude ou Cursor, commencez par créer un compte Whakup. L'essai gratuit dure 15 jours, sans carte bancaire.