Private GitHub-Repos mit Token und Docker an Claude Desktop anbinden

Mit der richtigen Verbindung arbeitet Claude direkt mit Ihren GitHub-Repos: Branches auflisten, Pull Requests prüfen, die Commit-Historie lesen. Code in den Chat zu kopieren, ist dann nicht mehr nötig. Im Folgenden geht es darum, private Repos anzubinden, und um ein paar Möglichkeiten, die Verbindung sofort zu nutzen.

Was der GitHub-Connector macht

Stellen Sie sich den Connector als Brücke zwischen Ihrem GitHub-Konto und Claude vor. Sobald er läuft, kann Claude echte GitHub-Operationen auslösen, etwa Repos auflisten, Dateien lesen, Branches prüfen, Pull Requests öffnen und Review-Kommentare schreiben. Ihr GitHub-Passwort erreicht Claude nie. Verwendet wird nur ein Token, das Sie selbst erstellen, und Sie bestimmen, was dieses Token sehen darf.

Das Token erstellen

Die Einrichtung setzt auf ein Personal Access Token (Classic). Beide Token-Arten wurden ausprobiert: Fine-grained Tokens blockieren die GitHub Search API, klassische nicht. Wer vollen Zugriff möchte, fährt mit dem klassischen Token also sicher.

1. Öffnen Sie github.com und melden Sie sich an.
2. Klicken Sie oben rechts auf Ihr Profilbild, wählen Sie Settings, scrollen Sie im linken Menü ganz nach unten und klicken Sie auf Developer settings. Eine Abkürzung überspringt diesen und den nächsten Schritt: Rufen Sie direkt https://github.com/settings/tokens auf, dann öffnet sich die Seite mit den klassischen Tokens.
3. Klicken Sie im linken Menü auf Personal access tokens und dann auf Tokens (classic). Wählen Sie hier nicht „Fine-grained tokens“. Wenn Sie die Abkürzung genommen haben, sind Sie bereits auf dieser Seite.
4. Klicken Sie auf Generate new token und wählen Sie die klassische Variante. GitHub fragt eventuell nach Ihrem Passwort oder einem 2FA-Code.
5. Tragen Sie im Feld „Note“ etwas Wiedererkennbares ein, zum Beispiel claude-mcp-access, damit Sie später noch wissen, wozu das Token existiert.
6. Wählen Sie eine Laufzeit von 30, 60 oder 90 Tagen. Verzichten Sie ohne guten Grund auf „No expiration“, denn eine kurze Laufzeit begrenzt den Schaden, falls das Token abhandenkommt.
7. Wählen Sie die Scopes sorgfältig aus, denn auf diesen Schritt kommt es am meisten an.
8. Scrollen Sie nach unten, klicken Sie auf Generate token und kopieren Sie das Token.

Zu den Scopes: Sie legen fest, was Claude mit Ihren Repos tun darf. Setzen Sie nicht überall einen Haken, sondern nur dort, wo die Aufgabe es verlangt, und lesen Sie die Scope-Liste, bevor Sie etwas anklicken. Aktivieren Sie niemals delete_repo. Dieser Scope erlaubt das Löschen eines Repositorys, ein einziger falscher Befehl könnte ein ganzes Projekt auslöschen, und ein KI-Assistent hat so gut wie nie einen guten Grund, ihn zu besitzen. Als Faustregel gilt: Beginnen Sie mit dem engsten Scope, der für die Arbeit reicht. Braucht eine spätere Aufgabe mehr, können Sie jederzeit ein neues Token mit breiterem Zugriff erstellen.

Beim letzten Schritt zeigt GitHub das Token auf dem folgenden Bildschirm genau einmal an. Kopieren Sie es sofort und legen Sie es in einem Passwortmanager ab, denn sobald Sie die Seite verlassen, können Sie es nicht mehr einsehen.

Das Token mit Claude Desktop verbinden

Dieser Teil verbindet GitHub über Docker mit Claude Desktop. Gehen Sie die Schritte der Reihe nach durch und lassen Sie keinen aus.

