API et serveur MCP

Scrumbo propose une API REST JSON et un serveur Model Context Protocol (MCP), afin que vous (ou un assistant IA comme Claude) puissiez lire et gérer boards et stories en dehors de l'application web.

Authentification

Chaque requête nécessite une clé API personnelle. Créez-en une sur votre page de compte — elle n'est affichée qu'une fois, copiez-la donc immédiatement.

Envoyez-la comme jeton bearer à chaque requête :

Authorization: Bearer sbo_your_key_here

API REST

L'API est disponible à https://scrumbo.com/api/v1 et renvoie du JSON. Une clé a exactement vos droits d'accès : elle n'atteint que les projets et boards dont vous êtes propriétaire, membre ou administrateur.

Méthode	Chemin	Description	Accès requis
GET	`/projects`	Lister les projets auxquels vous avez accès	Toute clé
GET	`/projects/:token/boards`	Lister les boards d'un projet	Viewer
GET	`/boards/:boardid`	Récupérer un board avec ses statuts et ses stories	Viewer
GET	`/boards/:boardid/statuses`	Lister les statuts d'un board	Viewer
GET	`/boards/:boardid/stories`	Lister les stories d'un board, éventuellement filtrées par statut ou assigné	Viewer
GET	`/boards/:boardid/stories/:storyid`	Récupérer une story	Viewer
POST	`/boards/:boardid/stories`	Créer une story	Editor
PATCH	`/boards/:boardid/stories/:storyid`	Mettre à jour les champs d'une story	Editor
POST	`/boards/:boardid/stories/:storyid/status`	Changer le statut d'une story	Editor ou contributor
DELETE	`/boards/:boardid/stories/:storyid`	Supprimer une story	Editor
POST	`/boards/:boardid/stories/:storyid/comments`	Ajouter un commentaire à une story	Commenter

« Editor ou contributor » couvre aussi les developers, qui peuvent changer le statut mais pas modifier le texte de la story.

Exemple :

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"}'

Serveur MCP

Le dossier mcp/ des sources de Scrumbo contient un serveur MCP autonome qui expose l'API REST sous forme d'outils, afin qu'un assistant compatible MCP comme Claude Desktop ou Claude Code puisse utiliser directement vos boards.

Installez ses dépendances une fois : cd mcp && npm install
Créez une clé API sur votre page de compte et copiez-la.
Enregistrez le serveur auprès de votre client MCP, par exemple :

{
  "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"
      }
    }
  }
}

Outils :

Description	Accès requis
`list_projects`	Toute clé
`list_boards`, `get_board`, `list_stories`, `get_story`, `list_statuses`	Viewer
`add_comment`	Commenter
`create_story`, `update_story`, `move_story`, `delete_story`	Editor

À retenir

Une clé a exactement vos droits d'accès — quiconque la détient peut agir en votre nom dans ce périmètre, traitez-la donc comme un mot de passe.
Révoquez une clé à tout moment depuis votre page de compte ; tout ce qui l'utilise cesse alors immédiatement de fonctionner.
Le serveur MCP lui-même n'a aucun accès à la base de données — c'est un client HTTP léger qui n'a jamais plus de droits que la clé que vous lui fournissez.