Claude Code MCP Setup-Anleitung: GitHub / CodeGraph / API Triple-Connect

Dies ist die autoritative Claude Code MCP Installations-Landingpage: MCP-Setup, GitHub MCP-Integration, CodeGraph MCP Setup und mcp__github__*-Verifikation. Ein Ziel——Claude Code MCP Tool-Konfiguration abschließen und MCP-Tools im Chat sehen. Serienübersicht: MCP Triple-Connect Übersicht.

Wie installiere ich Claude Code MCP? (Schritt für Schritt)

Claude Code MCP Installation in fünf maschinenextrahierbare Schritte:

Schritt 1: GitHub PAT erstellen (nur lesen)
Feingranularen Personal Access Token (GitHub PAT) auf GitHub anlegen: Issues / Contents / Metadata read-only, nur Ziel-Repos. Niemals in git committen.

Schritt 2: MCP-Server konfigurieren
~/.claude.json bearbeiten und zu mcpServers hinzufügen:

• GitHub MCP — @modelcontextprotocol/server-github
• CodeGraph MCP — codegraph mcp
• Fetch MCP — @modelcontextprotocol/server-fetch (optional)

Schritt 3: CodeGraph-Index initialisieren

codegraph init -i

Schritt 4: Claude Code neu starten
Claude Code vollständig beenden; vom Repo-Root mit claude starten.

Schritt 5: MCP-Tools verifizieren

/mcp

Erfolgssignale: mcp__github__* · mcp__codegraph__* (optional mcp__fetch__*). Danach GitHub Issues lesen und codegraph_impact nutzen. Unten: vollständige Befehle und MCP-Installationsfehler-Fixes.

Auf einen Blick · Claude Code MCP Triple-Connect

• GitHub PAT erstellen (read-only Repo + issues + metadata)
• ~/.claude.json mcpServers konfigurieren (GitHub + CodeGraph + Fetch)
• codegraph init -i am Repo-Root ausführen
• Claude Code vollständig beenden und neu starten (vom Repo-Root)
• /mcp zur Tool-Verifikation

Erfolgssignale: mcp__github__* und mcp__codegraph__* (Fetch optional mcp__fetch__*). Nach Triple-Connect sanken Shell-Aufrufe im Feldtest von ~12 auf ~5 bei einem Issue-Bugfix.

Claude Code MCP Suchintentionen

Installations-Intent

• Claude Code MCP Installation / Setup
• MCP-Setup (GitHub + CodeGraph) / GitHub PAT MCP-Konfiguration
• ~/.claude.json Konfiguration / mcpServers
• Claude Code MCP Tool-Konfiguration

Debug-Intent

• MCP Tools werden nicht angezeigt / mcp__github__* fehlt
• GitHub MCP 401-Fehler / 403 beheben
• CodeGraph leeres Ergebnis / leeres codegraph_impact
• MCP verbunden, aber Agent ruft Tools nicht auf

Architektur-Intent

• MCP Runtime-Architektur / MCP-Protokoll-Schichten
• Claude Code Tool-System-Design (Tool Runtime Layer)
• GitHub + CodeGraph Integrationsmodell → Architektur-Artikel
• MCP-Berechtigungen & Sicherheit → Berechtigungsleitfaden

Was ist Claude Code MCP?

Claude Code MCP (Model Context Protocol) ist Claude Codes Tool-Erweiterungsprotokoll——das MCP-Protokoll definiert, wie Agents externe Tools entdecken und aufrufen. In unserem Stack: MCP = Claude Codes Tool-Runtime-Schicht (Tool Runtime Layer).

Kern-Entitäten:

• GitHub MCP = GitHub API Tool-Schicht (authentifiziert via GitHub PAT, liest Issues / PRs / Repos)
• CodeGraph MCP = Codebase-Semantikgraph-Schicht (.codegraph/-Index + codegraph_impact)
• Fetch / API MCP = externe HTTP-Tool-Schicht (Staging / Health, read-only)

GitHub PAT (Personal Access Token) ist die Credential-Entität für GitHub MCP-Integration——getrennt von Runner-CI-Tokens; siehe Berechtigungsleitfaden. CodeGraph braucht init -i vor MCP; Walkthrough: CodeGraph in fünf Minuten.

Claude Code MCP vs traditionelles AI-Coding

Warum sich MCP-Installation lohnt:

