CodeGraph MCP auf Cloud Mac einrichten – Anleitung in 5 Minuten

Bei codegraph init in großen Repos dreht meist zuerst der Laptop-Lüfter. Schneller: CodeGraph und MCP auf Cloud Mac — per SSH ein paar Befehle; lokal arbeiten Claude Code und Cursor weiter, ohne lokales CodeGraph und ohne Vollindex.

Kürzester Pfad: ssh root@zavcloud → brew install → codegraph init. Wer CodeGraph für AI-Coding kennt, bekommt hier nur welche Maschine und Livegang in fünf Minuten.

Warum CodeGraph MCP auf Cloud Mac?

CodeGraph legt .codegraph/ an; erstes init -i belastet CPU/NVMe. Auf ZavCloud Cloud Mac:

• Gleiches macOS wie xcodebuild und GitHub Actions Runner;
• Entwickler brauchen nur SSH;
• Always-on-Knoten indexiert nachts — tagsüber read-only.

Voraussetzungen

• Aktiver Cloud Mac;
• Lokales Terminal;
• Code auf der Instanz;
• Optional Claude Code / Cursor für MCP-Test.

Schritt 1: SSH auf Cloud Mac

Adresse aus der Konsole kopieren und als root einloggen:

# Example: replace zavcloud with your instance IP or hostname
ssh root@zavcloud

# Key-based login (recommended)
ssh -i ~/.ssh/id_ed25519 root@203.0.113.10

Beim ersten Mal yes für den Host-Key. Prompt = Remote-macOS — alles Weitere läuft dort, nicht auf dem Laptop.

Schritt 2: brew install CodeGraph

Native macOS mit Homebrew — Node und CLI installieren:

# Confirm Homebrew
brew --version

# Install Node if needed
brew install node

# Install CodeGraph CLI
npm install -g @colbymchenry/codegraph
codegraph --version

Offizielles install.sh in derselben SSH-Session geht auch:

curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

Schritt 3: codegraph init

Am Repo-Root für Agents initialisieren und voll indexieren:

cd ~/workspace/your-monorepo
git pull

# Init + index (first run may take 10–40 min)
codegraph init -i

# Confirm database
codegraph status
ls -la .codegraph/

tmux gegen SSH-Abbruch. .codegraph/codegraph.db bleibt auf Cloud Mac.

Schritt 4: MCP deployen

MCP auf Cloud Mac (codegraph serve --mcp):

codegraph install --target=claude,cursor --yes

# Foreground MCP (debug)
codegraph serve --mcp

Kein zweites install lokal.

• Remote auf Cloud Mac: gleiche .codegraph;
• Lokaler Agent + Cloud-Graph via ssh -L — kein lokales init.

Checkliste (5 Min.)

FAQ & Fehlerbehebung

Nach Ticket-Häufigkeit — Symptom, Schritte, Erfolgskriterium. SSH auf Cloud Mac, Repo z. B. unter ~/workspace/your-repo.

SSH schlägt fehl: ssh root@zavcloud Timeout oder Permission denied

Symptom: Connection timed out, Permission denied (publickey) oder Abbruch nach dem Host-Key-Prompt.

Schritte:

1. zavcloud durch die öffentliche IP aus der Konsole ersetzen (z. B. ssh root@203.0.113.10). Unaufgelöste Hostnamen → Timeout.
2. Lokal Schlüsselrechte prüfen:
   Lokal

   chmod 600 ~/.ssh/id_ed25519
   ssh -v -i ~/.ssh/id_ed25519 root@YOUR_IP

   In -v: Offering public key vs. no mutual signature — letzteres oft ungebundener Key.
3. IP erreichbar, Passwort abgelehnt: Cloud Mac nutzt meist Key-Login. Key in der Konsole resetten oder per VNC „Remote Login“ prüfen.
4. Port 22 im Firmennetz blockiert: Hotspot testen; statische IPv4 bei Dedicated-Instanzen erleichtert Whitelisting.

Fertig wenn: Stabile Shell; uname -a zeigt Darwin (macOS).

brew install oder codegraph: command not found

Symptom: brew: command not found oder nach npm i -g kein codegraph --version.

Schritte:

1. Homebrew-Pfad (Apple Silicon):
   Cloud Mac

   test -x /opt/homebrew/bin/brew && eval "$(/opt/homebrew/bin/brew shellenv)"
   brew --version

   Ohne brew: Homebrew installieren oder install.sh.
2. Global npm bin in PATH:
   Cloud Mac

   npm config get prefix
   export PATH="$(npm config get prefix)/bin:$PATH"
   which codegraph
   codegraph --version

   export PATH=... in ~/.zshrc persistieren.
3. Fallback:
   Alternative

   curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
   exec $SHELL -l

Fertig wenn: which codegraph liefert Pfad; codegraph --version zeigt Version.

codegraph init -i hängt oder bricht bei SSH-Abbruch ab

