Files

T

egutierrez c28ae7d3c0 chore: auto-commit (12 archivos)

- app.md
- backend/handlers.go
- backend/main.go
- frontend/src/App.tsx
- frontend/src/api.ts
- frontend/vite.config.ts
- backend/mcp_http.go
- backend/mcp_tokens.go
- backend/mcp_tokens_handlers.go
- backend/migrations/016_mcp_tokens.sql
- ...

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-22 14:38:17 +02:00

3.1 KiB

Raw Blame History

Conectar Claude al kanban via MCP

El kanban expone un endpoint MCP HTTP (/mcp) que permite a un cliente Claude leer y modificar el tablero de cada usuario.

Cuando usarlo

Pedir a Claude que cree, actualice, mueva o busque tarjetas desde tu terminal local sin abrir el navegador.
Listar el board en lenguaje natural.
Asignar tarjetas, consultar historial, etc.

Configuracion (una vez por PC)

1. Generar token en el kanban

Abre el kanban en el navegador (mismo URL que usas normalmente, por ejemplo http://<host-windows>:5180).
Click en tu avatar (esquina superior derecha) → MCP tokens.
Pulsa Generar, dale un nombre descriptivo (por ejemplo portatil-trabajo).
Copia el token inmediatamente — solo se muestra una vez. Tambien tendras el comando claude mcp add listo para pegar.

2. Registrar el MCP en Claude Code

En el PC desde el que vas a usar Claude:

claude mcp add kanban --transport http http://<host-windows>:5180/mcp \
  --header "Authorization: Bearer kmcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Reemplaza <host-windows> por la IP o nombre del PC Windows que sirve el kanban en la LAN, y el token por el valor que copiaste.

Verifica con:

claude mcp list

Tienes que ver kanban con estado connected.

Tools disponibles

Una vez conectado, Claude puede invocar:

Tool	Que hace
`list_board`	Devuelve columnas y tarjetas del tablero
`create_column`	Crea una columna nueva
`update_column`	Modifica nombre, ancho, WIP, ubicacion, terminal
`rename_column`	Alias rapido de `update_column` con `{id, name}`
`delete_column`	Borra una columna (cards a papelera)
`reorder_columns`	Reordena columnas
`create_card`	Crea tarjeta en una columna
`update_card`	Edita titulo, descripcion, color, lock, asignado
`delete_card`	Envia tarjeta a papelera
`move_card`	Mueve tarjeta a otra columna
`card_history`	Historial de cambios de una tarjeta
`find_cards`	Busca por texto/columna/solicitante
`list_users`	Usuarios disponibles para asignar
`assign_card`	Asigna o desasigna usuario

Revocar acceso

Si pierdes el PC o quieres rotar el token, vuelve al modal MCP tokens y pulsa el icono de papelera en la fila correspondiente. El cliente Claude perdera acceso al instante.

Limitaciones actuales

Las acciones por MCP no registran actor_id en el historial — quedan como anonimas. (Mejora pendiente.)
No hay rate limiting por token; revoca si detectas mal uso.
El endpoint NO soporta SSE server→client (solicitudes Claude→kanban funcionan, sin streaming inverso).
Solo POST /mcp esta soportado; GET y DELETE devuelven 405.
Body limit 1 MiB.

Troubleshooting

Sintoma	Probable causa
`claude mcp list` muestra error de conexion	Vite (puerto 5180) o backend (8095) parados. Lanza el `control.sh` del kanban.
`401 unauthorized`	Token mal pegado, revocado, o caducado. Genera uno nuevo.
`405 Method Not Allowed`	Estas haciendo GET; el MCP solo acepta POST.
Tools listan pero `list_board` falla	Backend devuelve error real — mira `kanban.log` en WSL.

3.1 KiB Raw Blame History