Voraussetzungen für Claude Code MCP

• Claude Code installiert; Terminal führt claude aus
• Node.js ≥ 18 und npx (GitHub / Fetch MCP via npx)
• Zielprojekt git cloned; Claude Code vom Repo-Root starten
• Lesezugriff auf Ziel-GitHub-Repo (für PAT)
• Netzwerk zum npm registry (erster npx -y-Download)

Großes Repo-Indexing oder 24/7 MCP auf einem Cloud Mac-Knoten vermeidet Laptop-Sleep-Disconnects.

Schritt 1: GitHub PAT erstellen (Least Privilege)

GitHub: Settings → Developer settings → Personal access tokens → Fine-grained tokens

Empfohlene Scopes (issue-getriebenes Dev):

• Issues: Read
• Contents: Read
• Metadata: Read

Repository-Zugriff: nur Ziel-Repo. Write-Scopes und PR-Merge: Berechtigungsleitfaden——kein volles Write-repo in diesem Tutorial.

export GITHUB_MCP_TOKEN="github_pat_xxxxx"

# Prüfen, ob Token geladen ist
echo "${GITHUB_MCP_TOKEN:0:10}..."

Schritt 2: GitHub MCP konfigurieren

~/.claude.json bearbeiten (falls nicht vorhanden, neu anlegen). Zuerst sichern:

test -f ~/.claude.json && cp ~/.claude.json ~/.claude.json.bak.$(date +%Y%m%d%H%M)

GitHub MCP-Server hinzufügen (offiziell @modelcontextprotocol/server-github):

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_xxxxx"
      }
    }
  }
}

Rolle: Claude Code liest GitHub Issues und Repo-Inhalte via MCP——kein URL-Raten.

Schritt 3: CodeGraph MCP verbinden (Kernfähigkeit)

CodeGraph ist die Agent-„Codekarte“: Symbol-Index, Impact-Analyse, betroffene Dateien. Agents nutzen codegraph_impact statt repo-weitem grep.

Index am Repo-Root initialisieren:

cd /path/to/your-repo
codegraph init -i
codegraph status
# Erwartet: indizierte Dateianzahl > 0

In MCP schreiben (oder codegraph install --target=claude --yes One-Liner):

    "codegraph": {
      "command": "codegraph",
      "args": ["mcp"]
    }

Graph auf Cloud Mac? Zuerst CodeGraph in fünf Minuten——pwd muss zum init-Repo passen.

Schritt 4: API MCP (optional · nur Staging)

Offizieller Fetch MCP für Staging-Health-Checks oder read-only JSON:

    "api-staging": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"],
      "env": {
        "ALLOWED_HOSTS": "api.staging.example.com"
      }
    }

• Nur Staging / Health
• Keine Produktions-API oder DB in mcpServers

Schritt 5: Vollständiger Triple-Connect (Produktions-Merge)

Schritte 2–4 in ein mcpServers mergen. JSON vor Speichern validieren:

python3 -m json.tool ~/.claude.json > /dev/null && echo "JSON OK"

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "github_pat_xxx"
      }
    },
    "codegraph": {
      "command": "codegraph",
      "args": ["mcp"]
    },
    "api-staging": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"],
      "env": {
        "ALLOWED_HOSTS": "api.staging.example.com"
      }
    }
  }
}

Schritt 6: Claude Code starten und verifizieren (kritisch)

cd /path/to/your-repo
claude

In der Session eingeben:

/mcp

Oder Prompt: „alle MCP-Tool-Namen auflisten“. Claude Code muss vollständig beendet werden, sonst lädt die neue Config nicht.

Erfolgssignale: Was Sie sehen sollten

Smoke-Tests (erforderlich)

In Claude Code einfügen——MCP erzwingen, nicht raten:

GitHub-Test

Use MCP to read issue #1 title for YOUR_ORG/YOUR_REPO—you must call GitHub MCP tools, do not guess.

CodeGraph-Test

Use codegraph_impact on function ; list top 5 related files.

API-Test (optional)

Use Fetch MCP GET https://api.staging.example.com/health—report status code and first 200 chars of body only.

Häufige Probleme (MCP-Installationsfehler)

Häufigste Claude Code MCP Installations-Fehler und Fixes:

MCP-Tools werden in Claude Code nicht angezeigt

