Configuración MCP

Cómo conectar Claude Desktop u otros clientes MCP al Race Engineer de Braking Lab.

El Race Engineer se conecta a través del Model Context Protocol (MCP) usando transporte HTTP Streamable con autenticación OAuth 2.0. La configuración tarda menos de 5 minutos.

Claude Desktop

El cliente recomendado es Claude Desktop, que soporta MCP de forma nativa.

Paso 1: Abrir Configuración

En Claude Desktop, ve a Configuración > Desarrollador > Editar Config para abrir claude_desktop_config.json.

Paso 2: Añadir el Servidor

Añade lo siguiente a tu configuración:

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

Paso 3: Autenticarse

  1. Guarda la configuración y reinicia Claude Desktop
  2. Claude detectará las herramientas del Race Engineer automáticamente
  3. En el primer uso, se abre una ventana del navegador para autenticación
  4. Inicia sesión con tu cuenta de Braking Lab (email/contraseña, Google o GitHub)
  5. Una vez autenticado, la conexión queda establecida

Eso es todo. Ahora puedes preguntarle a Claude sobre tus datos de telemetría, solicitar informes de coaching o prepararte para carreras.

Cómo funciona la autenticación

Claude Desktop descubre los endpoints OAuth automáticamente a través de protocolos de descubrimiento estándar (RFC 9728 y RFC 8414). No necesitas gestionar tokens ni claves API — el cliente lo maneja todo.

Cursor

Cursor tiene soporte MCP integrado:

  1. Abre Configuración > MCP
  2. Añade un nuevo servidor con URL: https://mcp.brakinglab.com/mcp
  3. Guarda y autentícate cuando se te solicite

Windsurf

Windsurf soporta conexiones MCP:

  1. Abre la configuración MCP en ajustes
  2. Añade la URL del servidor: https://mcp.brakinglab.com/mcp
  3. Autentícate a través del navegador cuando se te solicite

Otros Clientes MCP

Cualquier cliente que soporte transporte HTTP Streamable de MCP y OAuth 2.0 con PKCE puede conectarse. La URL del servidor es:

https://mcp.brakinglab.com/mcp

El servidor publica endpoints de descubrimiento estándar:

  • /.well-known/oauth-protected-resource — Metadatos del recurso (RFC 9728)
  • /.well-known/oauth-authorization-server — Metadatos del servidor de autorización (RFC 8414)

Tu cliente debería manejar el flujo OAuth automáticamente si soporta estos estándares.

Flujo OAuth (Referencia Técnica)

Para desarrolladores que construyen clientes personalizados, aquí está el flujo completo de autenticación:

1. Cliente → POST /mcp (sin token)
   ← 401 + cabecera WWW-Authenticate con URL de resource_metadata

2. Cliente → GET /.well-known/oauth-protected-resource
   ← Devuelve URL de authorization_servers

3. Cliente → GET /.well-known/oauth-authorization-server
   ← Devuelve authorization_endpoint, token_endpoint, registration_endpoint

4. Cliente → POST /oauth/register (registro dinámico de cliente)
   ← Devuelve client_id y client_secret

5. Cliente → GET /oauth/authorize (con code_challenge PKCE)
   → Abre navegador: usuario inicia sesión via Supabase auth
   ← Devuelve código de autorización

6. Cliente → POST /oauth/token (intercambio code + code_verifier)
   ← Devuelve access_token + refresh_token

7. Cliente → POST /mcp (con Bearer access_token)
   ← Respuesta MCP con resultados de herramientas

El access token es un JWT que identifica al usuario. El refresh token permite re-autenticación silenciosa cuando expira el access token.

Solución de Problemas

”Conexión fallida” o Timeout

  • Verifica que la URL sea exactamente https://mcp.brakinglab.com/mcp
  • Comprueba tu conexión a internet
  • Reinicia el cliente MCP

La autenticación sigue pidiendo iniciar sesión

  • Borra los tokens almacenados del cliente y autentícate de nuevo
  • Verifica que tu cuenta de Braking Lab esté activa
  • Comprueba que los pop-ups del navegador no estén bloqueados

Las herramientas no aparecen

  • Reinicia el cliente MCP después de guardar la configuración
  • Revisa los logs MCP del cliente para errores de conexión
  • Verifica que la URL del servidor no tenga una barra diagonal al final

Siguientes pasos