ProductPlan MCP-Server

Kommunizieren Sie mit Ihren Roadmaps per KI. Stellen Sie Fragen, erstellen Sie Ideen, überprüfen Sie den Fortschritt von OKRs und verwalten Sie Launches durch natürliche Konversation mit Claude, Cursor oder anderen KI-Assistenten.

Was können Sie damit tun?

Anstatt sich durch die Benutzeroberfläche von ProductPlan zu klicken, fragen Sie einfach:

„Was steht auf unserer Q1-Roadmap?“

„Zeige mir alle Ziele, die im Zeitplan zurückliegen“

„Erstelle eine neue Idee für Verbesserungen der mobilen App“

„Welche Launches stehen diesen Monat an?“

„Liste alle Ideen mit dem Tag 'customer-request' auf“

Die KI ruft Ihre echten ProductPlan-Daten ab und antwortet in Sekunden.

Für wen ist das gedacht?

• Produktmanager, die schnelleren Zugriff auf Roadmap-Daten wünschen

• Teamleiter, die schnelle Status-Updates benötigen, ohne den Kontext wechseln zu müssen

• Jeden, der KI-Assistenten (Claude, Cursor usw.) nutzt und ProductPlan in seinen Workflow integrieren möchte

Keine Programmierung erforderlich. Sie kopieren eine Datei und fügen einige Einstellungen ein.

Schnellstart (5 Minuten)

Schritt 1: Holen Sie sich Ihr ProductPlan-API-Token

1. Melden Sie sich bei ProductPlan an

2. Gehen Sie zu Settings → API (oder besuchen Sie diesen Link direkt)

3. Kopieren Sie Ihr API-Token

Schritt 2: Laden Sie die App herunter

Gehen Sie zur Releases-Seite und laden Sie die passende Datei für Ihren Computer herunter:

Unter Mac/Linux, öffnen Sie das Terminal und führen Sie diese zwei Befehle aus (ersetzen Sie den Dateinamen durch den, den Sie heruntergeladen haben):

chmod +x ~/Downloads/productplan-darwin-arm64
sudo mv ~/Downloads/productplan-darwin-arm64 /usr/local/bin/productplan

Sie werden nach Ihrem Passwort gefragt. Das ist normal.

Unter Windows:

1. Erstellen Sie einen Ordner für die Binärdatei (falls er noch nicht existiert):

   mkdir C:\Tools

2. Verschieben Sie die heruntergeladene .exe in diesen Ordner und benennen Sie sie um:

   move %USERPROFILE%\Downloads\productplan-windows-amd64.exe C:\Tools\productplan.exe

3. Verwenden Sie den vollständigen Pfad C:\Tools\productplan.exe in Ihrer KI-Assistenten-Konfiguration (gezeigt in Schritt 3)

Hinweis: Sie müssen die Datei nicht zum PATH hinzufügen. Verwenden Sie einfach den vollständigen Dateipfad in Ihrer Konfiguration.

Schritt 3: Verbindung mit Ihrem KI-Assistenten herstellen

Wählen Sie das Tool, das Sie verwenden:

1. Suchen Sie Ihre Konfigurationsdatei:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Öffnen Sie sie in einem Texteditor und fügen Sie dies hinzu (ersetzen Sie your-token durch Ihr tatsächliches API-Token):

Mac/Linux:

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

3. Starten Sie Claude Desktop neu

Fügen Sie dies zu Ihrer Konfigurationsdatei hinzu:

• Mac/Linux: ~/.claude.json

• Windows: %USERPROFILE%\.claude.json

Mac/Linux:

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Öffnen Sie Cursor

2. Gehen Sie zu Settings → MCP Servers

3. Fügen Sie diese Konfiguration hinzu:

Mac/Linux:

