API y servidor MCP

Scrumbo tiene una API REST JSON y un servidor Model Context Protocol (MCP), para que tú (o un asistente de IA como Claude) puedas leer y gestionar boards e historias desde fuera de la aplicación web.

Autenticación

Cada solicitud necesita una clave API personal. Crea una en tu página de cuenta — se muestra una sola vez, así que cópiala de inmediato.

Envíala como token bearer en cada solicitud:

Authorization: Bearer sbo_your_key_here

API REST

La API está disponible en https://scrumbo.com/api/v1 y devuelve JSON. Una clave tiene exactamente tu acceso: solo alcanza proyectos y boards de los que eres propietario, miembro o administrador.

Método	Ruta	Descripción	Acceso necesario
GET	`/projects`	Listar los proyectos a los que tienes acceso	Cualquier clave
GET	`/projects/:token/boards`	Listar los boards de un proyecto	Viewer
GET	`/boards/:boardid`	Obtener un board con sus estados e historias	Viewer
GET	`/boards/:boardid/statuses`	Listar los estados de un board	Viewer
GET	`/boards/:boardid/stories`	Listar las historias de un board, opcionalmente filtradas por estado o asignado	Viewer
GET	`/boards/:boardid/stories/:storyid`	Obtener una historia	Viewer
POST	`/boards/:boardid/stories`	Crear una historia	Editor
PATCH	`/boards/:boardid/stories/:storyid`	Actualizar los campos de una historia	Editor
POST	`/boards/:boardid/stories/:storyid/status`	Cambiar el estado de una historia	Editor o contributor
DELETE	`/boards/:boardid/stories/:storyid`	Eliminar una historia	Editor
POST	`/boards/:boardid/stories/:storyid/comments`	Añadir un comentario a una historia	Commenter

«Editor o contributor» también incluye a los developers, que solo pueden cambiar el estado, no editar el texto de la historia.

Ejemplo:

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

Servidor MCP

La carpeta mcp/ del código fuente de Scrumbo incluye un servidor MCP independiente que expone la API REST como herramientas, para que un asistente compatible con MCP como Claude Desktop o Claude Code pueda usar tus boards directamente.

Instala sus dependencias una vez: cd mcp && npm install
Crea una clave API en tu página de cuenta y cópiala.
Registra el servidor en tu cliente MCP, por ejemplo:

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

Herramientas:

Descripción	Acceso necesario
`list_projects`	Cualquier clave
`list_boards`, `get_board`, `list_stories`, `get_story`, `list_statuses`	Viewer
`add_comment`	Commenter
`create_story`, `update_story`, `move_story`, `delete_story`	Editor

Ten en cuenta

Una clave tiene exactamente tu acceso — quien la tenga puede actuar en tu nombre dentro de ese alcance, así que trátala como una contraseña.
Revoca una clave en cualquier momento desde tu página de cuenta; todo lo que la use deja de funcionar de inmediato.
El propio servidor MCP no tiene acceso a la base de datos — es un cliente HTTP ligero que nunca tiene más privilegios que la clave que le proporcionas.