1. Installieren Sie Docker Desktop von docker.com, falls noch nicht vorhanden, wie jede andere App auch.
2. Starten Sie Docker Desktop und warten Sie auf „Docker is running“, meist als grünes Symbol in der Menüleiste zu sehen. Das ist Pflicht, denn ohne laufendes Docker erreicht Claude GitHub nicht. Genau das zu vergessen, ist der häufigste Fehler. Prüfen Sie es also zuerst, wenn die Verbindung später nicht klappt.
3. Beenden Sie Claude Desktop vollständig, bevor Sie an der Konfiguration etwas ändern. Auf dem Mac geht das über das Claude-Symbol im Dock: Rechtsklick und Quit wählen. Nur das Fenster zu schließen, lässt die App weiterlaufen.
4. Suchen Sie die Konfigurationsdatei. Claude Desktop liest seine Einstellungen aus claude_desktop_config.json, die unter macOS unter ~/Library/Application Support/Claude/claude_desktop_config.json liegt. Um diesen versteckten Ordner zu öffnen, gehen Sie in den Finder, dann auf Go und Go to Folder und fügen den Pfad ein.
5. Öffnen Sie die Datei in einem einfachen Texteditor wie TextEdit oder VS Code, per Rechtsklick und Open With. Verwenden Sie kein Word und nichts, was Formatierung hinzufügt. Fehlt die Datei, legen Sie eine leere Datei mit genau diesem Namen in genau diesem Ordner an.
6. Fügen Sie den Block für den GitHub-MCP-Server auf der obersten Ebene des JSON ein. Ist die Datei leer, fügen Sie alles ein. Enthält sie schon etwas, führen Sie den Schlüssel mcpServers sorgfältig zusammen, denn zwei mcpServers-Schlüssel in einer Datei machen sie kaputt.

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

1. Suchen Sie in diesem Block your_pat_here und ersetzen Sie es durch das klassische Token aus Schritt 8. Lassen Sie die Anführungszeichen stehen und fügen Sie keine Leerzeichen hinzu.
2. Speichern Sie die Datei unter demselben Namen, am selben Ort und mit derselben Endung.
3. Prüfen Sie noch einmal das Docker-Symbol. Docker muss laufen, bevor Claude startet.
4. Starten Sie Claude Desktop. Die App liest die neue Konfiguration beim Start, und der erste Start kann ein paar Sekunden länger dauern, während Docker das Image des GitHub-MCP-Servers herunterlädt.
5. Testen Sie die Verbindung. Passiert nichts, prüfen Sie drei Dinge in dieser Reihenfolge: Docker Desktop läuft, das JSON enthält keine Tippfehler (meist ist ein fehlendes Komma schuld), und das Token wurde ohne überflüssige Leerzeichen eingefügt.

Was Sie ausprobieren können

• Pull-Request-Reviews. Bitten Sie Claude, sich einen offenen PR anzusehen. Es liest den Diff, markiert Bugs, unklare Namen und fehlende Tests und kann Kommentare direkt in GitHub hinterlassen, sodass das Team das Feedback an einer Stelle sieht.
• Branch-Audits. In großen Teams sammeln sich alte Branches an. Lassen Sie Claude alle Branches über Ihre Repos hinweg auflisten und die veralteten markieren, die sich gefahrlos löschen lassen.
• Workflow-Automatisierung. Claude kann einen Branch anlegen, einen kleinen Fix pushen und einen Pull Request öffnen. Aus einer Fleißarbeit mit fünf Handgriffen wird so ein einziger Satz.
• Issue-Triage. Claude kann offene Issues lesen, nach Priorität ordnen und Labels vorschlagen, was bei Repos mit großem Backlog hilft.
• Release Notes. Verweisen Sie auf die letzten Commits und gemergten PRs, und Claude erstellt ein sauberes Changelog für das nächste Release.
• Repo-übergreifende Suche. In einer Landschaft mit vielen Microservices kann Claude alle Repos gleichzeitig durchsuchen und jede Stelle finden, an der eine Funktion oder ein Konfigurationswert vorkommt, egal in welchem Projekt.

Sicherheits-Checkliste

• Scopes auf den Zweck abstimmen und delete_repo niemals aktivieren.
• Dem Token nur die Scopes geben, die es braucht.
• Ein Ablaufdatum setzen und Tokens regelmäßig erneuern.
• Tokens nicht in öffentliche Chats, Dateien öffentlicher Repositorys oder geteilte Dokumente stellen.
• claude_desktop_config.json aus der Versionskontrolle heraushalten, denn das Token steht darin im Klartext.
• Bei Verdacht auf ein Leck das Token sofort widerrufen.
• Docker Desktop aktuell halten, denn alte Versionen können Sicherheitslücken haben.

Danach sind Ihre privaten Repos angebunden, und Claude kann sie lesen, in ihnen arbeiten und dem Team helfen, schneller auszuliefern, ohne dass Sie den Chat verlassen.