+180 XP

Claude · MCP-Server verbinden und nutzen

Verbinden Sie Claude mit Ihrem GitHub-Konto, und Claude 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, und in dieser Lektion lernen Sie, wie Sie sie finden, verbinden und den Unterschied zwischen lokalen und remote Varianten erkennen.

Was ein MCP-Server wirklich 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 Satz 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, ob Sie Claude Code, die Desktop-App oder Ihren eigenen Agenten auf Basis des SDK nutzen. Genau darum geht es: einen Server einmal schreiben oder installieren, überall verwenden.

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

Lokale Server

Ein lokaler Server läuft auf Ihrem eigenen Rechner als Prozess, den Claude startet. Die Kommunikation läuft über stdio (Standard-Input/Output). Nutzen Sie diese, 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, aber sie existieren 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 (in der Regel OAuth) und funktionieren von jeder Claude-Oberfläche aus, einschließlich Web- und Mobile-App.

In den Claude-Apps erscheinen Remote-MCP-Server unter einem freundlicheren Namen: Connectors. Das Connector-Directory listet geprüfte Server auf, die Sie mit wenigen Klicks hinzufügen können. Einen eigenen Connector zu bauen bedeutet 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. Wenn es ein SaaS-Produkt mit Account ist, bevorzugen Sie den Remote-Connector.

Wo Sie Server finden

Drei verlässliche Quellen:

  1. Das Connector-Directory in den Claude-Apps. Settings, dann Connectors. Das ist der schnellste Weg für GitHub, Google Drive, Slack und andere verbreitete 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, meist 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.

Vermeiden Sie beliebige Server von unbekannten Autoren. Ein MCP-Server läuft mit den Berechtigungen, die Sie ihm geben, behandeln Sie die Installation also wie die Installation 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.

Option 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 werden auf den OAuth-Screen von GitHub geleitet, um den Zugriff zu autorisieren und auszuwählen, welche Repositories Claude sehen darf. Fertig. Keine Config-Dateien, keine Tokens zum Einfügen, und es funktioniert auf allen Ihren Geräten.

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 weil Sie jeden Schritt prüfen, wird nichts ohne Ihre Zustimmung gemergt.

Option B: lokale Config (für Claude Code und eigene Setups)

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

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 sind bemerkenswert:

  • command und args sagen Claude, wie der Server gestartet wird. Hier zieht und startet er das offizielle Docker-Image von GitHub.
  • Das Token kommt aus einer Umgebungsvariable (${GITHUB_PAT}), nicht hardcodiert. Committen Sie ein Token nie in eine Config-Datei, die in einem Repo liegt.
  • Das Flag -i hält stdin offen, so bleiben stdio-Server mit dem Client im Gespräch.

Um denselben Server hinzuzufügen, ohne JSON per 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 inspizieren.

Das Token eingrenzen

Wenn Sie das Personal Access Token auf GitHub erstellen, geben Sie nur frei, 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 fine-grained Token, begrenzt auf die betreffenden Repos. Zu breite Tokens sind hier der häufigste Sicherheitsfehler. Der Server kann nur, 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 kommt an diese zwei Ordner und an nichts anderes.

Postgres (lokal). Geben Sie einen Connection String an, und Claude kann Schemas inspizieren und Lesequeries gegen Ihre Datenbank fahren. Halten Sie es auf Ebene der Datenbankrolle read-only, es sei denn, Sie wollen Schreibzugriff wirklich.

Slack (Remote-Connector). Über das Connector-Directory hinzufügen und mit OAuth autorisieren. Claude kann dann Channels lesen und in Ihrem Namen Nachrichten posten.

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

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 die 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, ob die Config valides JSON ist).

Führen Sie dann einen harmlosen Lesezugriff aus: „Liste die drei zuletzt geöffneten Issues in acme/web-app.“ Lesen vor Schreiben. Wenn Sie dem Lesepfad vertrauen, lassen Sie Claude schreiben.

Zwei Sicherheitsgewohnheiten, die Sie festlegen sollten:

  • Aktionen freigeben, nicht blind automatisieren. Claude fragt standardmäßig vor jedem Tool-Aufruf. Lassen Sie das für alles an, was schreibt (PRs öffnen, in Slack posten, Dateien ändern). Auto-Freigabe ist in Ordnung für read-only Server, denen Sie vertrauen.
  • Ein Token, eine Aufgabe. Nutzen Sie getrennte, eng gefasste Credentials pro Server. Leakt ein Token, bleibt der Schadensradius klein.

Wissenscheck

1. Was 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 organisiert. Welchen Servertyp sollten Sie nutzen und warum?

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

MEHRFACHAUSWAHL

4. Wählen Sie ALLE korrekten Aussagen zu Remote-MCP-Servern.

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

Sie haben nun beides gesehen, hier also, wie die Entscheidung in einem echten Projekt tatsächlich aussieht.

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

Dem gegenüber steht ein Teamkollege in der Mobile-App, der nur will, dass Claude ihm auf dem Weg zur Arbeit die GitHub-Issues dieser Woche zusammenfasst. Er will den Remote-Connector und nichts sonst, denn ein lokaler Docker-Container läuft nicht in seiner Tasche.

Dasselbe Protokoll, unterschiedliches Deployment, bestimmt allein davon, wo die Arbeit passiert und was sie berühren muss.

Server in der API und im Agent SDK

Das ist nicht auf die Chat-Apps begrenzt. Die Anthropic Messages API unterstützt Remote-MCP-Server über ihr MCP-Connector-Feature, ein von Ihnen gebauter Backend-Service kann Claude also programmatisch denselben GitHub- oder Slack-Zugriff geben. 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 per Hand machen würden.

Das mentale Modell bleibt überall identisch. Sie verbinden einen Server, Claude entdeckt seine 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 Quelle der Wahrheit, wenn sich ein Flag oder ein Ablauf ändert.

Eine Anmerkung zu Skills versus Connectors

Die beiden werden leicht verwechselt, ziehen Sie die Linie also klar. Ein Connector (MCP-Server) gibt Claude Zugriff auf ein lebendes externes System: es kann GitHub jetzt aufrufen. Ein Skill verpackt Anweisungen und Ressourcen, die formen, *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: ein Skill, das Ihre PR-Konventionen definiert, laufend über einem GitHub-Connector, der das eigentliche Öffnen übernimmt.

Wichtigste Erkenntnisse

  • Wählen Sie lokal oder remote danach, was die Arbeit berührt. 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-Config (Docker-Image plus Token aus Umgebungsvariable), wenn Sie in Claude Code arbeiten oder Ihren eigenen Client bauen.
  • Das Token ist die Berechtigungsgrenze. Erstellen Sie fine-grained, auf Repos begrenzte Credentials für einen einzigen Zweck und hardcoden Sie sie nie in committete Configs.
  • Testen Sie Lesezugriffe vor Schreibzugriffen 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 von Anfang bis Ende zu beheben; ein Skill darüber sorgt dafür, dass es nach Art Ihres Teams geschieht.

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.