.md

Configuración MCP

Cómo instalar las skills del Race Engineer y conectar el MCP de Braking Lab a tu asistente de IA.

El Race Engineer se conecta a tu cuenta de Braking Lab mediante el Model Context Protocol (MCP). Las nueve skills del Race Engineer guían tareas habituales como comparar vueltas, evaluar setups o gestionar carreras. Puedes seguir usando las demás acciones del MCP aunque no tengan una skill específica.

Si buscas herramientas de navegador para la página abierta sin configurar el servidor, consulta WebMCP en el navegador.

Plugin de Claude Code

Instala el plugin nativo con el gestor de plugins de Claude Code:

claude plugin marketplace add r-bart/braking-lab-agent-skills
claude plugin install braking-lab-race-engineer@braking-lab

Abre una sesión nueva de Claude Code, ejecuta /mcp y conecta tu cuenta de Braking Lab. El plugin contiene las nueve skills y la conexión MCP. Se ha verificado una instalación limpia desde el marketplace público; todavía falta validar una respuesta de Claude Code basada en datos de la cuenta.

Claude chat

Si tu cuenta de Claude permite subir plugins, descarga el ZIP del plugin de Claude. En Claude, abre Personalizar → Plugins → Agregar plugin → Subir plugin e importa el ZIP. Después conecta tu cuenta de Braking Lab desde Conectores. La importación y OAuth se verificaron en una cuenta; falta comprobar la primera respuesta basada en datos.

ChatGPT

La ficha pública de ChatGPT sigue en preparación. Si tu cuenta permite añadir conectores MCP personalizados en el Modo Desarrollador, puedes usar https://mcp.brakinglab.com/mcp y autorizar tu cuenta de Braking Lab. Consulta el estado actual de ChatGPT.

Codex, Cursor y otros agentes locales

Usa el CLI de Skills para elegir agente, ubicación y skills:

npx skills add r-bart/braking-lab-agent-skills

El CLI instala las skills, pero no configura el MCP. En Codex, ejecuta codex mcp add braking-lab --url https://mcp.brakinglab.com/mcp y después codex mcp login braking-lab. En Cursor u otro agente, añade https://mcp.brakinglab.com/mcp como servidor MCP Streamable HTTP y completa OAuth allí. El CLI funciona en Windows, macOS y Linux con Node.js y npm. No instala nada en ChatGPT web.

En macOS o Linux también puedes usar el instalador opcional sin Node.js. Instala las skills y configura el MCP en Codex o Claude Code cuando encuentra sus CLI. Ninguna de las dos vías pide tu contraseña ni un token de Braking Lab.

Conectar otro cliente MCP manualmente

Usa esta URL en un cliente compatible con MCP Streamable HTTP y OAuth 2.0 con PKCE:

https://mcp.brakinglab.com/mcp

Sigue el flujo de conexión de ese cliente para autorizar tu cuenta. Puedes instalar las skills por separado donde el cliente lo permita. 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