# Connecter son assistant (MCP)

> Brancher Claude Code ou un autre client MCP sur FanConvert, avec l'en-tête Authorization Bearer.

URL : https://docs.fanconvert.ai/fr/api/assistant

Le serveur MCP de FanConvert est à l'adresse **`https://app.fanconvert.ai/mcp`** (transport HTTP, « Streamable HTTP »). Chaque requête porte votre clé dans l'en-tête `Authorization: Bearer fc_sk_…`.

Commencez par [créer une clé](/fr/api/cles) en choisissant **Brancher un assistant IA** : FanConvert vous donne alors le bloc à coller, **votre clé déjà dedans**, avec un bouton **Copier le bloc**.

## Claude Code [#claude-code]

1. Ouvrez un terminal sur l'ordinateur où Claude Code est installé.
2. Collez cette commande (votre clé est déjà dedans dans FanConvert), puis validez :

   ```bash
   claude mcp add --transport http fanconvert https://app.fanconvert.ai/mcp \
     --header "Authorization: Bearer fc_sk_…"
   ```

3. Dans Claude Code, tapez `/mcp` : **fanconvert apparaît connecté.**

Ensuite, posez votre question en français, par exemple : « Combien de ventes Emma a-t-elle faites cette semaine ? »

## Autre client MCP [#autre-client-mcp]

Tout client qui accepte un serveur MCP distant avec un en-tête fixe :

1. Ajoutez un serveur MCP distant, transport « HTTP » (Streamable HTTP).
2. Adresse : `https://app.fanconvert.ai/mcp`
3. En-tête à envoyer à chaque requête : **`Authorization: Bearer <votre clé>`**.

## Les autres assistants [#les-autres-assistants]

Dans Réglages › API & MCP, les onglets **Claude**, **Cursor** et **ChatGPT** affichent « Mode d'emploi en cours de vérification » ou, pour ChatGPT, « ChatGPT n'accepte pas encore de clé : il exige une connexion OAuth, que FanConvert ne propose pas encore. » Cette page sera complétée pour chacun dès que son mode d'emploi est vérifié dans l'application.

## Ce que l'assistant voit [#ce-que-lassistant-voit]

L'assistant ne voit que les outils que votre clé permet : une clé « Lecture seule » ne propose aucun outil d'écriture. La liste complète est sur [Ce que l'assistant peut lire et faire](/fr/api/outils-mcp).

## Si ça ne marche pas [#si-ça-ne-marche-pas]

| Symptôme | Que faire |
|---|---|
| `401` ou « non autorisé » | Clé mal copiée, expirée ou révoquée : vérifiez-la dans Réglages › API & MCP, créez-en une autre si besoin. |
| L'assistant ne voit pas une créatrice | La clé ne l'inclut pas : une créatrice ajoutée après la création de la clé n'y entre pas. Créez une nouvelle clé. |
| Un outil manque | La clé n'a pas le droit correspondant. Les droits d'une clé ne changent pas : créez-en une avec le bon choix. |
| `429` | Trop de requêtes d'un coup : attendez quelques secondes. |