> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/connect-ai-clients-mcp.md).

# Connecter les clients AI avec MCP

Générez un jeton MCP dans Paramètres → Automatisation et connectez Claude Desktop, Claude Code, Cursor, Windsurf, VS Code ou Codex CLI à votre compte Incogniton.

Ouvrez **Paramètres** dans le menu de gauche, cliquez sur l'onglet **Automatisation** et cliquez sur **Générer un jeton MCP**. Ensuite, choisissez votre client IA sous **Installer dans votre client IA** et cliquez sur **Copier la configuration**.

MCP (Model Context Protocol) permet à un client IA tel que Claude, Cursor ou VS Code de fonctionner avec votre compte Incogniton. Vous pouvez lui demander de trouver, créer ou modifier des profils, gérer des proxys, des groupes et des tags, et lancer ou arrêter des profils.

La connexion s'exécute via le package npm `@incogniton/mcp`. Votre client IA le démarre avec `npx`, donc vous avez besoin de [Node.js](https://nodejs.org/) 18 ou plus récent sur l'ordinateur où le client IA fonctionne.

### Générez votre jeton MCP

{% stepper %}
{% step %}

#### Ouvrez l'onglet Automatisation

Cliquez sur **Paramètres** dans le menu de gauche, puis cliquez sur l'onglet **Automatisation**. Faites défiler jusqu'à la section **Jeton MCP**.
{% endstep %}

{% step %}

#### Générez le jeton

Cliquez sur **Générer un jeton MCP**. Le nouveau jeton apparaît dans un champ sous le bouton.
{% endstep %}

{% step %}

#### Copiez-le et stockez-le

Cliquez sur **Copier** à côté du jeton et stockez-le en lieu sûr, par exemple dans un gestionnaire de mots de passe. Incogniton n'affiche le jeton qu'une seule fois : **Attention : Vous ne pouvez pas récupérer ce jeton plus tard — copiez-le et stockez-le maintenant.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Traitez le jeton MCP comme un mot de passe. Toute personne qui le possède peut gérer les profils de votre compte. Ne le partagez jamais et ne le collez pas dans un fichier public.
{% endhint %}

### Remplacer ou révoquer votre jeton

Vous avez un jeton MCP actif à la fois. Cliquer à nouveau sur **Générer un jeton MCP** crée un nouveau jeton et rend l'ancien inactif. Mettez à jour le jeton dans chaque client IA que vous avez connecté.

Pour arrêter tout accès, cliquez sur **Révoquer** sous **Jetons actifs**. Lorsqu'aucun jeton n'est actif, la section affiche **Aucun jeton actif**.

### Ajouter Incogniton à votre client IA

Sous **Installer dans votre client IA**, ouvrez le menu déroulant **Client IA** et choisissez votre client : Claude Desktop, Claude Code, Cursor, Windsurf, VS Code ou Codex CLI. Incogniton affiche une configuration prête à coller avec votre nouveau jeton déjà rempli, et vous indique où le coller. Cliquez sur **Copier la configuration**, collez-la où l'application vous le dit, et redémarrez le client IA.

Générez d'abord le jeton. Si vous ouvrez cette liste plus tard, la configuration contient `YOUR_MCP_TOKEN` au lieu d'un jeton : remplacez-le par le jeton que vous avez stocké.

Pour une configuration manuelle dans d'autres clients MCP, consultez la [documentation du serveur MCP](https://api-docs.incogniton.com/mcp).

### Ce que le client IA peut faire via MCP

Après la connexion, votre client IA peut :

* **Profils :** rechercher, créer, modifier et cloner des profils, et consulter les groupes, tags, proxys et langues de navigateur que vous pouvez utiliser pour un nouveau profil.
* **Groupes et tags :** rechercher et créer des groupes et des tags de profils.
* **Proxys :** rechercher et ajouter des proxys, et rechercher et créer des groupes de proxys.
* **Équipe :** consulter les membres de l'équipe.
* **Lancer et arrêter :** voir quels ordinateurs peuvent lancer un profil, lancer un profil, vérifier si un lancement ou un arrêt a fonctionné, et arrêter un profil.
* **Téléphones cloud :** lister vos téléphones cloud, créer un téléphone cloud avec un proxy de votre bibliothèque de proxys, et démarrer ou arrêter des téléphones cloud. Les téléphones démarrés via MCP démarrent sans écran.

La liste complète des outils se trouve dans la [documentation du serveur MCP](https://api-docs.incogniton.com/mcp).

### Comment fonctionne le lancement via MCP

Un profil s'ouvre toujours dans l'application Incogniton sur l'un de vos ordinateurs. Cet ordinateur doit avoir l'application ouverte et être connecté à votre compte.

* Si un ordinateur est disponible, le profil y est lancé. Si plusieurs le sont, le client IA obtient la liste des ordinateurs et vous en choisissez un.
* Une demande de lancement qu'aucun ordinateur ne prend en charge dans les 5 minutes expire.
* MCP ne peut arrêter que les profils lancés via MCP. Fermez un profil que vous avez ouvert vous-même depuis l'application Incogniton.

### Contrôler le navigateur après un lancement MCP

MCP lui-même ne fait qu'ouvrir et fermer des profils. Il ne peut pas cliquer, taper ou lire des pages dans le navigateur.

Après un lancement, le client IA peut obtenir une adresse DevTools locale (`cdp_url`) du navigateur en cours d'exécution. Un client IA capable d'exécuter du code peut connecter Puppeteer, Playwright ou un navigateur MCP à cette adresse.

{% hint style="info" %}
Le `cdp_url` ne fonctionne que lorsque le client IA s'exécute sur le **même ordinateur** que l'application Incogniton qui a lancé le profil. Il ne fonctionne pas depuis un autre ordinateur, ou depuis un client qui ne peut pas exécuter de code, comme Claude Desktop. Il nécessite également que **Autoriser le contrôle à distance du navigateur** soit activé dans l'onglet Automatisation. Voir [Contrôle à distance du navigateur](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/browser-remote-control.md).
{% endhint %}

### Ce que MCP ne peut pas faire

Ces actions ne sont pas disponibles via MCP :

* Ouvrir une URL, gérer les onglets ou lire des pages dans un profil en cours d'exécution.
* Vérifier si un proxy fonctionne.
* Supprimer des profils.
* Restaurer un profil à partir d'une sauvegarde.

Cas, l'assistant IA dans l'application Incogniton, peut faire cela. Ouvrez Cas dans l'application pour les utiliser.

### Dépannage

* **Le client n'affiche aucun outil Incogniton :** redémarrez le client IA après avoir collé la configuration, et vérifiez que Node.js 18 ou plus récent est installé.
* **Le journal MCP du client indique "jeton porteur manquant" :** le jeton est absent de la configuration. Collez votre jeton à la place de `YOUR_MCP_TOKEN`.
* **Erreurs d'authentification :** le jeton a été remplacé ou révoqué. Générez-en un nouveau et mettez à jour la configuration.

Pour les scripts qui s'exécutent sur votre propre ordinateur, vous pouvez également utiliser l'[API REST locale](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/local-rest-api.md) ou le [SDK JavaScript et Python](https://docs.incogniton.com/documentation/french-documentation/api-dautomation-et-sdks/javascript-and-python-sdk.md).
