Setup y Conexión

Conecta tu cliente IA al Servidor MCP de Braking Lab con instrucciones paso a paso.

El Servidor MCP usa OAuth 2.0 con PKCE para autenticación. La mayoría de clientes IA lo manejan automáticamente — solo pegas la URL del servidor y autorizas con tu cuenta de Braking Lab.

URL del Servidor

https://mcp.brakinglab.com/mcp

Claude Desktop

  1. Abre los ajustes de Claude Desktop
  2. Ve a MCP Servers
  3. Haz click en Add Server y pega la URL del servidor
  4. Cuando te lo pida, autoriza con tu cuenta de Braking Lab
  5. Empieza a chatear — Claude ahora tiene acceso a tus datos de carrera

Archivo de configuración (claude_desktop_config.json):

{
  "mcpServers": {
    "braking-lab": {
      "url": "https://mcp.brakinglab.com/mcp"
    }
  }
}

Cursor

  1. Abre Settings → MCP
  2. Haz click en Add new MCP server
  3. Establece el tipo a streamable-http
  4. Pega la URL del servidor: https://mcp.brakinglab.com/mcp
  5. Autoriza cuando se abra la ventana de OAuth

Windsurf

  1. Abre Settings → MCP Servers
  2. Añade un nuevo servidor con la URL: https://mcp.brakinglab.com/mcp
  3. Completa el flujo de autorización OAuth

ChatGPT

ChatGPT soporta conexiones MCP directas mediante el Modo Desarrollador (cuentas Pro, Plus, Business, Enterprise o Education).

  1. Abre Settings → Apps → Advanced settings
  2. Activa el Modo Desarrollador (Developer mode)
  3. Ve a Settings → Connectors
  4. Haz clic en Create y pega la URL del servidor: https://mcp.brakinglab.com/mcp
  5. Sigue el flujo OAuth para autorizar con tu cuenta de Braking Lab
  6. Inicia una nueva conversación — ChatGPT ahora tiene acceso a tus datos de carrera

Clientes Personalizados

El servidor implementa endpoints de descubrimiento estándar:

EndpointPropósito
/.well-known/oauth-authorization-serverMetadata OAuth (RFC 8414)
/.well-known/oauth-protected-resourceMetadata de recurso (RFC 9728)
/oauth/registerRegistro dinámico de cliente
/oauth/authorizeEndpoint de autorización
/oauth/tokenEndpoint de token

Cualquier cliente MCP que siga el estándar puede descubrir y conectarse automáticamente.

Flujo de Autenticación

  1. El cliente se registra vía /oauth/register (una vez, automático)
  2. Authorization Code + PKCE: el cliente redirige a la página de consentimiento de Braking Lab
  3. El usuario aprueba: concede acceso de la IA a sus datos
  4. Intercambio de token: el cliente recibe access + refresh tokens
  5. Conexión MCP: el cliente llama a POST /mcp con Bearer token

Los tokens se renuevan automáticamente. Solo necesitas autorizar una vez por cliente.

Solución de Problemas

Errores “Unauthorized” o 401

  • Re-autoriza tu cliente IA — tu token puede haber expirado
  • Verifica que estás usando la URL correcta del servidor (con path /mcp)

“Connection refused”

”No data found”

  • Asegúrate de tener sesiones de telemetría sincronizadas vía Capture
  • El Servidor MCP solo accede a datos de tu cuenta autenticada

La IA no encuentra herramientas

  • Algunos clientes cachean las definiciones de herramientas. Intenta desconectar y reconectar
  • Verifica que el servidor aparece como activo en los ajustes MCP de tu cliente