Servidor MCP de Badgie: conecta Claude, ChatGPT u OpenClaw a tu club
Cómo conectar un asistente de IA compatible con MCP (Claude, ChatGPT, OpenClaw, Cursor) a Badgie: URL del servidor, pasos por cliente, autorización OAuth 2.1, qué puede hacer cada rol y cómo se aprueban los cambios.
6 min de lecturaIntermedioActualizada el 2 de octubre de 2026
Respuesta rápida
El servidor MCP de Badgie es el conector oficial para que un asistente de IA compatible con MCP (Claude, ChatGPT, OpenClaw, Cursor y otros) opere tu club por chat. Añades la URL https://www.badgie.com/api/mcp/mcp en tu asistente, inicias sesión con tu cuenta de Badgie, apruebas el acceso (OAuth 2.1) y el asistente trabaja con tu rol: escuela, profesor o alumno y familia. Nunca ve datos de otra escuela.
En esta guía
Dónde está
- Página pública con las instrucciones: badgie.com/mcp (sección «Conectar»), con la política de privacidad del Badgie MCP enlazada al final.
- URL del servidor:
https://www.badgie.com/api/mcp/mcp(transporte HTTP en streaming). - Las propuestas que haga tu asistente se aprueban en el panel: Super Coach → Control → Pendientes.
Paso a paso: conectar tu asistente
- Copia la URL del servidor:
https://www.badgie.com/api/mcp/mcp. - Añádela en tu asistente:
- Claude (claude.ai): Ajustes → Conectores → Añadir conector personalizado, y pega la URL.
- Claude Code: en la terminal,
claude mcp add --transport http badgie https://www.badgie.com/api/mcp/mcp. - ChatGPT (planes de pago): Ajustes → Apps y conectores → Modo desarrollador → Añadir conector, y pega la URL.
- OpenClaw, Cursor y otros clientes MCP: añade a su configuración
{"mcpServers": {"badgie": {"url": "https://www.badgie.com/api/mcp/mcp", "transport": "http"}}}.
- Tu asistente abre el inicio de sesión de Badgie. Entra con la cuenta que usas en Badgie.
- En la pantalla de consentimiento ves qué aplicación pide acceso, con qué rol entrarás (Cuenta de escuela, Profesor/a o Alumno/a · Familia) y qué podrá hacer. Pulsa Aprobar.
- Pide primero «¿quién soy en Badgie?»: el asistente llama a
whoamiy te muestra tu rol, tu escuela y que las escrituras requieren tu aprobación. - A partir de ahí, pídele lo que necesites en lenguaje natural.
Qué puede hacer cada rol
- Cuenta de escuela (director): consultar cualquier dato del club (deuda, asistencia, riesgo de baja, MRR, ocupación de reservas), leer las guías de esta wiki, gestionar la memoria del club, el plan de marketing, Content Studio, el Playbook (reglas, voz, plantillas) y proponer cualquier acción de un catálogo de más de 200 acciones de escritura (
list_action_catalog,propose_action,list_my_proposals). - Profesor: sus clases de hoy y de la semana, sus alumnos y su progreso, pasar lista, conceder insignias, dejar notas de entrenamiento e informes pendientes.
- Alumno y familia: su perfil, insignias, horario, asistencia, informes, pagos y torneos, sus rondas y estadísticas de golf, sus marcas en ejercicios y el check-in de nutrición.
En total, más de 120 herramientas MCP.
Cómo se aprueban los cambios
Las acciones de escritura del director siguen la misma Delegación que el agente de la web:
- Área en Auto: la acción se ejecuta en el acto y el asistente te da el resultado.
- Área en Sugerir: queda como propuesta en Pendientes, donde la apruebas o la rechazas.
- Área en Off: se bloquea.
Seguridad y privacidad
- OAuth 2.1: inicias sesión en Badgie y apruebas el acceso; el asistente nunca ve tu contraseña.
- Cada conexión queda limitada a tu cuenta y a tu rol. Nunca alcanza datos de otra escuela ni de otro alumno.
- Puedes leer la política de privacidad del Badgie MCP en badgie.com/mcp/privacy.
Preguntas frecuentes
¿Badgie tiene una API REST pública o webhooks?
No. Badgie no ofrece una API REST pública con claves ni webhooks salientes. La vía para desarrolladores e integraciones es este servidor MCP y la Badgie CLI.
¿Con qué asistentes funciona?
Con cualquier cliente compatible con MCP: Claude (claude.ai y Claude Code), ChatGPT, OpenClaw, Cursor y otros.
¿Qué diferencia hay con el agente de dentro de Badgie?
El Badgie Agéntico vive dentro de la web y la app, con su equipo de especialistas y créditos. El servidor MCP deja que tu propio asistente use Badgie con tus permisos y la misma delegación.
¿Me aparece «Cuenta sin perfil Badgie»?
Has entrado con un correo que no está vinculado a ninguna escuela, profesor o alumno. Vuelve a conectar y entra con la cuenta que usas en Badgie.
¿La solicitud ha expirado?
La autorización tiene que empezar desde tu asistente. Si ves «La solicitud de autorización no existe o ha expirado», vuelve a iniciar la conexión desde él.