Saltar al contenido principal

Introducción

El servidor MCP de Dashboard Mágico es un servidor Model Context Protocol remoto que expone las operaciones de la API pública — organización, usuarios del portal y equipo — como tools que un cliente de IA puede llamar. Lo conectas por URL; no hay nada que instalar.

Se sirve en host propio, mcp.dashboards.kobana.com.br, con transporte Streamable HTTP en modo stateless y autenticación por Bearer token. No hay certificado de cliente involucrado.

:::info Disponibilidad El servidor y sus 292 tools están implementados, y la autenticación pasa por el authorization server de Kobana: por el flujo OAuth 2.1, en el que el cliente recibe solo la URL e inicia sesión solo, o por un token personal creado en tu cuenta Kobana. El edge dedicado (distribución mcp.dashboards.*, WAF y DNS) aún se está aprovisionando. :::

Cuándo usarlo​

API REST (/v1)Servidor MCP (este)
Consumidortu backendun cliente de IA (Claude, ChatGPT, un IDE)
Configuraciónun token, fuera de bandauna URL
TransporteHTTPS/RESTStreamable HTTP (JSON-RPC 2.0)
AutenticaciónBearer token emitido para la APIOAuth 2.1 o token personal, siempre emitido para el MCP
Superficie177 rutas292 tools sobre los mismos endpoints

El servidor MCP no reemplaza la API REST. Cada tool despacha in-process al endpoint que implementa la operación, así que filtros, reglas de upsert, validación, prorrateo y aislamiento por organización son exactamente los mismos. Si estás escribiendo código, usa la API REST. Si estás conectando un asistente, usa esto.

El principio​

Una capacidad existe en MCP solo si existe en la API pública.

No hay una segunda implementación de nada. La tool llama al handler del endpoint con la identidad que el token del llamador ya probó — la misma persona, la misma organización —, así que corre como correría para cualquier petición HTTP, y la auditoría que escribe se atribuye a quien autorizó el cliente. Una tool hace lo que el endpoint hace por REST — nunca más.

La consecuencia práctica: lo que hoy solo existe en el panel no se vuelve tool antes de volverse endpoint.

tools/list devuelve solo las tools que este llamador puede ejecutar, filtradas por los permisos de panel de quien autorizó el cliente. A un agente no se le informa de capacidades que solo le darían una negativa. Las reglas están en Autenticación.

Primeros pasos​

  1. Apunta tu cliente a la URL del servidor — ve Endpoints y Clientes.

  2. Autoriza. El cliente abre el inicio de sesión de Kobana; entra con una cuenta de la organización y autoriza el acceso. Ve Autenticación.

  3. Lista las tools para confirmar qué alcanza tu acceso — pídeselo al asistente, o, con un token emitido para el MCP a mano:

    curl https://mcp.dashboards.kobana.com.br/ \
      -H "Authorization: Bearer $MCP_TOKEN" \
      -H "Content-Type: application/json" \
      -H "Accept: application/json" \
      -H "MCP-Protocol-Version: 2025-06-18" \
      -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

  4. Explora la documentación — el catálogo completo está en Tools.

Próximos pasos​

  • Autenticación — el flujo OAuth, el token personal, el alcance y los permisos aplicados, y los modos de fallo.
  • Endpoints — URLs por ambiente y rutas servidas.
  • Transporte — JSON-RPC, cabeceras y métodos.
  • Resources y prompts — documentos por URI, guiones listos, autocompletado y la confirmación de tools destructivas.
  • Clientes — cómo conectar Claude Code y clientes por archivo.
  • Listado, orden y campos — page, sort_by, fields.
  • Errores — los dos canales de fallo, y por qué la diferencia importa.
  • Tools — el catálogo de las 292 tools.