Kanban Studio MCP
Conectar Kanban Studio MCP
Conecta tu herramienta de IA a Kanban Studio MCP y ejecuta tools de lectura/escritura con tus permisos reales.
Esta guia cubre la configuracion por plataforma usando OAuth (recomendado). Las API keys solo se usan en clientes legacy que no soportan OAuth.
Fallback legacy con API key (opcional)
Requisitos previos
- Cuenta de Kanban Studio con acceso a al menos un tablero.
- Cliente MCP con soporte OAuth.
- Una herramienta de IA con soporte MCP.
La mayoria de clientes MCP abren automaticamente el flujo OAuth (login + consentimiento).Codex
- Ejecuta este comando en tu terminal:
- Ejecuta /mcp en Codex y completa autenticacion.
codex mcp add --transport http kanbanstudio https://kanbanstudio.site/api/mcpClaude Code
- Ejecuta este comando en tu terminal:
- Ejecuta /mcp en Claude Code y completa autenticacion.
claude mcp add --transport http kanbanstudio https://kanbanstudio.site/api/mcpCursor
- Abre Cursor Settings -> MCP -> Add new global MCP server.
- Pega esta configuracion.
- Guarda y reinicia Cursor.
{
"mcpServers": {
"kanbanstudio": {
"url": "https://kanbanstudio.site/api/mcp"
}
}
}Cursor en macOS puede no cargar siempre bien las variables de entorno del shell. Si ves "needs authentication", usa Authorization directo como en el ejemplo.
VS Code (GitHub Copilot)
- Crea .vscode/mcp.json en tu workspace.
- Abre Command Palette y ejecuta MCP: List Servers.
- Inicia el servidor y autentica cuando lo pida.
{
"servers": {
"kanbanstudio": {
"type": "http",
"url": "https://kanbanstudio.site/api/mcp"
}
}
}Claude Desktop
- Abre Settings -> Connectors.
- Pulsa Add Connector y pega tu URL MCP.
- Completa el flujo de autenticacion.
https://kanbanstudio.site/api/mcpWindsurf
- Abre Windsurf Settings y busca MCP.
- Abre mcp_config.json en modo raw.
- Anade la config, guarda, reinicia y autentica.
{
"mcpServers": {
"kanbanstudio": {
"serverUrl": "https://kanbanstudio.site/api/mcp"
}
}
}Antigravity
Usa una entrada custom de MCP server apuntando a tu URL de Kanban Studio MCP.
Nota de compatibilidad (20 de marzo de 2026): si OAuth falla en Antigravity, usa el fallback legacy con API key mediante header Authorization Bearer. Guia legacy de API key.
{
"mcpServers": {
"kanbanstudio": {
"url": "https://kanbanstudio.site/api/mcp"
}
}
}Otras herramientas
Si tu herramienta soporta MCP remoto por HTTP, usa esta URL:
https://kanbanstudio.site/api/mcpFormato JSON de configuracion
{
"mcpServers": {
"kanbanstudio": {
"url": "https://kanbanstudio.site/api/mcp"
}
}
}Troubleshooting
- UNAUTHORIZED: revisa valor de key, expiracion y revocacion.
- FORBIDDEN: revisa scopes y rol en board/workspace.
- RATE_LIMITED: reintenta tras la ventana Retry-After.
FAQ
Necesito OAuth?
Si. OAuth es la via por defecto y recomendada. Las API keys quedan como fallback para clientes MCP legacy.
Como verifico rapido la conexion?
Lanza list_boards desde tu cliente MCP. Si devuelve boards, auth y permisos estan bien.