# API & MCP : connecter un assistant IA

_API · Lecture de 7 min · Mis à jour 2026-10-22 · https://lanachat.ai/guides/fr/api-mcp/_

**API & MCP** (dans Users, en bas de la barre latérale) vous permet de connecter un assistant IA, comme Claude ou un autre client MCP, pour configurer et gérer votre espace de travail. MCP est une norme ouverte qui permet à un assistant d’utiliser des outils dans une application en votre nom. Les mêmes jetons d’accès ouvrent la [REST API](https://lanachat.ai/guides/fr/api-overview/).

> Note: Seuls le propriétaire de l’espace de travail et les propriétaires d’agence peuvent ouvrir cette page. Les autres voient « Owner access required ».

## Ce dont vous avez besoin

- Le **point de terminaison MCP**, affiché en haut de la page. Appuyez sur **Copy URL**.
- Un **jeton d’accès** qui précise ce que l’assistant peut faire.

## Créer un jeton d’accès

1. Appuyez sur **Create token**.
2. Donnez-lui un nom et choisissez ses accès : **Workspace setup**, ou **Custom permissions** pour cocher les permissions une par une (par exemple « Read fans and conversations » ou « Read sales »).
3. Enregistrez. Le jeton est affiché une seule fois : appuyez sur **Copy token**, ou **Copy client configuration** pour obtenir une configuration prête à l’emploi pour votre assistant.
4. Appuyez sur **Done, I saved it**.

## Connecter votre assistant

1. Créez un accès dédié pour cet assistant (un jeton par outil connecté).
2. Ajoutez la connexion HTTP MCP dans votre assistant, avec le point de terminaison et le jeton (étapes exactes ci-dessous).
3. Demandez-lui ce qu’il peut voir, pour vérifier que les permissions sont correctes.
4. Travaillez en brouillons : laissez-le préparer les modifications, testez-les, puis publiez.

Les mêmes étapes, avec le point de terminaison, l’en-tête et la configuration prêts à copier, se trouvent dans **Connect your assistant** en bas de la page API & MCP. Dans chaque exemple ci-dessous, remplacez l’URL par celle de votre espace de travail (**Copy URL**) et `YOUR_MCP_TOKEN` par votre jeton.

### Claude Code

Une commande dans votre terminal :

```bash
claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"
```

Puis tapez `/mcp` dans Claude Code : `lanachat` apparaît comme connecté, avec ses outils.

### Cursor

Ajoutez ceci dans `~/.cursor/mcp.json` (pour tous les projets) ou `.cursor/mcp.json` (pour un projet), puis activez `lanachat` dans **Settings › MCP** :

```json
{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### VS Code (GitHub Copilot)

Ajoutez ceci dans `.vscode/mcp.json` de votre projet :

```json
{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### Claude Desktop

Claude Desktop démarre des serveurs locaux depuis son fichier de configuration, il atteint donc LanaChat via le petit pont `mcp-remote` (Node.js 18 ou plus). Ouvrez **Settings › Developer › Edit Config** et ajoutez :

```json
{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

Redémarrez Claude Desktop ; les outils LanaChat apparaissent dans le menu des outils d’une nouvelle conversation.

### ChatGPT et autres assistants

Tout client MCP capable d’envoyer un en-tête sur une connexion HTTP fonctionne avec la configuration ci-dessus. Les connecteurs web qui n’offrent qu’une connexion OAuth (connecteurs ChatGPT, connecteurs personnalisés sur claude.ai) ne peuvent pas envoyer de jeton d’accès, ils ne peuvent donc pas encore se connecter.

### Vérifier la connexion

L’inspecteur MCP liste les outils ouverts par votre jeton, sans assistant :

```bash
npx @modelcontextprotocol/inspector
```

Choisissez **Streamable HTTP**, collez le point de terminaison, ajoutez l’en-tête `Authorization: Bearer YOUR_MCP_TOKEN`, puis **Connect** et **List tools**.

## Gérer les jetons

Le tableau **Access tokens** montre les permissions, la date d’expiration et le statut de chaque jeton. Utilisez **Edit**, **Rotate** (ou **Renew**) et **Revoke**. **Show revoked tokens** liste les anciens.

> Warning: Un jeton fonctionne comme un mot de passe. Révoquez-le dès que vous n’utilisez plus l’assistant ou si vous pensez qu’il a fuité.

## Le point de terminaison MCP

| Method | Path | Description | Permission | Status |
|---|---|---|---|---|
| POST | `https://app.lanachat.ai/mcp` | Le serveur MCP (Streamable HTTP) : chaque appel d’outil passe ici | any token | Planned |
| GET | `https://app.lanachat.ai/mcp` | Ouvre le flux d’événements de la session | any token | Planned |
| POST | `https://app.lanachat.ai/api/media/uploads` | Téléchargements médias depuis un assistant, avec le même jeton | `can_setup` | Planned |

L’URL exacte de votre espace de travail est affichée en haut de la page API & MCP (**Copy URL**). Le jeton va dans l’en-tête `Authorization`, comme pour l’API. Une configuration client ressemble à ceci :

```json
{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

## Outils accessibles à l’assistant

L’assistant ne voit que les outils autorisés par son jeton. Un outil qu’il ne peut pas utiliser n’est pas du tout listé. Lorsqu’il se connecte, le serveur envoie à l’assistant les arguments exacts de chaque outil (nom, type, requis), vous n’avez donc jamais à les taper vous-même. La dernière colonne est le point d’API qui fait la même chose, où ses paramètres sont documentés.

| Tool | Ce qu’il fait | Permission | Même chose dans l’API |
|---|---|---|---|
| `list_creators`, `get_creator` | Lire les créatrices, leur identité et l’avancement de la configuration | `can_setup` | [`GET /creators`](https://lanachat.ai/guides/fr/api-creators/) |
| `update_creator`, `update_persona` | Modifier l’identité d’une créatrice ou ses pages persona | `can_setup`, `can_engine` pour la persona | [`PUT …/identity`, `PATCH …/persona`](https://lanachat.ai/guides/fr/api-creators/) |
| `list_accounts`, `update_account` | Lire les comptes Telegram, changer brain, market ou traffic | `can_setup` | [`GET /accounts`, `PATCH /accounts/{id}`](https://lanachat.ai/guides/fr/api-telegram-accounts/) |
| `list_media`, `upload_media`, `update_media`, `create_media_folder` | Ajouter des médias dans un Vault, les trier, suggérer des descriptions (montrées pour relecture avant sauvegarde) | `can_setup` | [`/media`](https://lanachat.ai/guides/fr/api-vault/) |
| `list_scripts`, `draft_script`, `update_script` | Lire les scripts et en rédiger de nouveaux : étapes, médias et prix Stars | `can_setup` | [`/scripts`](https://lanachat.ai/guides/fr/api-scripts/) |
| `list_members`, `update_member` | Lire et modifier les membres de l’équipe | `can_setup` | [`/members`](https://lanachat.ai/guides/fr/api-team/) |
| `get_brain`, `update_brain_draft`, `test_brain` | Lire un brain, éditer son brouillon, le tester dans le Playground | `can_engine` | [`/brains`, `/playground`](https://lanachat.ai/guides/fr/api-ai-brains/) |
| `publish_brain` | Publier un brouillon de brain ordinaire | `can_publish` | [`POST /brains/{id}/publish`](https://lanachat.ai/guides/fr/api-ai-brains/) |
| `test_advanced_ai`, `tune_advanced_ai`, `publish_advanced_ai` | Brouillons, réglages et profils d’IA avancée (propriétaire de l’espace uniquement) | `can_ai_test`, `can_ai_tune`, `can_ai_publish` | Aucun |
| `list_experiment_reports` | Lire les rapports d’expériences commerciales (propriétaire de l’espace uniquement) | `can_commercial_reports` | Aucun |
| `list_fans`, `get_conversation` | Lire les fans et l’historique des conversations | `can_fan_read` | [`GET /fans`, `GET /conversations/{id}/messages`](https://lanachat.ai/guides/fr/api-conversations/) |
| `import_fan_history` | Ajouter les fans et messages passés aux archives ; n’envoie jamais de message | `can_fan_import` | [`POST /fans/import`](https://lanachat.ai/guides/fr/api-conversations/) |
| `list_sales` | Lire les ventes enregistrées pour les rapports | `can_sales_read` | [`GET /fans/{id}/sales`](https://lanachat.ai/guides/fr/api-conversations/), [`GET /stats`](https://lanachat.ai/guides/fr/api-tracking/) |

> Note: Désactiver **Access AI configuration** supprime aussi les permissions de publication, d’IA avancée et de rapports d’expériences. La configuration de l’espace et les permissions fans et ventes restent indépendantes. Aucun outil n’envoie de message à un fan.

## Que lui demander

Parlez-lui comme à un collègue qui connaît la Console. Quelques exemples de requêtes efficaces :

- « Liste mes créatrices et dis-moi lesquelles ont une configuration inachevée. »
- « Lis la persona de Lea et suggère trois réponses types pour les fans qui demandent si elle est réelle. Ne sauvegarde rien. »
- « Rédige un script de reconquête pour Lea : trois étapes sur deux jours, la dernière une offre payante à 250 Stars. Laisse-le inactif. »
- « Télécharge les photos dans ce dossier vers le Vault de Lea, dans un dossier appelé Beach, et suggère une description pour chacune. »
- « Modifie le brouillon du brain de Lea pour que la première offre arrive après 6 messages, teste-le dans le Playground avec un fan anglophone, et montre-moi les réponses avant publication. »
- « Combien chaque créatrice a-t-elle vendu hier, et quel lien de tracking a apporté le plus d’acheteurs cette semaine ? »

> Tip: Demandez-lui de travailler en brouillons et de vous montrer le résultat avant publication. Publier nécessite un jeton avec **Publish AI Brain drafts** : laissez-le désactivé si vous voulez garder le dernier mot.

## Points de terminaison des jetons

La page ci-dessus appelle ces routes ; le [guide équipe](https://lanachat.ai/guides/fr/api-team/) liste les mêmes actions dans l’API publique (`/v1/tokens`).

| Method | Path | Description | Permission | Status |
|---|---|---|---|---|
| GET | `/api/mcp/tokens` | Liste les jetons, leurs permissions, expiration et statut | `owner` | Planned |
| POST | `/api/mcp/tokens` | Crée un jeton (affiché une fois) | `owner` | Planned |
| PUT | `/api/mcp/tokens/{id}` | Modifie son nom ou ses permissions | `owner` | Planned |
| POST | `/api/mcp/tokens/{id}/rotate` | Fait tourner le secret | `owner` | Planned |
| DELETE | `/api/mcp/tokens/{id}` | Le révoque | `owner` | Planned |

Ces routes Console prennent et renvoient les permissions sous forme de champs booléens (`can_setup`, `can_engine`, `can_publish`, `can_ai_test`, `can_ai_tune`, `can_ai_publish`, `can_commercial_reports`, `can_fan_read`, `can_fan_import`, `can_sales_read`). La création d’un jeton répond `{ "token": "…", "grant": { … } }` : `token` est le secret, affiché une fois ; `grant` est l’accès avec son `id`, `name`, `scope`, `enabled`, `created` et `expires` (secondes Unix). La rotation révoque l’ancien accès et répond un nouveau `token` et `grant`. Un nom manquant répond `400`, un id inconnu `404`, un accès révoqué `409`.

Plus d’infos sur la [page fonctionnalité API et MCP](https://lanachat.ai/landing/features/api-and-mcp/).

## Articles liés

- [API LanaChat : démarrage rapide, authentification et erreurs](https://lanachat.ai/guides/fr/api-overview/)
- [Recettes rapides API : copier, coller, exécuter](https://lanachat.ai/guides/fr/api-recipes/)
- [Qu'est-ce qu'un AI Brain](https://lanachat.ai/guides/fr/what-is-an-ai-brain/)