MCP · Lektion 06 · Anbinden

Den Server an einen Agent anbinden

Der Server aus Lektion 5 läuft im Inspector. Jetzt wird er zum Werkzeug eines echten Agents. Das ist der Punkt, an dem deine Mission „Klick“ macht.

Dein Gewinn: Du bindest deinen Python-Server an Claude Code an (schnellste Schleife), rufst sein Tool im Chat auf — und verstehst das .mcp.json-Format gut genug, um es auf jeden anderen Host zu übertragen.

1. Das mentale Modell (Wiederholung)

Anbinden heißt: dem Host sagen, wie er deinen Server starten/erreichen soll. Der Host erzeugt dann intern den Client und fährt den Handshake aus Lektion 2. Du lieferst nur das „Rezept zum Starten“.

2. Variante A — Claude Code per CLI (am schnellsten)

Für einen lokalen STDIO-Server gibst du Name und Startkommando an. Alles nach -- ist das Kommando, das den Server startet:¹

claude mcp add demo -- uv run /pfad/zu/mcp-demo/server.py

Prüfen und inspizieren:

claude mcp list          # alle Server + Status
claude mcp get demo      # Details zu „demo“

Danach im Chat: „Nutze das add-Tool, um 21 und 21 zu addieren.“ Claude ruft dein Tool auf. Geschafft — dein Code ist jetzt Teil eines Agents.

3. Variante B — `.mcp.json` (teilbar im Repo)

Für einen Workshop ideal: eine Datei .mcp.json im Projekt-Root, die jeder Teilnehmer eincheckt. Genau dieses Format nutzt auch dein forgejo-Server:¹

{
  "mcpServers": {
    "demo": {
      "command": "uv",
      "args": ["run", "/pfad/zu/mcp-demo/server.py"]
    }
  }
}

Für einen Remote-Server (Streamable HTTP aus Lektion 4) stattdessen:

claude mcp add --transport http demo https://example.com/mcp

bzw. in .mcp.json mit "type": "http" (Alias "streamable-http") und "url".¹

4. Scopes — wer sieht den Server?

--scope local — nur du, nur dieses Projekt (Default).
--scope project — landet in .mcp.json, geteilt mit dem Team.
--scope user — du, über alle Projekte hinweg.

Für deinen Workshop: project, damit alle Teilnehmer denselben Server bekommen, sobald sie das Repo klonen.¹

5. Andere Hosts — dasselbe Prinzip

Cursor, Windsurf, Zed, die Claude-Desktop-App und auch die GitLab Duo Agent Platform sind alle MCP-Hosts. Sie unterscheiden sich nur im Ort der Konfig (eigene JSON-Datei oder UI), nicht im Konzept: Name + Startkommando (STDIO) oder URL (HTTP). Wer das .mcp.json-Schema verstanden hat, findet sich überall zurecht.

Workshop-Demo-Tipp: zeig denselben Server nacheinander im Inspector und in Claude Code. Das beweist die Kern-These aus Lektion 1 — einmal bauen, überall andocken (N+M statt N×M).

6. Mini-Check (aus dem Kopf!)

Was steht hinter dem -- bei claude mcp add?

Welcher Scope teilt den Server mit dem Team via Repo?

Was tut der Host beim Anbinden mit deinem „Start-Rezept“?

7. Primärquelle

📖 Claude Code — Connect to tools via MCP. Vollständige Referenz zu claude mcp add, Scopes und .mcp.json. Für Duo: in docs.gitlab.com nach „MCP“ im Duo-Agent-Kontext suchen (ändert sich schnell — live prüfen).

Frag mich: „Hilf mir, meinen echten Server in diese Session einzubinden“ — wir können das hier direkt machen und live testen. Sag „weiter“ für Lektion 7 (Capstone: vom Spielzeug zum echten Server + Workshop-Dramaturgie).

1 — Claude Code Docs, MCP: code.claude.com/docs/en/mcp