Claude Desktop per MCP mit lokalen Projekten und GitHub verbinden

Code zwischen IDE und Chatfenster hin und her zu kopieren nervt schnell. Besser ist ein Assistent, der den Projektordner auf Ihrem Rechner öffnen, dort direkt Java-Testklassen bearbeiten oder hinzufügen und dann committen, pushen und einen Pull Request öffnen kann. Das kostet nichts, und möglich macht es MCP, das Model Context Protocol. Wer in die üblichen Fallen tappt, braucht ein paar Anläufe, deshalb stehen die Fehler unten direkt neben den Schritten.

Die Kopierschleife, die Sie loswerden wollen

Nehmen wir einen QA-Engineer, der den ganzen Tag Selenium-Skripte schreibt. Die Routine sieht so aus: eine Klasse aus VS Code, Eclipse oder IntelliJ kopieren, in den Chat einfügen, den Vorschlag lesen, wieder kopieren, zurück in die IDE einfügen. Dann zu GitHub wechseln und das Ergebnis von Hand hochladen oder pushen. Jeder Schritt ist manuell, und keiner davon braucht einen Menschen.

Stattdessen wollen Sie "Pushe diese Datei zu GitHub" tippen, und es passiert einfach.

Was MCP macht

MCP ist ein offener Standard von Anthropic. Er legt fest, wie ein Assistent wie Claude kontrolliert mit externen Tools, Apps und Datenquellen spricht. Ohne MCP sieht Claude nur, was Sie in den Chat tippen, wie jemand, der in einem Raum mit einem Schlitz in der Tür eingesperrt ist. MCP schneidet eine richtige Tür in diesen Raum, und für dieses Setup zählen zwei Arten von Türen:

• Ein Dateisystem-MCP-Server, mit dem Claude die Dateien auf Ihrem Rechner lesen kann.
• Ein Connector, mit dem Claude externe Dienste wie GitHub, Gmail oder Jira nutzen kann.

Sind beide eingerichtet, ist der Chat kein bloßes Textfeld mehr, sondern etwas, das handelt. Die Kette verläuft von Ihrer IDE über den Dateisystem-Server:

VSCode / Eclipse / IntelliJ
        │
        ▼
Filesystem MCP Server
        │
        ▼
Claude Desktop
        │
        ▼
GitHub MCP Server
        │
        ▼
GitHub Repository

Voraussetzungen

• Claude Desktop, die eigenständige App. claude.ai in einem Browser-Tab funktioniert dafür nicht, es klappt nur in der Desktop-Anwendung.
• Ein GitHub-Konto (kostenlos).
• Node.js, eine kostenlose Laufzeitumgebung, die bestimmte Tools zum Starten brauchen.
• Der absolute Pfad zum Stammordner Ihres Projekts, ganz gleich, welche IDE Sie nutzen.

Alles davon ist kostenlos, und der kostenlose Claude-Tarif reicht aus.

Schritt 1: Claude Ihren Projektordner geben

Dieser Teil erlaubt Claude, die Dateien etwa eines Eclipse-Workspaces direkt zu lesen und zu schreiben.

1. Installieren Sie Node.js von nodejs.org. Klicken Sie sich durch den Installer, es gibt nichts einzustellen.
2. Öffnen Sie in Claude Desktop Settings, dann Developer, dann Edit Config. Eine kleine Einstellungsdatei öffnet sich.
3. Fügen Sie das folgende Snippet ein und ersetzen Sie den Beispielordner durch Ihren eigenen Projektpfad. Unter Windows verdoppeln Sie jeden Backslash im Pfad.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\YourName\\eclipse-workspace\\YourProjectName"
      ]
    }
  }
}

1. Speichern Sie, beenden Sie Claude Desktop dann vollständig und starten Sie es neu. Das Fenster zu minimieren lädt nichts neu, die App muss wirklich beendet werden.
2. Suchen Sie neben dem Eingabefeld nach einem kleinen Hammer- oder Werkzeugsymbol. Ist es da, wurde der Dateisystem-Server geladen.

Schritt 2: GitHub anbinden

Hier geht fast alles schief, also gehen Sie es langsam an.

Eine eigene App bei GitHub registrieren

