Intégrations
Serveur MCP pour assistants IA
Connecte Claude, Cursor, VS Code, ChatGPT, Gemini CLI ou Codex CLI à ton espace WhatSetter avec 66 outils MCP, une seule clé API et zéro code.
Le MCP (Model Context Protocol) est le standard ouvert qui permet à un assistant IA d’utiliser un logiciel à travers des outils. Le serveur MCP WhatSetter expose 66 outils, un par endpoint de l’API, pour que ton assistant lise tes leads et tes conversations Instagram et Messenger, importe des contacts, bloque un indicatif, ou explique pourquoi un agent a dit quelque chose et corrige son prompt, le tout depuis une conversation.
Le serveur
Section intitulée « Le serveur »| Élément | Valeur |
|---|---|
| URL | https://mcp.whatsetter.com/mcp |
| Transport | Streamable HTTP. https://mcp.whatsetter.com/sse fonctionne encore pour les clients plus anciens. |
| Authentification | OAuth (recommandé) ou un en-tête direct Authorization: Bearer ws_live_… |
| Ce qu’il faut | Une clé API créée dans Paramètres, puis API & MCP |
Le serveur est un simple traducteur : chaque appel d’outil est un appel à l’API REST avec ta clé. Les scopes, les limites de débit et les règles anti-ban s’appliquent exactement comme pour l’API.
Deux façons de s’authentifier
Section intitulée « Deux façons de s’authentifier »OAuth. Tu ajoutes l’URL du serveur dans ton client. Le client ouvre une page de consentement WhatSetter dans ton navigateur ; tu colles ta clé ws_live_… une seule fois et tu cliques sur Authorize. Le client garde ensuite un jeton révocable et ne voit plus jamais la clé. À utiliser pour Claude, ChatGPT, Cursor, VS Code et tout client compatible OAuth.
Bearer direct. Tu passes la clé toi-même, dans un en-tête Authorization: Bearer ws_live_…. À utiliser pour les scripts, les serveurs et les clients où tu préfères gérer le secret dans une variable d’environnement.
POST https://mcp.whatsetter.com/mcpAuthorization: Bearer ws_live_…Dans les deux cas, révoquer la clé dans le dashboard coupe la connexion en moins d’une minute.
Claude Code
Section intitulée « Claude Code »Ajoute le serveur, puis lance /mcp dans Claude Code pour ouvrir la page de consentement :
claude mcp add --transport http whatsetter https://mcp.whatsetter.com/mcpPour utiliser la clé directement plutôt qu’OAuth :
claude mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp \ --header "Authorization: Bearer ws_live_…"Ajoute --scope user pour rendre le serveur disponible dans tous tes projets plutôt que dans le projet courant.
Claude (web et application de bureau)
Section intitulée « Claude (web et application de bureau) »Les connecteurs personnalisés se configurent dans ton compte Claude, puis sont disponibles dans l’application web et dans l’application de bureau Claude.
- Ouvre Customize, puis Connectors.
- Clique sur +, puis Add custom connector.
- Colle
https://mcp.whatsetter.com/mcpcomme URL du serveur MCP distant, puis clique sur Add. - Une page WhatSetter s’ouvre : colle ta clé API et clique sur Authorize.
Clique sur le lien d’installation, ou ajoute le serveur à la main dans ~/.cursor/mcp.json. Cursor ouvre la page de consentement à la première utilisation.
{ "mcpServers": { "whatsetter": { "url": "https://mcp.whatsetter.com/mcp" } }}Pour utiliser la clé directement, ajoute un objet headers avec "Authorization": "Bearer ws_live_…" à la même entrée.
En ligne de commande, ou dans .vscode/mcp.json (ou ton profil utilisateur via MCP: Open User Configuration). VS Code lance le flux OAuth dans ton navigateur à la première connexion.
code --add-mcp '{"name":"whatsetter","type":"http","url":"https://mcp.whatsetter.com/mcp"}'{ "servers": { "whatsetter": { "type": "http", "url": "https://mcp.whatsetter.com/mcp" } }}Les serveurs MCP distants sont disponibles pour les comptes Pro, Plus, Business, Enterprise et Education sur le web, après activation du mode développeur.
- Ouvre Settings, puis Security and login, et active Developer mode.
- Va sur
chatgpt.com/pluginset sélectionne le bouton plus pour créer une app pour ton serveur MCP. - Donne-lui un nom, et sous Connection saisis
https://mcp.whatsetter.com/mcpcomme URL du serveur MCP. - Choisis OAuth comme authentification et termine la page de consentement WhatSetter.
Dans une conversation, choisis Developer mode dans le menu plus et sélectionne WhatSetter.
Gemini CLI
Section intitulée « Gemini CLI »Gemini CLI découvre le flux OAuth tout seul pour les serveurs HTTP distants :
gemini mcp add --transport http whatsetter https://mcp.whatsetter.com/mcpPour utiliser la clé directement :
gemini mcp add --transport http --header "Authorization: Bearer ws_live_…" whatsetter https://mcp.whatsetter.com/mcpCodex CLI
Section intitulée « Codex CLI »Avec la clé dans une variable d’environnement :
export WHATSETTER_API_KEY="ws_live_…"codex mcp add whatsetter --url https://mcp.whatsetter.com/mcp --bearer-token-env-var WHATSETTER_API_KEYOu avec OAuth :
codex mcp add whatsetter --url https://mcp.whatsetter.com/mcpcodex mcp login whatsetterL’équivalent dans ~/.codex/config.toml :
[mcp_servers.whatsetter]url = "https://mcp.whatsetter.com/mcp"bearer_token_env_var = "WHATSETTER_API_KEY"Les 66 outils
Section intitulée « Les 66 outils »Chaque outil demande le scope de l’endpoint qu’il appelle. Une clé sans ce scope fait répondre insufficient_scope à l’outil.
| Outil | Scope | Ce qu’il fait |
|---|---|---|
whoami |
aucun | Espace, nom de la clé et scopes accordés. Appelle-le en premier. |
list_leads |
leads:read |
Lister les leads, filtrables par statut, campagne, canal, téléphone, ton external_reference, origine, lien traqué, date. |
get_lead |
leads:read |
Un lead avec statut, tags, responsable, prochaine action, compteurs. |
update_lead |
leads:write |
Changer le statut, les tags, assigned_to, next_action_at, next_action_label, deal_status, lost_reason. |
handoff_lead |
leads:write |
Arrêter l’IA sur cette conversation et passer la main à un humain. |
resume_lead |
leads:write |
Rendre la conversation à l’IA. |
list_lead_notes |
leads:read |
Les notes d’un lead, les plus récentes d’abord. |
add_lead_note |
leads:write |
Ajouter une note à un lead. |
list_conversations |
conversations:read |
Boîte de réception sur WhatsApp, Instagram et Messenger, activité la plus récente d’abord : qui répond à chacune, lesquelles attendent une réponse, ce qu’a lu « Le tri ». Filtres channel, needs_reply, triage. |
get_conversation_messages |
conversations:read |
Historique complet des messages d’un lead. |
send_message |
messages:send |
Envoie un vrai message à un lead déjà en conversation, sur son canal. WhatsApp : règles anti-ban. Instagram et Messenger : seulement dans les 24 heures qui suivent le dernier message de la personne. Idempotency-Key automatique. |
send_whatsapp_message |
messages:send |
Le même outil que send_message, sous son premier nom. |
list_lists |
lists:read |
Tes listes de contacts. |
create_list |
lists:write |
Créer une liste vide. Avec keep_open, une liste terminée repart d’elle-même quand des contacts arrivent. |
import_leads |
lists:write |
Pousser jusqu’à 500 contacts dans une liste. L’import n’envoie aucun message par lui-même. |
list_campaigns |
campaigns:read |
Les campagnes avec leur statut, leurs canaux et leur numéro connecté. |
pause_campaign |
campaigns:write |
Mettre en pause une campagne active. |
resume_campaign |
campaigns:write |
Relancer une campagne en pause. Les envois reprennent. |
add_campaign_lead |
messages:send |
Envoie le premier message à un lead opt-in via le pipeline de la campagne. |
list_bookings |
bookings:read |
Les rendez-vous pris par l’agent. |
list_groups |
groups:read |
Les groupes WhatsApp suivis. |
get_group |
groups:read |
Un groupe avec ses compteurs, son lien d’invitation, son mode IA. |
list_group_members |
groups:read |
Les membres d’un groupe, actifs ou partis. |
list_group_messages |
groups:read |
La transcription d’un groupe. |
list_group_events |
groups:read |
Les arrivées et départs d’un groupe. |
list_webhooks |
webhooks:manage |
Tes souscriptions, sans les secrets. |
create_webhook |
webhooks:manage |
Abonner un endpoint HTTPS. Le secret est renvoyé une seule fois. |
delete_webhook |
webhooks:manage |
Supprimer une souscription. |
test_webhook |
webhooks:manage |
Poster un événement de test signé vers ton endpoint. |
list_blocked_contacts |
blocklist:manage |
Les numéros et indicatifs bloqués. |
block_contact |
blocklist:manage |
Bloquer un numéro ou un indicatif. L’agent cesse d’y répondre. |
unblock_contact |
blocklist:manage |
Retirer un blocage. |
list_team_members |
team:read |
Les membres de l’espace, pour attribuer des leads. |
list_links |
links:read |
Les liens traqués avec leur nombre de clics. |
get_link |
links:read |
Un lien avec ses statistiques sur 30 jours. |
get_agent_prompts |
prompts:read |
Tout ce qui fait tourner un agent : ses prompts, ce qui est en ligne, ses variables et sa base de connaissances. |
get_agent_prompt |
prompts:read |
Un texte d’un agent. |
update_agent_prompt |
prompts:write |
Modifie un prompt, en ligne dès le prochain message de l’agent. Nouvelle version pour la conversation et le premier message. Refusé tant qu’un brouillon enregistré dans le dashboard attend, jusqu’à ce que tu choisisses quoi en faire. |
list_prompt_versions |
prompts:read |
L’historique d’un prompt, avec statut et auteur. |
get_prompt_version |
prompts:read |
Une version avec son texte entier. |
compare_prompt_versions |
prompts:read |
Ce qu’une version change par rapport à une autre, ou au texte en service, sous forme de diff. |
restore_prompt_version |
prompts:write |
Remet une version précédente en service, en ligne dès le prochain message. |
list_knowledge_bases |
knowledge:read |
Les bases de connaissances avec leurs sources et les agents reliés. |
get_knowledge_base |
knowledge:read |
Une base avec chaque site, chaque fichier (et si son texte est modifiable) et son nombre de réponses. |
search_knowledge |
knowledge:read |
Les passages que l’agent reçoit pour un message. La même recherche qu’au moment de répondre. |
list_knowledge_answers |
knowledge:read |
Les paires question et réponse d’une base. |
add_knowledge_answer |
knowledge:write |
Ajouter une réponse. Les agents s’en servent dès leur prochaine réponse. |
update_knowledge_answer |
knowledge:write |
Corriger une réponse. Le texte précédent n’est pas gardé. |
delete_knowledge_answer |
knowledge:write |
Retirer une réponse. |
get_knowledge_file |
knowledge:read |
Tout le texte d’un fichier. Pour un PDF ou un fichier Word, le texte que l’agent détient. |
add_knowledge_file |
knowledge:write |
Ajouter un fichier texte. Il est lu tout de suite. |
update_knowledge_file |
knowledge:write |
Réécrire un fichier texte : un seul endroit avec des remplacements ciblés, ou tout le texte. Les agents le savent dès leur prochaine réponse. |
delete_knowledge_file |
knowledge:write |
Retirer un fichier, quel que soit son type. |
list_instagram_accounts |
instagram:read |
Les comptes Instagram connectés : ce que chacun peut faire, sa Page Facebook, son agent, « Le tri », la pause après la réponse d’une personne. |
list_instagram_posts |
instagram:read |
Les publications Instagram des 7, 30 ou 90 derniers jours : les vues face à la moyenne du compte, puis ce qu’elles ont rapporté, jusqu’aux rendez-vous. |
get_instagram_best_times |
instagram:read |
Les jours et les heures où les publications du compte marchent le mieux, et les trois prochains moments pour publier. |
get_instagram_stats |
instagram:read |
Ce qu’ont fait les automatisations sur 7, 30 ou 90 jours face à la période d’avant, par jour, par automatisation et par publication. |
list_scheduled_instagram_posts |
instagram:read |
Les publications programmées depuis WhatSetter, leur état et la raison d’un échec. |
get_scheduled_instagram_post |
instagram:read |
Une publication programmée : son état, son lien une fois en ligne, sa copie sur la Page Facebook. |
schedule_instagram_post |
instagram:write |
Publie publiquement sur Instagram, maintenant ou à une heure : une photo, un carrousel, un reel (ou un reel d’essai) ou une story, avec un premier commentaire et une automatisation au choix. |
update_scheduled_instagram_post |
instagram:write |
Peut publier : changer la légende, l’heure, le premier commentaire, l’automatisation ou les options d’une publication programmée ; publish_at: null la publie dans la minute. |
cancel_scheduled_instagram_post |
instagram:write |
Annuler une publication programmée. Elle ne part pas. |
list_instagram_automations |
instagram:read |
Les automatisations sur les commentaires, les stories et les messages, avec ce qu’elles ont fait. |
create_instagram_automation |
instagram:write |
Créer une automatisation, éteinte par défaut. Allumée, elle écrit à de vraies personnes. |
update_instagram_automation |
instagram:write |
Modifier une automatisation, ou l’allumer et l’éteindre. |
delete_instagram_automation |
instagram:write |
Supprimer une automatisation et ses compteurs. |
Cinq outils peuvent atteindre une vraie personne : send_message (et son premier nom send_whatsapp_message) et add_campaign_lead envoient un message, et create_instagram_automation / update_instagram_automation allument une automatisation qui écrit à toutes les personnes qui commentent ses mots. Trois publient ou retirent sur Instagram : schedule_instagram_post, update_scheduled_instagram_post et cancel_scheduled_instagram_post. resume_campaign relance les envois propres à une campagne. test_webhook poste vers ton serveur, pas vers un contact.
Deux outils changent ce que dit un agent en service dès son prochain message : update_agent_prompt et restore_prompt_version.
Expliquer et corriger une réponse
Section intitulée « Expliquer et corriger une réponse »Demande à l’assistant pourquoi un agent a dit quelque chose. Il lit trois choses à la suite et cite ce qui explique la réponse :
| Étape | Outil | Ce qu’il donne |
|---|---|---|
| 1 | get_conversation_messages |
L’échange. Chaque message dit ce qui l’a écrit : le premier message, une réponse, une relance ou une personne. |
| 2 | get_agent_prompts |
Le prompt sur lequel l’agent tournait, avec les valeurs de ses variables. |
| 3 | search_knowledge |
Les passages que l’agent a reçus de sa base de connaissances pour ce message. |
Demande ensuite la correction. L’assistant propose le plus petit changement, te le montre, et l’applique avec update_agent_prompt, add_knowledge_answer ou update_knowledge_file une fois que tu es d’accord. restore_prompt_version annule une modification de prompt, et compare_prompt_versions montre ce qui a changé entre deux versions.
Si un brouillon enregistré dans le dashboard attend sur le prompt, l’assistant te le dit avant de changer quoi que ce soit : l’agent ne lit pas ce brouillon, et c’est toi qui choisis de quel texte partir.
Le serveur envoie ces étapes à l’assistant quand il se connecte, tu n’as donc pas à les détailler. Le détail est dans Prompts des agents et Bases de connaissances.
Exemples de demandes
Section intitulée « Exemples de demandes »- « Montre-moi les leads qualifiés cette semaine et qui est responsable de chacun. »
- « Attribue tous les leads qualifiés sans responsable à Julien et mets une prochaine action lundi 9h intitulée Rappeler. »
- « Bloque l’indicatif +91, raison : hors marché. »
- « Quel lien traqué a amené le plus de leads sur les 30 derniers jours ? »
- « Importe ces 40 contacts dans une nouvelle liste appelée Webinaire septembre. » (colle les contacts)
- « Mets la campagne Acme France en pause. »
- « Résume la conversation avec +33612345678 et ajoute une note avec le résumé. »
- « Quels messages Instagram attendent une réponse de ma part ? Prépare une réponse pour chacun, je les relis avant que tu envoies. »
- « Crée une automatisation, éteinte, qui envoie le guide de l’acheteur à tous ceux qui commentent GUIDE sous mes prochaines publications. »
- « Pourquoi mon agent Julien a dit à +33612345678 que l’essai coûte 12 euros ? Trouve la cause et propose une correction. »
- « Dans le prompt de conversation de Julien, ajoute une règle : ne jamais donner de prix avant que le prospect ait dit ce qu’il cherche. Montre-moi le changement d’abord. »
Sécurité
Section intitulée « Sécurité »- Les outils de lecture sont marqués en lecture seule.
send_message,send_whatsapp_message,add_campaign_lead, les outils d’automatisation Instagram et ceux qui publient sont marqués comme ayant un effet réel : un client bien conçu te demande avant de les appeler. Relis le message avant d’approuver, il part vers une vraie personne. update_agent_promptetrestore_prompt_versionsont marqués de la même façon : le changement est en ligne dès le prochain message de l’agent, relis-le donc avant d’approuver. Chaque modification de prompt est une nouvelle version, et une restauration fait revenir la précédente.- L’assistant ne peut faire que ce que la clé autorise. Donne à un assistant une clé Personnalisé avec des scopes de lecture s’il ne doit rien envoyer.
- Chaque session
/mcpest liée à la clé qui l’a ouverte : un identifiant de session volé est inutilisable sans la clé. - Révoque la clé dans Paramètres, puis API & MCP, et tout s’arrête : appels REST, sessions OAuth et sessions bearer direct.