+180 XP

MCP-Server verbinden und nutzen

# MCP-Server verbinden und nutzen

Verbinden Sie Claude mit Ihrem GitHub-Account, und das Modell kann ein offenes Issue lesen, einen Fix entwerfen und einen Pull Request öffnen, ohne dass Sie den Chat verlassen. Diese Fähigkeit kommt von MCP-Servern. In dieser Lektion lernen Sie, wie Sie sie finden, anbinden und die lokale von der remote Variante unterscheiden.

Was ein MCP-Server tatsächlich ist

Sie kennen MCP (das Model Context Protocol) bereits als offenen Standard, über den Claude mit externen Tools spricht. Ein MCP-Server ist ein kleines Programm, das ein bestimmtes System (GitHub, Slack, eine Postgres-Datenbank, Ihr Dateisystem) als Sammlung von Tools und Ressourcen bereitstellt, die Claude aufrufen kann. Claude ist der Client, der Server ist das, womit er sich verbindet.

Das Protokoll wird offen unter modelcontextprotocol.io gepflegt, und die Spezifikation ist dieselbe, egal ob Sie Claude Code, die Desktop-App oder einen eigenen Agenten auf Basis des SDK verwenden. Genau darum geht es: einen Server einmal schreiben oder installieren und überall nutzen.

Es gibt zwei Varianten, und die richtige Wahl ist wichtiger als alles andere in dieser Lektion.

Lokale Server

Ein lokaler Server läuft auf Ihrer eigenen Maschine als Prozess, den Claude startet. Die Kommunikation läuft über stdio (Standard-Input/Output). Nutzen Sie diese Variante, wenn das Tool direkten Zugriff auf Ihre Hardware braucht: der Filesystem-Server, der lokale Ordner liest, oder ein Postgres-Server, der eine Datenbank auf localhost anspricht.

Lokale Server sind privat und schnell, existieren aber nur dort, wo Sie sie installiert haben. Sie folgen Ihnen nicht in die Mobile-App.

Remote-Server

Ein Remote-Server läuft im Internet, und Claude verbindet sich über HTTP mit ihm. Die offiziellen GitHub- und Slack-Server sind remote: Sie liegen unter einer URL, regeln ihre Authentifizierung selbst (meist OAuth) und funktionieren von jeder Claude-Oberfläche aus, auch im Web und in der Mobile-App.

In den Claude-Apps tauchen Remote-MCP-Server unter einem freundlicheren Namen auf: Connectors. Das Connector-Verzeichnis listet geprüfte Server, die Sie mit wenigen Klicks hinzufügen können. Einen eigenen Connector zu bauen heißt weiterhin, einen Remote-MCP-Server aufzusetzen; der Marketplace ist nur die kuratierte Eingangstür.

Eine einfache Regel: Wenn lokale Dateien im Spiel sind, nehmen Sie lokal. Handelt es sich um ein SaaS-Produkt mit Account, bevorzugen Sie den Remote-Connector.

Wo Sie Server finden

Drei verlässliche Quellen:

1. Das Connector-Verzeichnis in den Claude-Apps. Settings, dann Connectors. Das ist der schnellste Weg für GitHub, Google Drive, Slack und andere gängige Tools. Sie sind remote und werden verwaltet.

2. [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers), die offizielle Referenzsammlung. Filesystem, Fetch, Memory und weitere, überwiegend für den lokalen Betrieb gedacht.

3. Vendor-Repos. Viele Unternehmen liefern eigene Server aus. Der von GitHub liegt unter github.com/github/github-mcp-server und wird sowohl als Remote-Server als auch als lokales Docker-Image angeboten.

Meiden Sie beliebige Server von unbekannten Autoren. Ein MCP-Server läuft mit genau den Rechten, die Sie ihm geben. Behandeln Sie die Installation also wie die jeder anderen Software mit Zugriff auf Ihre Accounts.

Das konkrete Beispiel: GitHub hinzufügen

Geben wir Claude die Fähigkeit, Issues zu lesen und Pull Requests zu öffnen. Es gibt zwei Wege, je nachdem, wo Sie arbeiten.

Variante A: der GitHub-Connector (am einfachsten, remote)

Öffnen Sie in der Claude-Desktop- oder Web-App Settings, Connectors, suchen Sie GitHub und klicken Sie auf Verbinden. Sie landen auf dem OAuth-Screen von GitHub, autorisieren den Zugriff und wählen, welche Repositories Claude sehen darf. Fertig. Keine Konfigurationsdateien, keine Tokens zum Einfügen, und es funktioniert geräteübergreifend.

Für die meisten ist das die richtige Wahl. Jetzt können Sie prompten:

> „Lies Issue #214 in meinem Repo acme/web-app, fasse den Bug zusammen und öffne dann einen PR mit einem Fix auf einem neuen Branch.“

Claude ruft die Tools des GitHub-Servers auf (get_issue, create_branch, create_pull_request und so weiter), und da Sie jeden Schritt prüfen, wird nichts ohne Ihr Okay gemergt.