Symptom: Lange keine Ausgabe; nach Disconnect codegraph status unindexiert oder DB kaputt.

Schritte:

1. Indexierung immer in tmux:
   Cloud Mac · empfohlen

   brew install tmux
   tmux new -s codegraph
   cd ~/workspace/your-repo && codegraph init -i
   # After reconnect:
   tmux attach -t codegraph

2. Speicherplatz:

   df -h .
   du -sh .codegraph 2>/dev/null

3. Bei DB-Korruption: .codegraph/ am Repo-Root sichern, löschen, codegraph init -i neu (nicht während Lauf löschen).
4. Große Monorepos: .codegraphignore — zu viel Ausschluss → impact-Lücken.

Fertig wenn: codegraph status Dateien > 0; .codegraph/codegraph.db vorhanden.

Claude Code / Cursor: keine CodeGraph-MCP-Tools

Symptom: Kein codegraph in der MCP-Liste; Agent greift nur auf Grep zurück.

Schritte:

1. Auf dem Cloud Mac MCP neu schreiben:

   codegraph install --target=claude,cursor --yes
   grep -A6 codegraph ~/.claude.json 2>/dev/null || cat ~/.claude.json

   "command": "codegraph" und serve --mcp prüfen.
2. Claude Code / Cursor vollständig beenden und neu starten.
3. Lokaler Agent + Cloud-Graph:
   Lokal ~/.claude.json

   {
     "mcpServers": {
       "codegraph": {
         "type": "stdio",
         "command": "ssh",
         "args": ["root@YOUR_IP", "codegraph", "serve", "--mcp"]
       }
     }
   }

   Zuerst ssh root@YOUR_IP codegraph serve --mcp manuell testen.
4. Tool-Freigabe: mcp__codegraph__* erlauben oder Regel in CLAUDE.md für impact vor Public APIs.

Fertig wenn: Neuer Chat listet codegraph-Tools oder impact liefert Dateipfade — nicht leer/Grep-only.

codegraph impact liefert leere Liste

Symptom: Bekannte Caller existieren, aber codegraph impact "Foo.bar" = 0 Zeilen.

Schritte:

1. Indexiertes Repo-Root:

   pwd
   codegraph status

2. Symbolnamen zur Sprache passend (Swift: TypeName.method). codegraph_callers für Schreibweise.
3. Veralteter Index: auf Cloud Mac git pull && codegraph init -i.
4. Prüfen, ob .gitignore Caller-Verzeichnisse ausschließt.

Fertig wenn: Impact ≥1 Pfad für bekannt referenziertes Symbol; ≥ manuelles grep (indirekte Calls).

Mehrere Repos auf einem Cloud Mac / falsches Verzeichnis

Symptom: In A init, in B codiert; nur ein Projekt unter ~/workspace hat .codegraph/.

Schritte:

• Pro Repo-Root einmal codegraph init -i — kein gemeinsames Elternverzeichnis.
• Vor dem Agent ins richtige Root cd oder Remote-SSH-Ordner öffnen.
• Bei knappem Disk: Vollindex nur fürs Haupt-Monorepo; Nacht cron + tmux.

Fertig wenn: Agent-Workspace-Root = Verzeichnis mit .codegraph/codegraph.db.

Graph lokal abfragen ohne init auf dem Laptop

Symptom: Lokales MCP gewünscht, aber kein 30-Minuten-init lokal.

Schritte:

1. Index auf Cloud Mac; nur .codegraph/ syncen:
   Lokal

   rsync -avz --progress root@YOUR_IP:~/workspace/your-repo/.codegraph/ ./your-repo/.codegraph/

2. Lokal codegraph status; codegraph install für MCP — kein zweites init -i.

Fertig wenn: Lokal codegraph status OK; MCP nutzt sync DB.

Teams rsyncen nächtlich einen „Golden Index“ vom gleichen Cloud Mac.

Cloud Mac träge beim Index — Konkurrenz zu Xcode

Symptom: CPU voll; Build und Index auf einem Host.

Schritte:

• caffeinate -dims in tmux gegen Sleep-Abbruch.
• codegraph init -i nachts oder off-peak; von xcodebuild trennen — siehe ../openclaw-cloud-automation/openclaw-cloud-automation.html Runner.
• Volle CPU durch codegraph normal; bei Simulator + Index zweiten Cloud Mac als Index-Knoten.

Fertig wenn: Index fertig, DB intakt; Tages-Dev/Build nutzbar.

Was spare ich vs. lokalem CodeGraph?

Kein abgespeckter Cloud-Graph — nur wo die CPU läuft. Kein lokales Node/Homebrew, kein Lüfter-Vollindex. SSH, Pfad, MCP bleiben. Konzept: CodeGraph & AI-Coding; Guide: Großes Repo CodeGraph (2026).

• Konzept— Claude Code Edits
• CI gleiche Maschine— Cloud Mac Runner
• Instanz— Cloud-Mac-Tarife