# Kanban WebMCP

> Tablero Kanban colaborativo (columnas y tarjetas) pensado para ser operado tanto por personas como por agentes de IA. Tiene soporte WebMCP interactivo: las páginas exponen herramientas en `navigator.modelContext`.

## Cómo obtener un tablero (sin cuenta)

Hay dos formas equivalentes:

1. **URL directa:** genera tú mismo un UUIDv4 y navega a `http://ernesto-gecos.akita-darter.ts.net/board/<uuid>`. Si el tablero no existe, se crea con las columnas "Por hacer", "En progreso" y "Hecho".
2. **Herramienta WebMCP `create_agent_session`** (sin parámetros): devuelve `agentId`, `url` (`/board/:agentId`) y `absoluteUrl`. También puedes llamar a `POST http://ernesto-gecos.akita-darter.ts.net/api/agent-sessions`.

La URL `/board/:agentId` es pública: cualquiera que conozca el `agentId` puede ver y modificar ese tablero. Trata el UUID como un secreto compartido.

## WebMCP

Cada página carga `@mcp-b/global` y registra 11 herramientas con `navigator.modelContext.registerTool()`:
`create_agent_session`, `get_kanban_state`, `create_column`, `rename_column`, `delete_column`, `reorder_columns`, `create_card`, `update_card`, `delete_card`, `move_card`, `filter_cards`.

Los formularios de la interfaz también son herramientas declarativas (atributos `webmcp-tool` / `webmcp-description`): `ui_add_column`, `ui_rename_column`, `ui_add_card`, `ui_filter_cards`.

Los cambios se guardan en SQLite y se reflejan de inmediato en la interfaz abierta. Para conectar un cliente MCP externo usa el puente `npx -y @mcp-b/webmcp-local-relay` con la pestaña del tablero abierta.

## API REST (resumen)

- `POST /api/agent-sessions`
- `GET /api/boards/:boardId`
- `POST /api/boards/:boardId/columns`, `PATCH|DELETE /api/boards/:boardId/columns/:columnId`, `PUT /api/boards/:boardId/columns/order`
- `POST /api/boards/:boardId/cards`, `PATCH|DELETE /api/boards/:boardId/cards/:cardId`, `POST /api/boards/:boardId/cards/:cardId/move`

## Documentación completa

- [llms-full.txt](http://ernesto-gecos.akita-darter.ts.net/llms-full.txt): especificación completa del API REST y esquemas JSON de todas las herramientas.