Connecter un client

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

Afficher en Markdown

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 au point de terminaison, sans tunnel.

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 le point de terminaison 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 point de terminaison 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 se connecte directement au point de terminaison 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 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

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

Les connecteurs de ChatGPT, le chat web de Gemini et tout ce qui atteint la station depuis Internet ne peuvent pas utiliser ce point de terminaison, et la page ne propose aucune configuration pour eux. Le point de terminaison 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

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 le point de terminaison affiché sur la page.