API & MCP-Server

Scrumbo bietet eine JSON-REST-API und einen Model-Context-Protocol(MCP)-Server, damit Sie (oder ein KI-Assistent wie Claude) Boards und Stories außerhalb der Web-App lesen und verwalten können.

Authentifizierung

Jede Anfrage benötigt einen persönlichen API-Schlüssel. Erstellen Sie einen auf Ihrer Kontoseite — er wird nur einmal angezeigt, kopieren Sie ihn also sofort.

Senden Sie ihn bei jeder Anfrage als Bearer-Token:

Authorization: Bearer sbo_your_key_here

REST-API

Die API ist erreichbar unter https://scrumbo.com/api/v1 und liefert JSON. Ein Schlüssel hat genau Ihre Zugriffsrechte: Er erreicht nur Projekte und Boards, deren Eigentümer, Mitglied oder Administrator Sie sind.

Methode	Pfad	Beschreibung	Benötigter Zugriff
GET	`/projects`	Projekte auflisten, auf die Sie Zugriff haben	Jeder Schlüssel
GET	`/projects/:token/boards`	Boards eines Projekts auflisten	Viewer
GET	`/boards/:boardid`	Ein Board mit Status und Stories abrufen	Viewer
GET	`/boards/:boardid/statuses`	Status eines Boards auflisten	Viewer
GET	`/boards/:boardid/stories`	Stories eines Boards auflisten, optional gefiltert nach Status oder Zuständigem	Viewer
GET	`/boards/:boardid/stories/:storyid`	Eine einzelne Story abrufen	Viewer
POST	`/boards/:boardid/stories`	Eine Story erstellen	Editor
PATCH	`/boards/:boardid/stories/:storyid`	Felder einer Story aktualisieren	Editor
POST	`/boards/:boardid/stories/:storyid/status`	Status einer Story ändern	Editor oder contributor
DELETE	`/boards/:boardid/stories/:storyid`	Eine Story löschen	Editor
POST	`/boards/:boardid/stories/:storyid/comments`	Einen Kommentar zu einer Story hinzufügen	Commenter

„Editor oder contributor“ schließt auch Developer ein, die nur den Status ändern, nicht den Story-Text bearbeiten dürfen.

Beispiel:

curl https://scrumbo.com/api/v1/boards/123/stories \
  -H "Authorization: Bearer sbo_your_key_here"

curl -X POST https://scrumbo.com/api/v1/boards/123/stories \
  -H "Authorization: Bearer sbo_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"subject": "New story", "story": "Details go here"}'

MCP-Server

Der Ordner mcp/ im Scrumbo-Quellcode enthält einen eigenständigen MCP-Server, der die REST-API als Tools bereitstellt, sodass ein MCP-fähiger Assistent wie Claude Desktop oder Claude Code Ihre Boards direkt nutzen kann.

Installieren Sie einmalig seine Abhängigkeiten: cd mcp && npm install
Erstellen Sie einen API-Schlüssel auf Ihrer Kontoseite und kopieren Sie ihn.
Registrieren Sie den Server bei Ihrem MCP-Client, zum Beispiel:

{
  "mcpServers": {
    "scrumbo": {
      "command": "node",
      "args": ["/absolute/path/to/scrumbo.com/node/mcp/index.js"],
      "env": {
        "SCRUMBO_API_KEY": "sbo_your_key_here",
        "SCRUMBO_API_URL": "https://scrumbo.com/api/v1"
      }
    }
  }
}

Tools:

Beschreibung	Benötigter Zugriff
`list_projects`	Jeder Schlüssel
`list_boards`, `get_board`, `list_stories`, `get_story`, `list_statuses`	Viewer
`add_comment`	Commenter
`create_story`, `update_story`, `move_story`, `delete_story`	Editor

Zu beachten

Ein Schlüssel hat genau Ihre Zugriffsrechte — wer ihn besitzt, kann in diesem Rahmen in Ihrem Namen handeln, behandeln Sie ihn also wie ein Passwort.
Widerrufen Sie einen Schlüssel jederzeit über Ihre Kontoseite; alles, was ihn nutzt, funktioniert dann sofort nicht mehr.
Der MCP-Server selbst hat keinen Datenbankzugriff — er ist ein schlanker HTTP-Client, der nie mehr Rechte hat als der Schlüssel, den Sie ihm geben.