Aller au contenu
Dashboard

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.

É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.

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/mcp
Authorization: Bearer ws_live_…

Dans les deux cas, révoquer la clé dans le dashboard coupe la connexion en moins d’une minute.

Ajoute le serveur, puis lance /mcp dans Claude Code pour ouvrir la page de consentement :

Terminal window
claude mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp

Pour utiliser la clé directement plutôt qu’OAuth :

Terminal window
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.

Les connecteurs personnalisés se configurent dans ton compte Claude, puis sont disponibles dans l’application web et dans l’application de bureau Claude.

  1. Ouvre Customize, puis Connectors.
  2. Clique sur +, puis Add custom connector.
  3. Colle https://mcp.whatsetter.com/mcp comme URL du serveur MCP distant, puis clique sur Add.
  4. 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.

Ajouter WhatSetter à Cursor
{
"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.

Terminal window
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.

  1. Ouvre Settings, puis Security and login, et active Developer mode.
  2. Va sur chatgpt.com/plugins et sélectionne le bouton plus pour créer une app pour ton serveur MCP.
  3. Donne-lui un nom, et sous Connection saisis https://mcp.whatsetter.com/mcp comme URL du serveur MCP.
  4. 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 découvre le flux OAuth tout seul pour les serveurs HTTP distants :

Terminal window
gemini mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp

Pour utiliser la clé directement :

Terminal window
gemini mcp add --transport http --header "Authorization: Bearer ws_live_…" whatsetter https://mcp.whatsetter.com/mcp

Avec la clé dans une variable d’environnement :

Terminal window
export WHATSETTER_API_KEY="ws_live_…"
codex mcp add whatsetter --url https://mcp.whatsetter.com/mcp --bearer-token-env-var WHATSETTER_API_KEY

Ou avec OAuth :

Terminal window
codex mcp add whatsetter --url https://mcp.whatsetter.com/mcp
codex mcp login whatsetter

L’équivalent dans ~/.codex/config.toml :

[mcp_servers.whatsetter]
url = "https://mcp.whatsetter.com/mcp"
bearer_token_env_var = "WHATSETTER_API_KEY"

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.

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.

  • « 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. »
  • 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_prompt et restore_prompt_version sont 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 /mcp est 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.