Kanban Studio MCP

Supported tools

Aprende qué puede hacer tu agente de IA con las tools MCP de Kanban Studio.

MCP tools

Las tools están agrupadas por operaciones de lectura y escritura. El scope habilita la operación, y la autorización por rol de tablero/workspace sigue aplicando.

Cada tool tiene dos verificaciones de seguridad: permiso por scope de tu credencial OAuth/API y autorizacion por rol segun tu membresia en Kanban Studio. Un scope valido no es suficiente si tu usuario no tiene acceso al tablero objetivo.

Usa estas especificaciones como contrato de implementacion para prompts y automatizaciones. Si una llamada falla, revisa primero scope y rol del tablero. La mayoria de errores FORBIDDEN vienen de una de esas dos condiciones.

Para agentes en produccion, empieza con scopes de solo lectura y amplia solo cuando sea necesario. Esto reduce el impacto y evita cambios accidentales en tableros durante iteraciones de prompts.

Las tools bulk de escritura se ejecutan item por item, devuelven reportes de exito parcial y soportan idempotencia por item con clientRequestId para reintentos seguros. Mantén los batches pequeños y deterministas.

Tools de lectura

Tools de lectura de Kanban Studio MCP con scopes, argumentos y notas de autorizacion
Tool	Scope	Propósito	Argumentos	Autorización
list_boards	boards:read	Lista los tableros disponibles para el propietario de la API key.		Requiere acceso al tablero para cada tablero devuelto.
get_board	boards:read	Obtiene los detalles del tablero por boardId.	boardId: string	Requiere rol viewer o superior en el tablero.
list_lists	boards:read	Lista todas las listas de un tablero.	boardId: string	Requiere rol viewer o superior en el tablero.
list_cards	cards:read	Lista tarjetas de un tablero con límite opcional.	boardId: string limit?: number	Requiere rol viewer o superior en el tablero.
get_card	cards:read	Obtiene el detalle completo de una tarjeta por cardId.	cardId: string	Requiere rol viewer o superior en el tablero de la tarjeta.
list_checklist_items	cards:read	Lista los items de checklist y sus metricas de avance en una tarjeta.	cardId: string	Requiere rol viewer o superior en el tablero de la tarjeta.

Tools de escritura

Tools de escritura de Kanban Studio MCP con scopes, argumentos y notas de autorizacion
Tool	Scope	Propósito	Argumentos	Autorización
create_list	boards:write	Crea una lista en un tablero.	boardId: string title: string isDoneList?: boolean	Requiere rol editor o superior en el tablero.
move_list	boards:write	Mueve una lista a un índice objetivo dentro del mismo tablero.	boardId: string listId: string targetIndex: number	Requiere rol editor o superior en el tablero.
create_card	cards:write	Crea una tarjeta en una lista de destino.	boardId: string listId: string title: string description?: string recurrence?: { frequency: 'daily' \| 'weekly' \| 'monthly'; hour: number; dayOfWeek?: number; dayOfMonth?: number; targetListId?: string; timezone: string }	Requiere rol editor o superior en el tablero.
update_card	cards:write	Actualiza campos y estado de la tarjeta.	cardId: string title?: string description?: string listId?: string done?: boolean recurrence?: { frequency: 'daily' \| 'weekly' \| 'monthly'; hour: number; dayOfWeek?: number; dayOfMonth?: number; targetListId?: string; timezone: string } \| null	Requiere rol editor o superior en el tablero de la tarjeta.
move_card	cards:write	Mueve una tarjeta a otra lista dentro del mismo tablero.	cardId: string listId: string order?: number	Requiere rol editor o superior en el tablero de la tarjeta.
archive_card	cards:write	Archiva una tarjeta completada.	cardId: string	Requiere rol editor o superior en el tablero de la tarjeta.
add_comment	comments:write	Añade un comentario a una tarjeta.	cardId: string text: string	Requiere rol editor o superior en el tablero de la tarjeta.
add_checklist_item	cards:write	Anade un item de checklist a una tarjeta.	cardId: string text: string index?: number	Requiere rol editor o superior en el tablero de la tarjeta.
update_checklist_item	cards:write	Actualiza el texto de un item de checklist por indice.	cardId: string index: number text: string	Requiere rol editor o superior en el tablero de la tarjeta.
set_checklist_item_checked	cards:write	Marca un item de checklist como hecho o pendiente por indice.	cardId: string index: number checked: boolean	Requiere rol editor o superior en el tablero de la tarjeta.
remove_checklist_item	cards:write	Elimina un item de checklist por indice.	cardId: string index: number	Requiere rol editor o superior en el tablero de la tarjeta.
clear_checklist	cards:write	Elimina todos los items de checklist de una tarjeta.	cardId: string	Requiere rol editor o superior en el tablero de la tarjeta.
bulk_create_cards	cards:write	Crea varias tarjetas con reporte de éxitos y errores por item.	boardId: string defaultListId?: string items: Array<{ clientRequestId?: string; listId?: string; title: string; description?: string }>	Requiere rol editor o superior en el tablero objetivo. Cada item debe resolver a una lista del mismo tablero.
bulk_update_cards	cards:write	Actualiza, comenta y archiva varias tarjetas con manejo de éxitos parciales.	boardId?: string items: Array<{ clientRequestId?: string; cardId: string; listId?: string; done?: boolean; recurrence?: { frequency: 'daily' \| 'weekly' \| 'monthly'; hour: number; dayOfWeek?: number; dayOfMonth?: number; targetListId?: string; timezone: string } \| null; startDate?: number \| null; dueDate?: number \| null; archiveIfDone?: boolean; comment?: string }>	Requiere rol editor o superior en el tablero de cada tarjeta objetivo. `boardId` opcional restringe el batch a un solo tablero.