API-Keys & MCP-Setup

Verbinde Claude Code, Cursor oder Claude Desktop mit deinem Feedbapp-Projekt — Feedback durchsuchen, Cluster zusammenfassen und Status setzen, direkt aus dem Agenten.

1. API-Key erstellen

Dashboard → Projekte → dein Projekt → Settings → API-Keys → Neuer API-Key. Der Key (Format fb_live_…) wird genau einmal angezeigt — kopiere ihn sofort. Er ist auf das Projekt beschränkt, in dem er erstellt wurde.

2. Schnellstart: Claude Code (empfohlen)

npx feedbapp-mcp setup

Der Wizard fragt nach deinem Key, erkennt das Projekt automatisch (über /api/v1/projects/me) und registriert den MCP-Server in Claude Code. Mehrere Projekte? Einfach erneut ausführen — npx feedbapp-mcp setup --list zeigt alle Einträge.

3. Manuell: Cursor / Claude Desktop / andere MCP-Clients

Trage den Server in die MCP-Konfiguration deines Clients ein (Cursor: .cursor/mcp.json, Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "feedbapp": {
      "command": "npx",
      "args": ["-y", "-p", "feedbapp-cli@latest", "feedbapp-mcp"],
      "env": {
        "FEEDBAPP_API_KEY": "fb_live_…",
        "FEEDBAPP_PROJECT_ID": "<Projekt-UUID>"
      }
    }
  }
}

Die Projekt-UUID findest du in der URL der Settings-Seite (/projects/<UUID>/settings).

4. Verfügbare Tools

  • search_feedback — semantische Suche über alles Feedback
  • list_clusters / get_cluster — Cluster nach Priorität
  • summarize_cluster — AI-Zusammenfassung eines Clusters
  • get_feedback — volle Details inkl. Screenshot
  • mark_feedback_status — Workflow-Status setzen

5. Workflow mit Agenten — Status während der Bearbeitung aktualisieren

Wenn ein Agent (z. B. Claude Code) dein Feedback abarbeitet, sollte er den Workflow-Status gepflegt halten — so bleibt das Board ehrlich darüber, was gerade bearbeitet wird und was abgeschlossen ist. Ab feedbapp-cli 0.2.3 gibt der MCP-Server dem Agenten diese Regeln automatisch mit; die Beschreibung von mark_feedback_status enthält denselben Lebenszyklus.

  • new / approved → in_progress, sobald der Agent ein Item aufgreift oder einplant — mit einer kurzen note zum Vorgehen. Nicht geplante Arbeit in new liegen lassen.
  • in_progress → done erst, wenn der Fix umgesetzt und verifiziert ist — nicht nur geplant. Ist noch etwas offen, bleibt es in_progress.
  • rejected für Rauschen oder Test-Artefakte.
  • Gültige Werte: future, new, approved, in_progress, done, rejected. mark_feedback_status ist idempotent (No-op bei unverändertem Status) und schreibt eine serverseitige Audit-Zeile — übergib immer eine kurze note.

6. Rotation & Sicherheit

Keys werden ausschließlich als SHA-256-Hash gespeichert. Bei Rotation bleibt der alte Key 24 Stunden gültig. Kompromittierte Keys sofort in den Settings widerrufen — und niemals in Git oder Chat-Verläufe einfügen.