Variante B: lokale Konfiguration (für Claude Code und eigene Setups)

Wenn Sie in Claude Code arbeiten (Anthropics terminalbasiertem Coding-Agenten) oder einen eigenen Client verdrahten, konfigurieren Sie Server explizit. Claude Code liest MCP-Server aus einer JSON-Konfiguration. Hier der GitHub-Server, der lokal über Docker läuft und mit einem Personal Access Token authentifiziert wird:

json
{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PAT}"
      }
    }
  }
}

Ein paar Dinge, die auffallen sollten:

  • command und args sagen Claude, wie der Server gestartet wird. Hier wird das offizielle Docker-Image von GitHub gezogen und ausgeführt.
  • Das Token kommt aus einer Umgebungsvariable (${GITHUB_PAT}), es ist nicht fest einkodiert. Committen Sie niemals ein Token in eine Konfigurationsdatei, die in einem Repo liegt.
  • Das Flag -i hält stdin offen, und genau so bleiben stdio-Server mit dem Client im Gespräch.

Um denselben Server hinzuzufügen, ohne JSON von Hand zu bearbeiten, bietet Claude Code einen Befehl:

bash
claude mcp add github \
  --env GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PAT \
  -- docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Führen Sie danach claude mcp list aus, um die Verbindung zu bestätigen, und claude mcp get github, um sie zu prüfen.

Das Token eingrenzen

Wenn Sie das Personal Access Token auf GitHub erstellen, vergeben Sie nur das, was die Aufgabe braucht. Für das Lesen von Issues und das Öffnen von PRs sind das Repository Contents, Issues und Pull Requests, idealerweise als fein granuliertes Token, das auf die konkreten Repos beschränkt ist. Zu weit gefasste Tokens sind hier der häufigste Sicherheitsfehler. Der Server kann nur das, was das Token erlaubt, das Token ist also Ihre eigentliche Berechtigungsgrenze.

Die anderen gängigen Server hinzufügen

Das Muster wiederholt sich. Jeder Server ist nur ein anderes command und ein anderes Secret.

Filesystem (lokal). Erlaubt Claude, Dateien in von Ihnen benannten Ordnern zu lesen und zu schreiben. Sie übergeben die erlaubten Verzeichnisse als Argumente, was als harte Sandbox wirkt:

bash
claude mcp add filesystem \
  -- npx -y @modelcontextprotocol/server-filesystem \
  /Users/you/projects /Users/you/notes

Claude kann diese beiden Ordner anfassen und sonst nichts.

Postgres (lokal). Zeigen Sie auf einen Connection String, und Claude kann Schemas inspizieren und lesende Queries gegen Ihre Datenbank ausführen. Halten Sie das auf Ebene der Datenbankrolle read-only, sofern Sie Schreibzugriffe nicht wirklich wollen.

Slack (Remote-Connector). Über das Connector-Verzeichnis hinzufügen und per OAuth autorisieren. Claude kann dann Kanäle lesen und in Ihrem Namen Nachrichten posten.

Google Drive (Remote-Connector). Gleicher Ablauf. Einmal verbunden, kann Claude Dokumente suchen und als Kontext einbinden, was gut mit Projects zusammenspielt.

How to Set Up MCP Servers with Claude

Watch on YouTube

Prüfen, ob es funktioniert, und sicher bleiben

Machen Sie nach dem Verbinden einen kleinen Smoke-Test, bevor Sie Claude etwas Echtes anvertrauen. Fragen Sie direkt: „Auf welche GitHub-Tools hast du gerade Zugriff?“ Bei korrekt verbundenem Server listet Claude seine verfügbaren Tools auf. Sagt es, es habe keine, ist der Server nicht gestartet (prüfen Sie, ob Docker läuft, ob das Token gesetzt ist und ob die Konfiguration gültiges JSON ist).

Führen Sie dann einen harmlosen Lesevorgang aus: „Liste die drei zuletzt geöffneten Issues in acme/web-app.“ Erst lesen, dann schreiben. Wenn Sie dem Lesepfad trauen, lassen Sie es schreiben.

Zwei Sicherheitsgewohnheiten, die Sie sich angewöhnen sollten:

  • Aktionen freigeben, nicht blind automatisieren. Claude fragt standardmäßig vor jedem Tool-Aufruf nach. Lassen Sie das für alles an, was schreibt (PRs öffnen, in Slack posten, Dateien ändern). Auto-Freigabe ist für vertrauenswürdige Read-only-Server in Ordnung.
  • Ein Token, eine Aufgabe. Nutzen Sie pro Server getrennte, eng begrenzte Credentials. Wenn ein Token durchsickert, bleibt der Blast Radius klein.

Wissenscheck

1. Wie ist in der beschriebenen MCP-Architektur das Verhältnis zwischen Claude und einem MCP-Server?

2. Sie wollen, dass Claude Dateien in einem Ordner auf Ihrem eigenen Rechner liest und ordnet. Welchen Servertyp sollten Sie nutzen und warum?

