nexus-mcp

MCP-Server, der das Nexus/TaskBridge-PM-System für Claude Code bereitstellt, damit Agenten Aufgaben direkt lesen und aktualisieren können, anstatt dass ein Mensch den Status von Hand übermittelt. Zusammen mit zwei Skills in claude-templates – nexus-plan-work (für PM/BA/Teamleiter, Erstellung) und nexus-pick-up-task (für Entwickler, Konsum).

Spricht mit der öffentlichen /api/v1/*-API des PM-Systems – nicht mit den internen Endpunkten von nexus-vscode, die den offiziellen Erweiterungen vorbehalten sind. Warum, und die vollständige Build-Historie, findest du in DEVLOG.md.

Einrichtung (einmalig, pro Person)

Vier Schritte in der richtigen Reihenfolge – durch das Anmelden allein weiß Claude Code noch nicht, dass nexus-mcp existiert. Das ist ein separater Schritt (siehe Schritt 2 unten). Für keinen der Schritte ist ein git clone nötig – npx lädt, baut und führt direkt von GitHub aus.

1. Anmelden – generiert ein Token über das Entwicklerportal und speichert es im Schlüsselbund deines Betriebssystems (@napi-rs/keyring – niemals in einer Datei):

export NEXUS_API_URL=http://27.254.62.17:8090
npx -y -p github:tanakorncode/nexus-mcp nexus-mcp-login

Führt dich durch $NEXUS_API_URL/developer → App erstellen → Bereiche tasks:read tasks:write projects:read members:read sprints:read gewähren → Token generieren – und fordert dich dann auf, dieses Token sowie deine Kontonummer einzugeben.

2. Bei Claude Code registrieren – eines auswählen (nicht beide nötig, aber sie können koexistieren):

• Für dich selbst, für jedes Repository, einmalig (benötigt die claude-CLI – zuerst npm install -g @anthropic-ai/claude-code):

claude mcp add nexus-mcp -s user -e NEXUS_API_URL=http://27.254.62.17:8090 -- npx -y github:tanakorncode/nexus-mcp

Danach ist nirgendwo eine .mcp.json erforderlich.

• Oder, wenn ein Repository, das du öffnest, bereits eine .mcp.json im Stammverzeichnis eingecheckt hat (z. B. pea-thailand-backoffice-be) – nichts zu tun, Claude Code erkennt sie automatisch, wenn du das Repository öffnest. Nur relevant, wenn du den obigen Schritt nicht ausgeführt hast.

3. Claude Code neu laden (neues Fenster / Sitzung neu starten) – in jedem Fall erforderlich, die laufende Sitzung erkennt einen neu registrierten Server nicht von selbst. Die erste Verbindung ist langsamer (npx lädt und baut frisch); danach wird gecacht. Bestätige die einmalige Vertrauensabfrage.

4. Überprüfen – bitte Claude, whoami aufzurufen. Wenn dein Name aufgelöst wird, haben alle vier Schritte funktioniert.

Installiere auch die Skills (einmal pro Person – Details findest du in claude-templates/README.md):

mkdir -p ~/.claude/skills
git clone --depth 1 https://github.com/tanakorncode/claude-templates /tmp/claude-templates
cp -r /tmp/claude-templates/skills/nexus-pick-up-task ~/.claude/skills/
cp -r /tmp/claude-templates/skills/nexus-plan-work ~/.claude/skills/

Entwicklung an nexus-mcp selbst

Wenn du den Code dieses Repos änderst und es nicht nur verwendest, klone es stattdessen, damit Änderungen ohne erneutes Veröffentlichen wirksam werden:

git clone https://github.com/tanakorncode/nexus-mcp
cd nexus-mcp
npm install
npm run build
npm link          # makes the `nexus-mcp` command available anywhere on this machine

Richte .mcp.json während der Iteration auf "command": "nexus-mcp" (ohne args) anstelle der npx-Form aus – baue neu (npm run build) und lade das Claude-Code-Fenster neu, um Änderungen zu übernehmen; andernfalls hält der MCP-Serverprozess den alten Code im Speicher.

Related MCP server: Dooray MCP Server

Die beiden Skills und wann welcher greift

• nexus-plan-work – ein Feature in Epic/Story/Task zerlegen. Vor Beginn der Arbeit verwenden. Die Disziplin, auf die es hier ankommt: eine Story pro Feature, das sich über Repositories erstreckt, eine Aufgabe pro Repository darunter, repositoryId bei jeder Aufgabe gesetzt (das am häufigsten übersprungene Feld – und das, das später nicht mehr nachgeholt werden kann, wenn es fehlt).

• nexus-pick-up-task – eine Aufgabe finden, verstehen und ausführen, endend mit einem PR und einem Statusupdate. Verwenden, sobald Arbeit existiert und jemand (Mensch oder ein geplanter Check) bereit ist, darauf zu reagieren.

Lies die Skill-Dateien selbst für die vollständige Schritt-für-Schritt-Anleitung – diese README wird sie nicht duplizieren.

Tools

Identität & Erkennung

Aufgaben lesen

Erstellung (siehe nexus-plan-work)

Übergabe

Optional: Geplante Aufgabenprüfung (nur Benachrichtigung)

scripts/check-my-tasks.sh läuft headless (claude -p) und prüft list_my_tasks in regelmäßigen Abständen. Wenn etwas bereit ist, wird eine macOS-Benachrichtigung ausgelöst – es beginnt nicht von selbst Code zu schreiben (--allowedTools ist auf schreibgeschützte Tools plus Bash(osascript*) beschränkt, sodass es strukturell keine Dateien bearbeiten kann, selbst wenn es wollte).

launchctl load ~/Library/LaunchAgents/com.pea-thailand.nexus-task-check.plist   # enable, runs every 2h
launchctl unload ~/Library/LaunchAgents/com.pea-thailand.nexus-task-check.plist # disable
tail -f ~/Library/Logs/nexus-task-check.log                                     # watch it run
./scripts/check-my-tasks.sh                                                     # run once, right now

Die Plist selbst ist nicht in diesem Repo (sie ist eine lokale Maschinenkonfiguration pro Person) – kopiere die aus dem Eintrag vom 22.08.2026 in DEVLOG.md oder frage jemanden, der sie eingerichtet hat.

Das prüft nur; eine Person muss trotzdem Claude Code öffnen und nach der Benachrichtigung „los" sagen – warum es dort aufhört, erfährst du in DEVLOG.md.

Bekannte Einschränkungen

• Keine Kommentarunterstützung, keine Commit-Verknüpfung – diese Routen existieren nur in der reinen Erweiterungs-API, nicht unter /api/v1/*. Zum Hinzufügen wären neue pm-system-Routen erforderlich.

• Keine Epic-Erstellung über die API – Epics sind selten/führungsgeplant; nutze die Produktoberfläche.

• Kein Hochladen von Anhängen/Einbettungen über die API (Lesen funktioniert – get_task gibt beides zurück) – füge Figma-Links/Screenshots über die Produktoberfläche hinzu.

• Repo-, Story- und Label-gefilterte Abfragen liefern nur dann Ergebnisse, wenn jemand tatsächlich repositoryId/storyId/labelIds an Aufgaben setzt – es wird nichts automatisch abgeleitet.