# 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), puis 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 clavardage web de Gemini n'offre 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 qui passent par l'infonuagique ne sont pas pris en charge {#cloud-routed-clients-are-not-supported}

Les connecteurs de ChatGPT, le clavardage 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.