3. Worauf bezieht sich der Begriff „Connectors“ in den Claude-Apps?

MEHRFACHAUSWAHL

4. Wählen Sie ALLE korrekten Aussagen über Remote-MCP-Server.

Wählen Sie alle richtigen Antworten aus.

MEHRFACHAUSWAHL

5. Wählen Sie ALLE Aussagen, die lokale MCP-Server korrekt beschreiben.

Wählen Sie alle richtigen Antworten aus.

Lokal versus remote: die Wahl in der Praxis

Jetzt, wo Sie beides gesehen haben, so sieht die Entscheidung in einem echten Projekt aus.

Angenommen, Sie bauen ein Feature und wollen, dass Claude Code einen Bug von Anfang bis Ende behebt. Dann laufen bei Ihnen wahrscheinlich zwei Server gleichzeitig: der GitHub-Server (remote oder lokal), um das Issue zu lesen und den PR zu öffnen, und der Filesystem-Server (lokal), damit Claude den tatsächlichen Code auf Ihrer Maschine lesen und bearbeiten kann. MCP-Server lassen sich kombinieren. Claude sieht das gemeinsame Toolset und orchestriert in einer einzigen Konversation darüber hinweg.

Dem gegenüber steht ein Teamkollege in der Mobile-App, der auf dem Arbeitsweg nur eine Zusammenfassung der GitHub-Issues dieser Woche will. Er braucht den Remote-Connector und sonst nichts, denn in seiner Hosentasche läuft kein lokaler Docker-Container.

Gleiches Protokoll, unterschiedliches Deployment, allein bestimmt davon, wo die Arbeit stattfindet und worauf sie zugreifen muss.

Server in der API und im Agent SDK

Das beschränkt sich nicht auf die Chat-Apps. Die Anthropic Messages API unterstützt Remote-MCP-Server über ihr MCP-Connector-Feature, sodass ein von Ihnen gebauter Backend-Service Claude denselben GitHub- oder Slack-Zugriff programmatisch geben kann. Das Claude Agent SDK geht weiter: Es ist das Toolkit, um Agenten zu bauen, die ihre eigenen MCP-Verbindungen verwalten, Tool-Loops ausführen und die Orchestrierung übernehmen, die Sie sonst von Hand machen würden.

Das mentale Modell bleibt überall identisch. Sie verbinden einen Server, Claude entdeckt dessen Tools und ruft sie bei Bedarf auf. Die Referenzdokumentation zum Anbinden von Servern über die verschiedenen Oberflächen liegt unter docs.claude.com und ist die Source of Truth, wenn sich ein Flag oder ein Ablauf ändert.

Eine Anmerkung zu Skills versus Connectors

Das wird leicht verwechselt, also ziehen wir die Linie klar. Ein Connector (MCP-Server) gibt Claude Zugriff auf ein aktives externes System: Es kann GitHub jetzt sofort aufrufen. Ein Skill bündelt Anweisungen und Ressourcen, die prägen, *wie* Claude eine Aufgabe erledigt, etwa als wiederverwendbares Playbook für PR-Beschreibungen im Format Ihres Teams. Skills sagen Claude, wie es sich verhalten soll; Connectors geben ihm etwas, worauf es handeln kann. Die leistungsfähigsten Setups nutzen beides: einen Skill, der Ihre PR-Konventionen definiert, über einem GitHub-Connector, der das eigentliche Öffnen erledigt.

Die wichtigsten Erkenntnisse

  • Wählen Sie lokal oder remote danach, worauf die Arbeit zugreift. Lokale stdio-Server für Dateisysteme und lokale Datenbanken; Remote-Connectors für SaaS-Tools und alles, was Sie mobil brauchen.
  • Für GitHub starten Sie mit dem Connector unter Settings, Connectors. Greifen Sie erst dann zur JSON-Konfiguration (Docker-Image plus Token aus einer Umgebungsvariable), wenn Sie in Claude Code arbeiten oder einen eigenen Client bauen.
  • Das Token ist die Berechtigungsgrenze. Erstellen Sie fein granulierte, auf Repos beschränkte Credentials für genau einen Zweck und kodieren Sie sie nie fest in committeter Konfiguration.
  • Testen Sie Lesevorgänge vor Schreibvorgängen und lassen Sie Tool-Freigaben an für alles, was Zustand verändert.
  • Kombinieren Sie Server und paaren Sie sie mit Skills. GitHub plus Filesystem gemeinsam laufen zu lassen, erlaubt Claude, einen Bug durchgängig zu beheben; ein Skill obendrauf sorgt dafür, dass es auf die Art Ihres Teams passiert.

Was Sie aus dieser Lektion umsetzen

Diese Maßnahmen sind im Playbook der Rolle zusammengefasst.

  • Tool-Docstrings und Type Hints für das Routing des Modells schreiben
  • Jede Remote-MCP-Abfrage auf die authentifizierte Identität eingrenzen
Vollständiges Action Playbook ansehen

Verwandte Artikel

Aktuelle Blogartikel, die auf dieser Lektion aufbauen.