# Connecter un client

> Une configuration prête à copier pour Claude, Codex, Gemini CLI, GitHub Copilot et tout autre client MCP.

La carte **Connecter un client** vous guide client par client, avec des extraits prêts à
copier qui portent déjà le port que vous avez configuré (les exemples ci-dessous utilisent
la valeur par défaut, 18181). Tous les clients locaux se connectent directement à l'endpoint, sans tunnel.

## Claude {#claude}

Claude Chat (application de bureau) et Claude Code (ligne de commande et application de
bureau) se configurent séparément ; connecter l'un ne connecte pas l'autre.

- **Claude Chat (application de bureau)** : le chemin le plus simple. Le **paquet MCP
  (`.mcpb`)** en un clic est livré avec l'application : appuyez sur **Installer dans Claude
  Desktop** (ou sur **Enregistrer sous…** pour conserver le fichier) et confirmez la boîte
  de dialogue d'installation dans Claude Desktop. Le paquet porte une petite passerelle
  locale entre le transport stdio de Claude et l'endpoint HTTP de cette
  station ; le runtime Node dont elle a besoin est fourni avec Claude Desktop. Si vous avez
  changé le port, indiquez le même endpoint dans la boîte de dialogue
  d'installation.
- **Claude Code (ligne de commande et application de bureau)** : une seule commande dans un
  terminal :

```
claude mcp add --transport http ganterlab http://127.0.0.1:18181/mcp
```

## Codex (CLI / IDE) {#codex-cli--ide}

Codex se connecte directement à l'endpoint de la boucle locale comme à un serveur
Streamable HTTP. Sa commande `codex mcp add` ne couvre que les serveurs stdio, donc la forme
HTTP s'écrit dans `~/.codex/config.toml` :

```
[mcp_servers.ganterlab]
url = "http://127.0.0.1:18181/mcp"
```

## Gemini CLI {#gemini-cli}

Gemini CLI se connecte par son type de serveur `httpUrl`, dans `~/.gemini/settings.json`.
(Le chat web de Gemini n'a aucun chemin local sans tunnel, donc seule la ligne de commande
est proposée.)

```
{
  "mcpServers": {
    "ganterlab": {
      "httpUrl": "http://127.0.0.1:18181/mcp"
    }
  }
}
```

## GitHub Copilot {#github-copilot}

Deux chemins, avec deux clés de premier niveau différentes :

- **VS Code** : ajoutez le serveur à `.vscode/mcp.json` (ou lancez « MCP: Open User
  Configuration » depuis la palette de commandes), puis activez-le dans le sélecteur
  d'outils de Copilot Chat :

```
{
  "servers": {
    "ganterlab": {
      "type": "http",
      "url": "http://127.0.0.1:18181/mcp"
    }
  }
}
```

- **Ligne de commande** : la même forme de serveur sous `mcpServers` dans
  `~/.copilot/mcp-config.json` (ou lancez `/mcp add` dans la ligne de commande et choisissez
  le type de serveur HTTP).

## Les clients passant par le cloud ne sont pas pris en charge {#cloud-routed-clients-are-not-supported}

Les connecteurs de ChatGPT, le chat web de Gemini et tout ce qui atteint la station depuis
Internet ne peuvent pas utiliser cet endpoint, et la page ne propose aucune
configuration pour eux. L'endpoint refuse toute requête dont l'en-tête `Host`
n'est pas local, avant même la poignée de main de la session : un tunnel n'y change rien,
car un tunnel transmet son propre hôte public, qui est précisément ce qui est refusé. La
station n'est pas publiée sur le réseau pour les agents, et aucun interrupteur ne la publie.

## Tout autre client MCP {#any-other-mcp-client}

Tout client qui s'exécute sur cet ordinateur et qui accepte l'URL d'un serveur MCP en HTTP
peut utiliser la station : pointez-le vers l'endpoint affiché sur la page.