connect-board

applies_to	all-agents
name	connect-board
description	Board-Verbindung einrichten — via jsp_ Token oder Status prüfen

/connect-board — Board verbinden

Verbindet das aktuelle Projekt mit dem Just Ship Board.

Ausführung

1. Token-Argument prüfen

Falls ein Argument übergeben wurde (z.B. /connect-board jsp_xxxx), ist das ein Verbindungs-Token.

Plugin-Modus erkennen: Prüfe ob die Env-Var CLAUDE_PLUGIN_ROOT gesetzt ist.

echo "${CLAUDE_PLUGIN_ROOT:-not_set}"

Bei Plugin-Modus (CLAUDE_PLUGIN_ROOT gesetzt):

bash .claude/scripts/write-config.sh connect --token "$TOKEN" --plugin-mode --project-dir .

Parst die JSON-Ausgabe und gibt Feedback:

Bei "success": true:

✓ Workspace verbunden: {workspace_slug}
✓ Projekt verknüpft: {project_id}        (nur wenn project_id vorhanden)
✓ Verbindung verifiziert                 (nur wenn verified: true)

Dann Plugin-Credentials setzen (Anleitung ausgeben):

API-Key in Plugin-Konfiguration setzen:

  claude plugin config set just-ship board_api_key "{api_key}"
  claude plugin config set just-ship board_api_url "{board_url}"

Bei "verify_error": "invalid_api_key":

⚠ Verbunden, aber API-Key wurde abgelehnt (HTTP 401).
  Prüfe deinen API-Key im Board unter Settings → API Keys.

Bei "verify_error": "board_unreachable":

✓ Workspace verbunden: {workspace_slug}
⚠ Board nicht erreichbar — Verbindung offline gespeichert.

Ohne Plugin-Modus (Standard-Installation):

bash .claude/scripts/write-config.sh connect --token "$TOKEN" --project-dir .

Gibt das Terminal-Feedback der Standardausgabe weiter.

---

2. Kein Token-Argument — Status prüfen

Lies project.json und prüfe pipeline.workspace_id. Falls gesetzt, validiere die vollständige Verbindung:

bash .claude/scripts/write-config.sh read-workspace --id <workspace_id>

Prüfe zusätzlich Plugin-Credentials: Falls CLAUDE_USER_CONFIG_BOARD_API_KEY gesetzt ist, gilt das als "Plugin-Credentials konfiguriert".

Ergebnis auswerten:

project.json	Credentials	Status
workspace_id + project_id gesetzt	api_key vorhanden (config oder Plugin-Env)	Voll verbunden
workspace_id gesetzt, project_id fehlt	api_key vorhanden	Workspace verbunden, Projekt fehlt
workspace_id gesetzt	api_key leer oder read-workspace schlägt fehl	Credentials fehlen
—	CLAUDE_USER_CONFIG_BOARD_API_KEY gesetzt	Plugin-Credentials konfiguriert
workspace_id nicht gesetzt	—	Nicht verbunden

Voll verbunden:

✓ Board verbunden (Workspace: {slug || workspace_id}, Projekt: {project_id})

Workspace verbunden, Projekt fehlt:

✓ Workspace verbunden ({slug || workspace_id}), aber kein Projekt verknüpft.

Führe 'just-ship connect' im Terminal aus um ein Projekt auszuwählen.

Credentials fehlen:

⚠ Workspace in project.json gesetzt, aber API-Key fehlt in .env.local.

Führe 'just-ship connect' mit einem neuen Code im Terminal aus — der Befehl schreibt JSP_BOARD_API_KEY in .env.local (gitignored, chmod 600). Falls du noch eine alte Installation hast, die ~/.just-ship/config.json nutzt: das funktioniert weiter als Legacy-Fallback.

Plugin-Credentials konfiguriert (kein project.json):

✓ Plugin-Credentials konfiguriert (board_api_key gesetzt via Plugin-Config).

Nicht verbunden → weiter zu Schritt 3.

---

3. Falls nicht verbunden

Ausgabe (NICHT in einem Code-Block, damit der Link klickbar ist):

Öffne https://board.just-ship.io — das Board führt dich durch die Einrichtung. Sag Bescheid wenn du fertig bist.

Das ist alles. Keine weiteren Erklärungen, keine Schritte. Das Board hat einen Onboarding-Stepper der alles erklärt.

---

4. Wenn der User zurückkommt (nach Board-Onboarding)

Prüfe ob die Verbindung eingerichtet wurde:

bash .claude/scripts/write-config.sh read-workspace --id <workspace_id> 2>/dev/null || echo "NOT_CONNECTED"

Falls verbunden: Prüfe ob project.json den Workspace hat. Falls nicht, setze ihn:

".claude/scripts/write-config.sh" set-project --workspace-id <uuid> --project-id <project-id>

Bestätigung (zeige slug wenn verfügbar):

✓ Board verbunden (Workspace: {slug || uuid})

Falls NOT_CONNECTED: Informiere den User dass etwas nicht geklappt hat und weise auf just-ship connect im Terminal hin.

Wichtig

• Secrets nur im Plugin-Setup-Kontext — In Plugin-Modus wird der API-Key einmalig für claude plugin config set ausgegeben. In Standard-Mode werden Credentials ausschließlich via just-ship connect im Terminal gespeichert, nie im Chat ausgegeben
• Nicht erklären wie das Board funktioniert — das Board hat seinen eigenen Onboarding-Flow
• v2-Token (ohne project_id): In Plugin-Modus wird project_id als fehlend markiert — User muss manuell konfigurieren
• v3-Token (mit project_id): Vollständige Auto-Konfiguration ohne interaktive Auswahl