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

Source: https://docs.whatsetter.com/fr/developers/mcp/

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

| É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](/fr/dashboard/anti-ban/) s'appliquent exactement comme pour l'API.

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

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

## Claude Code

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

```bash
claude mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp
```

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

```bash
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)

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

## Cursor

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.

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=whatsetter&config=eyJ1cmwiOiJodHRwczovL21jcC53aGF0c2V0dGVyLmNvbS9tY3AifQ==">Ajouter WhatSetter à Cursor</a>

```json
{
  "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.

## VS Code

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.

```bash
code --add-mcp '{"name":"whatsetter","type":"http","url":"https://mcp.whatsetter.com/mcp"}'
```

```json
{
  "servers": {
    "whatsetter": {
      "type": "http",
      "url": "https://mcp.whatsetter.com/mcp"
    }
  }
}
```

## ChatGPT

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

Gemini CLI découvre le flux OAuth tout seul pour les serveurs HTTP distants :

```bash
gemini mcp add --transport http whatsetter https://mcp.whatsetter.com/mcp
```

Pour utiliser la clé directement :

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

## Codex CLI

Avec la clé dans une variable d'environnement :

```bash
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 :

```bash
codex mcp add whatsetter --url https://mcp.whatsetter.com/mcp
codex mcp login whatsetter
```

L'équivalent dans `~/.codex/config.toml` :

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

## 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

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](/fr/developers/guides/prompts/) et [Bases de connaissances](/fr/developers/guides/knowledge/).

## 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é

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

## Voir aussi

- [Authentification et permissions](/fr/developers/authentication/)
- [Erreurs, limites et idempotence](/fr/developers/errors/)
- [Utiliser ces docs avec des assistants IA](/fr/developers/ai-assistants/)
