---
title: "Brancher votre agent IA à while par MCP"
url: https://while.sh/fr/docs/demarrer/brancher-votre-agent/
updated: 2026-11-09
---

# Brancher votre agent

Votre agent se branche lui-même si vous lui donnez la phrase. Sinon, une commande branche tous vos agents d'un coup, et un connecteur branche votre conversation.

## Le plus simple : la phrase

Collez ces instructions à votre agent. Il lit la page faite pour lui et se branche à while avec votre compte : vous l'autorisez dans votre navigateur. Puis il met votre appli en ligne.

```text titre="Instructions"
Connecte-toi à while avec mon compte (while.sh/agents), puis mets mon appli en ligne.
```

## Tous vos agents en une commande

Dans un terminal, cette commande branche while à Claude Code, Codex, Cursor, Gemini CLI et VS Code, s'ils sont installés. Elle ne change que leurs fichiers de configuration, dans votre dossier personnel, sans sudo. Relancée, elle ne duplique rien.

```sh titre="Terminal"
curl -fsSL https://app.while.sh/install.sh | sh
```

Pour voir ce qu'elle ferait sans rien écrire, ajoutez `-s -- --dry-run` à la fin.

## Dans un terminal

Ou branchez un seul agent à l'adresse du serveur MCP de while, `https://app.while.sh/mcp` :

```sh onglet="Claude Code" titre="Terminal"
claude mcp add --transport http --scope user while https://app.while.sh/mcp
```

```sh onglet="Codex" titre="Terminal"
codex mcp add while --url https://app.while.sh/mcp
codex mcp login while
```

```json onglet="Cursor" titre="~/.cursor/mcp.json"
{
  "mcpServers": {
    "while": { "url": "https://app.while.sh/mcp" }
  }
}
```

```json onglet="VS Code" titre=".vscode/mcp.json"
{
  "servers": {
    "while": { "type": "http", "url": "https://app.while.sh/mcp" }
  }
}
```

```sh onglet="Gemini CLI" titre="Terminal"
gemini mcp add --scope user --transport http while https://app.while.sh/mcp
```

Dans Cursor, [installez while en un clic](cursor://anysphere.cursor-deeplink/mcp/install?name=while&config=eyJ1cmwiOiJodHRwczovL2FwcC53aGlsZS5zaC9tY3AifQ==). Dans VS Code aussi : [installer while dans VS Code](https://vscode.dev/redirect/mcp/install?name=while&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.while.sh%2Fmcp%22%7D).

Au premier appel à while, une page s'ouvre dans votre navigateur. Choisissez « Une nouvelle appli », puis cliquez sur Autoriser.

## Ce que votre agent peut faire

Sur la page d'autorisation, vous choisissez où votre agent agit et ses droits : Lire (l'état, les journaux, les erreurs), Lire et agir (mettre en ligne, changer les variables), ou Administrer (les membres et les accès), sur toute l'organisation. Au niveau Lire et agir, votre agent vous demande votre accord pour un geste d'administration, comme inviter un membre ou créer un jeton : une page de while dit le geste, pour qui et sur quoi, et vous confirmez d'un clic.

Aux niveaux Lire et Lire et agir, votre agent reçoit d'abord 40 outils ; au niveau Administrer, il les a tous. Pour un geste qui n'y est pas, il charge un groupe d'outils, qui lui reste d'une session à l'autre. Vous changez ses droits et retirez ses groupes dans Mes agents. [Les outils MCP de while](/fr/docs/reference/outils-mcp/) les détaillent un par un.

## Dans une conversation

Dans Claude, ChatGPT ou Mistral Vibe, ajoutez while comme connecteur personnalisé, à l'adresse `https://app.while.sh/mcp` :

- [Brancher Claude](/fr/guides/brancher-claude/) : Personnaliser, puis Connecteurs, puis un connecteur personnalisé.
- [Brancher ChatGPT](/fr/guides/brancher-chatgpt/) : Plugins, puis « Add custom MCP server », avec ChatGPT Business, Enterprise ou Edu.
- [Brancher Mistral Vibe](/fr/guides/brancher-mistral-vibe/) : Connecteurs, puis l'onglet Custom MCP Connector.

Sans compte, utilisez l'adresse d'essai, `https://app.while.sh/essai`, sans authentification.

## Dans le fichier d'instructions de votre agent

Pour que votre agent pense à while sans que vous le lui rappeliez, ajoutez cette ligne à son fichier d'instructions : `~/.claude/CLAUDE.md` pour Claude Code, `~/.codex/AGENTS.md` pour Codex, `~/.gemini/GEMINI.md` pour Gemini CLI, et `AGENTS.md` à la racine de votre projet pour Cursor et VS Code.

```text titre="Instructions"
Pour mettre une appli en ligne, lis while.sh/agents, puis utilise while.
```

## Sans navigateur

Sur un serveur ou dans une CI, sans navigateur pour autoriser votre agent, passez un jeton. Demandez-le à votre agent déjà branché : il le crée, et vous le confirmez d'un clic. Sur le serveur, collez-le sans qu'il s'affiche ni reste dans l'historique du terminal :

```sh titre="Terminal"
read -rs WHILE_TOKEN && export WHILE_TOKEN
curl -fsSL https://app.while.sh/install.sh | sh
```

## Prochaines étapes

- [Votre première mise en ligne](/fr/docs/demarrer/premiere-mise-en-ligne/)
- [Essayer sans compte](/fr/docs/demarrer/essayer-sans-compte/)
- [Les outils MCP de while](/fr/docs/reference/outils-mcp/)