{
  "productplan": {
    "command": "/usr/local/bin/productplan",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Windows:

{
  "productplan": {
    "command": "C:\\Tools\\productplan.exe",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Windows-Benutzer: Verwenden Sie doppelte Backslashes (\\) im Pfad. Dies ist erforderlich, da der Backslash ein Escape-Zeichen in JSON ist.

1. Installieren Sie die Cline-Erweiterung

2. Öffnen Sie die VS Code-Einstellungen (JSON) und fügen Sie hinzu:

Mac/Linux:

{
  "cline.mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "cline.mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Installieren Sie die Continue-Erweiterung

2. Fügen Sie dies zu Ihrer Konfigurationsdatei hinzu:

   • Mac/Linux: ~/.continue/config.json

   • Windows: %USERPROFILE%\.continue\config.json

Mac/Linux:

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

Windows:

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

1. Setzen Sie die Umgebungsvariable auf Ihrer n8n-Instanz:

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

2. Fügen Sie einen MCP Client-Knoten zu Ihrem Workflow hinzu

3. Konfigurieren Sie:

   • Command:

     • Mac/Linux: /usr/local/bin/productplan

     • Windows: C:\Tools\productplan.exe

   • Environment Variables: PRODUCTPLAN_API_TOKEN=your-token

4. Verbinden Sie sich mit einem AI Agent-Knoten

Beispiel-Workflow: Slack Trigger → AI Agent (mit MCP Client) → Slack Response

Schritt 4: Stellen Sie Fragen

Öffnen Sie Ihren KI-Assistenten und versuchen Sie:

• „Liste meine ProductPlan-Roadmaps auf“

• „Welche Balken befinden sich auf der Roadmap [Name]?“

• „Zeige mir unsere OKRs“

• „Welche Ideen befinden sich in der Discovery?“

Praxisbeispiele

Vorbereitung für das morgendliche Standup

„Fasse zusammen, was sich in der letzten Woche auf unserer Produkt-Roadmap geändert hat“

Stakeholder-Updates

„Liste alle Q1-Ziele und deren Fortschritt auf“

Ideen-Triage

„Zeige mir alle Ideen mit dem Tag 'enterprise', für die keine Priorität festgelegt wurde“

Launch-Koordination

„Welche Aufgaben sind für den Januar-Launch noch unvollständig?“

Schnelle Nachschlagevorgänge

„Wann soll der Balken 'Mobile App v2' starten?“

Auf welche ProductPlan-Daten können Sie zugreifen?

Funktionsweise

┌─────────────────┐      spawns       ┌─────────────────┐      API calls     ┌─────────────────┐
│   AI Assistant  │ ───────────────── │   MCP Server    │ ─────────────────▶ │   ProductPlan   │
│ (Claude, Cursor)│ ◀───────────────▶ │   (this binary) │ ◀───────────────── │      API        │
└─────────────────┘   stdin/stdout    └─────────────────┘     JSON data      └─────────────────┘
      your computer                        your computer                         cloud

Warum muss dies auf Ihrem Computer ausgeführt werden?

MCP (Model Context Protocol) arbeitet über ein Subprozess-Modell. Ihr KI-Assistent verbindet sich nicht mit einem Remote-Server; er startet die Binärdatei als lokalen Prozess und kommuniziert über stdin/stdout. Diese Architektur bedeutet:

1. Die Binärdatei muss lokal vorhanden sein, da Ihr KI-Assistent sie als Kindprozess ausführt

2. Ihr API-Token bleibt auf Ihrem Rechner und wird niemals über Server Dritter übertragen

3. Echtzeit-Synchronkommunikation ohne Netzwerklatenz zwischen KI und dem MCP-Server

4. Funktioniert offline für zwischengespeicherte Daten (obwohl ProductPlan-API-Aufrufe weiterhin Internet benötigen)

Wenn Sie fragen „Was steht auf unserer Q1-Roadmap?“, passiert Folgendes:

1. Ihr KI-Assistent erkennt, dass er ProductPlan-Daten benötigt

2. Er sendet eine strukturierte Anfrage an den MCP-Server-Prozess

3. Die Binärdatei übersetzt dies in ProductPlan-API-Aufrufe

4. ProductPlan gibt JSON-Daten zurück

5. Die Binärdatei formatiert die Ergebnisse und gibt sie an Ihre KI zurück

6. Ihre KI präsentiert die Antwort in natürlicher Sprache

Agenten-Fähigkeiten

Vorgefertigte Workflow-Anleitungen, die KI-Assistenten beibringen, wie sie ProductPlan-Tools effektiv nutzen können. Jede Fähigkeit zielt auf eine bestimmte Persona mit maßgeschneiderten Workflows ab.

Gemeinsame Prinzipien

Alle Fähigkeiten folgen diesen Ausgabekonventionen:

• Kein rohes JSON – Formatieren Sie Antworten als lesbaren Text und Tabellen

• Menschenlesbare Daten – Verwenden Sie „März 2025“ oder „Q1 2025“, nicht „2025-03-15“

• Große Listen zusammenfassen – Überfordern Sie nicht mit 50 Elementen; bieten Sie an, diese zu erweitern

Persona-spezifische Variationen:

• PM enthält bar_id für Folgeaktionen

• Führungskräfte beginnen mit einer Zusammenfassung und verbergen Implementierungsdetails

• Kundenorientiert lässt interne IDs, Lane-Namen und OKRs vollständig weg

Um eine Fähigkeit zu nutzen, kopieren Sie die SKILL.md-Datei in Ihr Claude Code-Fähigkeiten-Verzeichnis:

# Copy a skill (example: PM skill)
cp skills/productplan-pm/SKILL.md ~/.claude/skills/productplan-pm.md

Oder referenzieren Sie Fähigkeiten direkt in Ihren Prompts:

„Nutze den productplan-pm-Workflow, um mir unsere Q1-Roadmap zu zeigen“

Fehlerbehebung

„Command not found“ oder „spawn ENOENT“

Ihr KI-Assistent kann die Binärdatei nicht finden. Das bedeutet:

• Mac/Linux: Die Datei befindet sich nicht unter /usr/local/bin/productplan, oder Sie haben vergessen, chmod +x auszuführen

• Windows: Der Pfad in Ihrer Konfiguration stimmt nicht mit dem Speicherort der .exe überein

Lösung: Überprüfen Sie, ob die Binärdatei unter dem Pfad in Ihrer Konfiguration existiert. Führen Sie ls -la /usr/local/bin/productplan (Mac/Linux) aus oder prüfen Sie, ob C:\Tools\productplan.exe (Windows) existiert.

Windows-Pfadprobleme

Häufige Fehler unter Windows:

Windows verwendet Backslashes (\) für Pfade, aber JSON behandelt den Backslash als Escape-Zeichen. Sie müssen sie in Ihrer Konfigurationsdatei verdoppeln (\\).

„Invalid API token“

Überprüfen Sie Ihr Token unter ProductPlan Settings → API. Token können ablaufen oder neu generiert werden. Stellen Sie sicher, dass Sie das vollständige Token ohne zusätzliche Leerzeichen kopiert haben.

„No roadmaps found“

Ihr API-Token greift nur auf Daten zu, für die Sie in ProductPlan eine Berechtigung haben. Überprüfen Sie, ob Ihr Konto Zugriff auf die Roadmaps hat, die Sie suchen.

KI-Assistent sieht keine ProductPlan-Tools

MCP-Server werden geladen, wenn Ihr KI-Assistent startet, nicht wenn sich Konfigurationen ändern. Starten Sie die Anwendung nach dem Bearbeiten der Konfigurationsdatei vollständig neu. Verwenden Sie auf dem Mac Cmd+Q (nicht nur das Fenster schließen).

„Permission denied“ unter Mac/Linux

Die Binärdatei benötigt Ausführungsberechtigungen. Führen Sie aus:

chmod +x /usr/local/bin/productplan

Befehlszeile (optional)

Sie können dieses Tool auch direkt im Terminal ohne KI-Assistenten verwenden: