# Einen Client verbinden

> Fertige Einrichtung zum Kopieren für Claude, Codex, Gemini CLI, GitHub Copilot und jeden anderen MCP-Client.

Die Karte **Einen Client verbinden** führt Sie durch jeden unterstützten Client, mit Beispielen
zum Kopieren, die Ihren eingestellten Port bereits enthalten (die Beispiele unten
verwenden den Standardwert 18181). Alle lokalen Clients verbinden sich direkt mit dem
Endpunkt, ohne Tunnel.

## Claude {#claude}

Claude Chat (Desktop App) und Claude Code (CLI/Desktop App) werden getrennt eingerichtet;
wer das eine verbindet, verbindet das andere nicht.

- **Claude Chat (Desktop App)**: der einfachste Weg. Das **MCP-Paket (`.mcpb`)** für einen
  Klick liegt der Anwendung bei: Drücken Sie **In Claude Desktop installieren** (oder
  **Speichern unter…**, um die Datei zu behalten) und bestätigen Sie den
  Installationsdialog in Claude Desktop. Das Paket enthält eine kleine lokale Brücke vom
  stdio-Transport von Claude zum HTTP-Endpunkt dieser Station; die dafür nötige
  Node-Laufzeit bringt Claude Desktop mit. Wenn Sie den Port geändert haben, tragen Sie im
  Installationsdialog den passenden Endpunkt ein.
- **Claude Code (CLI/Desktop App)**: ein einziger Befehl im Terminal:

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

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

Codex verbindet sich direkt als Streamable-HTTP-Server mit dem Loopback-Endpunkt. Sein
Befehl `codex mcp add` deckt nur stdio-Server ab, deshalb steht die HTTP-Form in
`~/.codex/config.toml`:

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

## Gemini CLI {#gemini-cli}

Die Gemini CLI verbindet sich über ihren Servertyp `httpUrl` in `~/.gemini/settings.json`.
(Der Gemini-Webchat hat keinen lokalen Weg ohne Tunnel, deshalb wird nur die CLI
angeboten.)

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

## GitHub Copilot {#github-copilot}

Zwei Wege, mit zwei verschiedenen Schlüsseln auf oberster Ebene:

- **VS Code**: Tragen Sie den Server in `.vscode/mcp.json` ein (oder führen Sie "MCP: Open
  User Configuration" aus der Befehlspalette aus) und geben Sie ihn dann in der
  Werkzeugauswahl von Copilot Chat frei:

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

- **CLI**: dieselbe Serverform unter `mcpServers` in `~/.copilot/mcp-config.json` (oder
  führen Sie in der CLI `/mcp add` aus und wählen Sie den HTTP-Servertyp).

## Über die Cloud geführte Clients werden nicht unterstützt {#cloud-routed-clients-are-not-supported}

Die Connectors von ChatGPT, der Gemini-Webchat und alles andere, was die Station aus dem
Internet erreicht, können diesen Endpunkt nicht verwenden, und die Seite bietet dafür keine
Einrichtung an. Der Endpunkt weist jede Anfrage ab, deren Kopfzeile `Host` nicht lokal ist,
und zwar noch vor dem Aufbau der Sitzung; ein Tunnel hilft also nicht: Ein Tunnel leitet
seinen eigenen öffentlichen Host weiter, und genau der wird abgewiesen. Die Station wird
für Agenten nicht im Netzwerk veröffentlicht, und es gibt keinen Schalter, der das ändert.

## Ein beliebiger anderer MCP-Client {#any-other-mcp-client}

Jeder Client, der auf diesem Rechner läuft und die URL eines HTTP-MCP-Servers annimmt, kann
die Station verwenden: Richten Sie ihn auf den Endpunkt, den die Seite anzeigt.