GitHub lässt nicht einfach irgendein Programm herein. Sie legen zuerst einen eigenen kleinen App-Eintrag an, und GitHub gibt Ihnen zwei Geheimnisse zurück, die Claude braucht.

1. Rufen Sie github.com/settings/applications/new auf.
2. Tragen Sie Claude als Anwendungsnamen ein, https://claude.ai als Homepage-URL und dasselbe https://claude.ai als Authorization Callback URL. Dieser Callback ist vorerst nur ein Platzhalter.
3. Klicken Sie auf Register application.
4. Kopieren Sie die angezeigte Client ID.
5. Klicken Sie auf Generate a new client secret und kopieren Sie es sofort. GitHub zeigt es genau einmal an.

Den Connector in Claude hinzufügen

1. Gehen Sie in Claude Desktop zu Settings, dann Connectors, klicken Sie auf das Pluszeichen und wählen Sie Add custom connector.
2. Nennen Sie ihn GitHub und verwenden Sie https://api.githubcopilot.com/mcp/ als URL.
3. Öffnen Sie Advanced settings und fügen Sie Client ID und Client Secret ein.
4. Klicken Sie auf Add und dann beim erscheinenden GitHub-Eintrag auf Connect.
5. GitHub fragt, ob der Zugriff erlaubt werden soll. Klicken Sie auf Authorize.

Beide Server in einem Chat nutzen

Sobald der Dateisystem-Server und GitHub beide als verbunden angezeigt werden, kann ein einziges Gespräch beide gemeinsam nutzen. Der Dateisystem-Server macht Ihren lokalen Workspace zugänglich, der GitHub-Server Ihre Repositories. Claude nimmt eine Datei von Ihrer Festplatte und pusht sie zu GitHub, ohne Einfügen und ohne Terminal.

In der Praxis deckt das die ganze Schleife ab:

• Den Inhalt Ihres Projekts durchsehen
• Bestehende Java-Dateien ändern
• Neue Testskripte schreiben
• Mit einer Nachricht committen
• Zum Remote pushen
• Pull Requests öffnen

Fehler, die Sie sich sparen können

• Eine leere Callback-URL. GitHub verlangt eine, daher scheitert die Registrierung so lange, bis Sie sie eintragen.
• Auf Add klicken, bevor das Client Secret existiert. Fehlen die Zugangsdaten, meldet Claude nur, dass es sich nicht beim Anmeldedienst registrieren konnte, und das sagt Ihnen gar nichts.
• In zwei verschiedenen Claude-Konten angemeldet sein, einem im Browser und einem in der Desktop-App. Das war das schlimmste der drei Probleme, denn der dadurch ausgelöste Fehler "Account mismatch" hat mit GitHub überhaupt nichts zu tun. Die Lösung: im Browser abmelden und mit dem Konto der Desktop-App wieder anmelden.

Prompts zum Kopieren

Diese funktionieren in Claude Desktop, sobald sowohl der Dateisystem- als auch der GitHub-Server aktiv sind. Zuerst eine vollständige Anfrage vom Stagen bis zum Pushen:

End-to-End Example
Stage all test classes under the com.myAutomation package, commit the changes with the commit message "updated", and push the latest commit to the master branch of the Autonation Project GitHub repository.

Und ein Git-Workflow mit Branch:

Git Workflow
Create a new branch named feature/login-automation, commit all modified files with the message "Added Login Automation Tests", and push the branch to the GitHub repository.

Ein kurzer Testlauf

Öffnen Sie Claude Desktop und gehen Sie diese Schritte der Reihe nach durch, jeder baut auf dem vorherigen auf.

1. Lokaler Zugriff: Bitten Sie es, Ihr Testautomatisierungsprojekt zu öffnen und die Struktur zu zeigen.
2. Dateiänderungen: Bitten Sie um eine Testklasse für die Login-Seite unter src/test/java.
3. Git: Bitten Sie es, ein Repository zu initialisieren, den Branch feature/login-test anzulegen und zu committen.
4. Push: Bitten Sie es, diesen Branch in das Repository Automation Testing Project zu pushen.
5. Pull Request: Bitten Sie es, einen Pull Request gegen den Branch develop zu öffnen.