API en MCP-server
Scrumbo heeft een JSON REST-API en een Model Context Protocol (MCP)-server, zodat jij (of een AI-assistent zoals Claude) boards en stories buiten de webapp kunt lezen en beheren.
Authenticatie
Elke aanvraag heeft een persoonlijke API-sleutel nodig. Maak er een aan op je accountpagina — hij wordt één keer getoond, dus kopieer hem meteen.
Stuur hem als bearer-token mee bij elke aanvraag:
Authorization: Bearer sbo_your_key_hereREST-API
De API is beschikbaar op https://scrumbo.com/api/v1 en geeft JSON terug. Een sleutel heeft precies jouw toegang: hij bereikt alleen projecten en boards waarvan je eigenaar, lid of beheerder bent.
| Methode | Pad | Omschrijving | Benodigde toegang |
|---|---|---|---|
| GET | /projects | Projecten tonen waar je toegang toe hebt | Elke sleutel |
| GET | /projects/:token/boards | Boards in een project tonen | Viewer |
| GET | /boards/:boardid | Een board met statussen en stories ophalen | Viewer |
| GET | /boards/:boardid/statuses | Statussen van een board tonen | Viewer |
| GET | /boards/:boardid/stories | Stories op een board tonen, eventueel gefilterd op status of toegewezene | Viewer |
| GET | /boards/:boardid/stories/:storyid | Eén story ophalen | Viewer |
| POST | /boards/:boardid/stories | Een story aanmaken | Editor |
| PATCH | /boards/:boardid/stories/:storyid | Velden van een story bijwerken | Editor |
| POST | /boards/:boardid/stories/:storyid/status | Status van een story wijzigen | Editor of contributor |
| DELETE | /boards/:boardid/stories/:storyid | Een story verwijderen | Editor |
| POST | /boards/:boardid/stories/:storyid/comments | Een reactie aan een story toevoegen | Commenter |
"Editor of contributor" geldt ook voor developers, die alleen de status mogen wijzigen, niet de storytekst.
Voorbeeld:
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
De map mcp/ in de Scrumbo-broncode bevat een losstaande MCP-server die de REST-API als tools aanbiedt, zodat een MCP-bewuste assistent zoals Claude Desktop of Claude Code je boards direct kan gebruiken.
- Installeer eenmalig de dependencies:
cd mcp && npm install - Maak een API-sleutel aan op je accountpagina en kopieer hem.
- Registreer de server bij je MCP-client, bijvoorbeeld:
{
"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:
| Omschrijving | Benodigde toegang |
|---|---|
list_projects | Elke sleutel |
list_boards, get_board, list_stories, get_story, list_statuses | Viewer |
add_comment | Commenter |
create_story, update_story, move_story, delete_story | Editor |
Let op
- Een sleutel heeft precies jouw toegang — wie hem heeft kan binnen dat bereik namens jou handelen, behandel hem dus als een wachtwoord.
- Trek een sleutel op elk moment in via je accountpagina; alles wat hem gebruikt stopt dan meteen met werken.
- De MCP-server zelf heeft geen databasetoegang — het is een dunne HTTP-client die nooit meer rechten heeft dan de sleutel die je meegeeft.