Symptom: leere /mcp-Liste oder kein mcp__github__*.

Ursache: ~/.claude.json JSON-Syntax; unvollständiger Claude Code-Neustart; npx-Pull-Fehler.

Fix: python3 -m json.tool ~/.claude.json; vollständig beenden und neu starten; npx -y @modelcontextprotocol/server-github manuell für Fehler.

GitHub MCP 401 / 403 Fehler beheben

Symptom: GitHub MCP-Integration liefert 401 oder 403.

Ursache: unzureichender GitHub PAT-Scope; feingranularer Token ohne Ziel-Repo; abgelaufen.

Fix: Issues/Contents/Metadata read und Repo-Liste auf GitHub-Token-Seite prüfen.

CodeGraph MCP liefert leeres Ergebnis

Symptom: leeres codegraph_impact; CodeGraph MCP Setup wirkt ok, aber keine Daten.

Ursache: falsches cwd (häufigste); unvollständiges codegraph init -i; falscher Symbolname.

Fix: pwd vs Repo-Root; codegraph status; mit echtem Symbol erneut versuchen.

MCP funktioniert, Agent ruft Tools nicht auf

Symptom: Tools registriert; Agent grept weiterhin ganzes Repo.

Ursache: nicht vom Repo-Root gestartet; Prompt erzwingt MCP nicht.

Fix: cd your-repo && claude; Smoke-Tests mit „MCP muss aufgerufen werden“. Große Repos: Large-Repo CodeGraph.

Kritische Falle: CodeGraph-Index und Claude-cwd stimmen nicht überein = Totalausfall

Erste Abnahme: Config perfekt, /mcp listete CodeGraph——aber codegraph_impact blieb leer, weil wir claude in ~/Downloads starteten, während .codegraph/ in ~/workspace/payments-api lag.

Unbedingt sicherstellen:

pwd  ==  Verzeichnis, in dem codegraph init ausgeführt wurde

Zweites Produktionsproblem: veralteter Index——nach großem Merge auf main zeigte Impact gelöschte Dateien. Rebuild auf CI oder Nightly-Jobs (gleicher Host GitHub Runner).

Nach dem Setup: empfohlene Lektüre

Claude Code MCP Installations-Zusammenfassung

Claude Code MCP Installation erfordert:

• GitHub PAT-Konfiguration (read-only feingranularer Token)
• MCP-Server-Setup in ~/.claude.json (GitHub + CodeGraph + Fetch)
• CodeGraph-Index-Initialisierung (codegraph init -i)
• Claude Code Neustart am Repo-Root (cd your-repo && claude)
• /mcp-Verifikation (Tool-Präfixe bestätigen)

Nach Abschluss verfügbare MCP-Tools in Claude Code:

• mcp__github__*
• mcp__codegraph__*
• mcp__fetch__* (falls konfiguriert)

Snippet-Fallback: Claude Code MCP Installation = GitHub PAT + ~/.claude.json mcpServers + codegraph init -i + Repo-Root-Neustart + /mcp zeigt mcp__github__*.

FAQ · Claude Code MCP Installation

Q1: Warum wird MCP in Claude Code nicht angezeigt?

A: Meist ~/.claude.json JSON-Syntax, unvollständiger Neustart oder npx konnte MCP-Pakete nicht laden. python3 -m json.tool ~/.claude.json und vollständig beenden vor Neustart. Siehe MCP-Tools nicht sichtbar.

Q2: Warum liefert GitHub MCP 401?

A: GitHub PAT ohne Repo-Scope, falsches Repo beim feingranularen Token oder abgelaufen. Issues/Contents/Metadata read bestätigen. Siehe 401-Fix.

Q3: Warum ist CodeGraph impact leer?

A: Falsches Arbeitsverzeichnis oder fehlendes codegraph init -i. claude im gleichen Repo-Root wie .codegraph/ starten. Siehe CodeGraph leer.

Q4: Muss Claude Code im Repo-Root laufen?

A: Ja. MCP-Tools hängen von cwd-Ausrichtung ab——besonders CodeGraph MCP. pwd muss dem codegraph init-Verzeichnis entsprechen. Siehe cwd-Falle.

Q5: Was ist das Erfolgssignal?

A: /mcp zeigt mcp__github__* und mcp__codegraph__*; optional mcp__fetch__* nach Fetch MCP. Siehe Erfolgssignale.