Saltar al contenido principal

Clientes

Cualquier cliente que hable Streamable HTTP MCP y sepa hacer el flujo OAuth 2.1 del MCP puede conectarse. Solo indicas la URL; el cliente descubre solo dónde autenticarse, abre el inicio de sesión de Kobana en el navegador y guarda el token — ver Autenticación.

Un cliente sin soporte de OAuth también se conecta, con un token personal: créalo en Cuenta Kobana → Tokens y Acceso → Nuevo Token Personal, con la app Dashboard Mágico y el uso MCP, y configura el cliente para enviarlo en la cabecera Authorization: Bearer <token>.

Claude Code​

claude mcp add --transport http kobana-dashboards https://mcp.dashboards.kobana.com.br

Después, ejecuta /mcp en una sesión y elige Authenticate para iniciar sesión en Kobana.

Con un token personal, sin flujo OAuth:

claude mcp add --transport http kobana-dashboards https://mcp.dashboards.kobana.com.br \
  --header "Authorization: Bearer <token personal>"

Clientes configurados por archivo​

Los clientes que leen un archivo JSON de configuración piden la URL y el transporte. Por el flujo OAuth no hay cabecera de autenticación:

{
  "mcpServers": {
    "kobana-dashboards": {
      "type": "http",
      "url": "https://mcp.dashboards.kobana.com.br"
    }
  }
}

En la primera conexión el cliente abre el navegador para que autorices. No hay cabecera de selección de organización: eliges la organización en la pantalla de consentimiento, y queda grabada en el token.

Con un token personal, agrega la cabecera — la organización es la de la cuenta en la que creaste el token:

{
  "mcpServers": {
    "kobana-dashboards": {
      "type": "http",
      "url": "https://mcp.dashboards.kobana.com.br",
      "headers": { "Authorization": "Bearer <token personal>" }
    }
  }
}

Trata el archivo como secreto: quien lo lee usa el token.

Clientes que conectan por URL​

Claude y ChatGPT conectan un servidor remoto pegando la URL https://mcp.dashboards.kobana.com.br en la configuración de conectores. El flujo OAuth corre dentro de la propia app.

Postura recomendada para agentes​

  • Autoriza con la cuenta correcta. Las tools se estrechan a los permisos de dashboard de quien autorizó el cliente. Un cliente autorizado por un analista de solo lectura expone solo las tools de lectura, haga lo que haga el modelo del otro lado. Es la forma más fuerte de restringir un agente.
  • Un token por cliente. Cada cliente hace su propio flujo y recibe su propio token, que solo vale en el MCP — no sirve para llamar a la API REST. Para apagar un agente, quita su autorización en Kobana sin afectar tus integraciones.
  • Token personal: validez corta y alcance mínimo. Marca solo los recursos y accesos que el agente necesita, y la validez más corta que el uso permita: revocar el token en Kobana no corta el acceso antes del vencimiento — ver Revocación del token personal.
  • Empieza en sandbox. Las tools destructivas suspenden cuentas, borran registros y envían invitaciones de verdad; el servidor pide confirmación antes de cada una (y las rechaza a un cliente que no puede confirmar), pero la primera exploración no debe ser en producción.

Verificando la conexión​

La forma más simple es preguntarle al asistente: "¿qué organización estoy usando en Dashboard Mágico?" — llama a dashboards_organization_get.

Con un token emitido para el MCP — un token personal con uso MCP, por ejemplo —, puedes comprobarlo con curl:

# 1. ¿Qué organización alcanza este token?
curl -s https://mcp.dashboards.kobana.com.br/ \
  -H "Authorization: Bearer $MCP_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"dashboards_organization_get","arguments":{}}}'

# 2. ¿Cuántas tools alcanza este token?
curl -s https://mcp.dashboards.kobana.com.br/ \
  -H "Authorization: Bearer $MCP_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | jq '.result.tools | length'

Si el número es menor de lo que esperabas, son los permisos de quien autorizó o el alcance del token — ver Autenticación. No es un error.