Badgie tiene un servidor MCP oficial que conecta Claude, ChatGPT, OpenClaw o Cursor con los datos de tu club, con inicio de sesión OAuth 2.1 y permisos según tu rol (escuela, profesor o alumno). Ofrece más de 120 herramientas para consultar y operar el club, y la Badgie CLI (el paquete @badgie/cli en npm) usa ese mismo servidor para hacerlo desde la terminal.
Qué es MCP y por qué importa a un club deportivo
MCP (Model Context Protocol) es el estándar abierto con el que los asistentes de IA se conectan a herramientas externas. En vez de copiar y pegar datos del club en un chat, el asistente pide permiso, inicia sesión en Badgie y consulta directamente lo que necesita: alumnos, calendario, insignias, informes, finanzas o equipos de fútbol.
Para un director esto significa poder preguntar en lenguaje natural, desde el asistente que ya usa en el día a día, cosas como "¿qué alumnos de la clase de los martes llevan tres semanas sin venir?" o "prepárame la lista de convocados del sábado", y obtener la respuesta con los datos reales del club, no con una suposición.
Badgie lanzó su servidor MCP en julio de 2026 y, al día siguiente, la Badgie CLI, el cliente oficial de terminal construido sobre él. Desde entonces ambos se han ido ampliando con nuevas herramientas, la última tanda a finales de septiembre de 2026.
El servidor MCP de Badgie
Inicio de sesión seguro con OAuth 2.1
El servidor usa OAuth 2.1 sobre la autenticación de Badgie. Cuando conectas un asistente, se abre una pantalla de consentimiento de Badgie: inicias sesión con tu cuenta y autorizas el acceso. No hay que compartir contraseñas con el asistente ni generar claves a mano.
Permisos según tu rol
Lo que ve y puede hacer el asistente depende de quién eres en el club:
- Escuela (dueño o director): acceso a la gestión completa del club.
- Profesor: lo que corresponde a sus grupos y alumnos.
- Alumno: sus propios datos.
El servidor no amplía permisos: un profesor conectado a Claude ve en Claude lo mismo que vería en Badgie.
Más de 120 herramientas por dominio
El servidor ofrece más de 120 herramientas organizadas por dominio (alumnos, calendario, insignias, finanzas, reservas, golf, artes marciales, fútbol y otros). A esto se suma un catálogo de acciones de escritura que el agente puede proponer, de modo que los cambios importantes pasan por tu aprobación en lugar de ejecutarse sin control.
En fútbol, por ejemplo, el dueño del club puede consultar la plantilla de un equipo, dar de alta a un jugador, crear un equipo o importar un acta de partido desde el asistente. Más detalle en la página de Badgie MCP.
La Badgie CLI: el club desde la terminal
La Badgie CLI es el cliente oficial de línea de comandos. Está publicada en npm como @badgie/cli, funciona en macOS, Linux y Windows y necesita Node 20 o superior. Se puede usar sin instalar nada con npx.
Los comandos principales son:
- login: inicia sesión con OAuth 2.1, igual que un asistente de IA.
- whoami: muestra con qué cuenta y rol estás conectado.
- tools: lista las herramientas disponibles para tu rol.
- run: ejecuta una herramienta concreta; con la opción --json devuelve el resultado en JSON para encadenarlo con otros scripts.
- chat: abre una conversación interactiva (REPL) con el club.
- update y logout: actualizan la CLI y cierran la sesión.
Para quién es la CLI
La CLI está pensada para perfiles técnicos: el responsable de sistemas de una federación, el coordinador que prepara informes cada lunes o el desarrollador que integra Badgie en sus propios procesos. Con run y --json se pueden automatizar consultas periódicas sin abrir el navegador. Tienes más información en la página de la Badgie CLI.
Cómo encaja con el agente de Badgie
El MCP y la CLI son dos puertas más al mismo motor que mueve a Badgie Agéntico, el agente IA integrado en la plataforma. El agente vive en la web y en la app; el MCP lo lleva al asistente que tú elijas, y la CLI, a la terminal. Las reglas son las mismas en todas las superficies: lo que escribe en el club se propone y se aprueba, y lo que afecta a menores nunca se ejecuta en automático.
Si prefieres no salir de Badgie, el equipo de agentes IA hace el mismo trabajo dentro de la plataforma y de la app.
Ejemplos de uso
- Un director pregunta en Claude qué cuotas quedan pendientes este mes y pide un resumen por grupo.
- Un coordinador de fútbol consulta desde ChatGPT la clasificación y los máximos goleadores de sus equipos.
- Un profesor revisa en Cursor o en la terminal las insignias que ha concedido esta semana.
- Un técnico programa un script que ejecuta cada lunes una herramienta con run --json y guarda el resultado.
Dónde está en Badgie
- MCP: servidor oficial por HTTP en streaming, con OAuth 2.1 y permisos por rol, para Claude, ChatGPT, OpenClaw o Cursor.
- CLI: @badgie/cli en npm, con login, whoami, tools, run, chat, update y logout.
- Web: páginas de MCP y CLI con instrucciones de conexión, y la pantalla de consentimiento al autorizar.
- Agente IA: el mismo conjunto de herramientas que usa Badgie Agéntico dentro de la plataforma.
Preguntas frecuentes
¿Puedo conectar ChatGPT o Claude a los datos de mi club deportivo?
Sí. Badgie tiene un servidor MCP oficial al que se conectan Claude, ChatGPT, OpenClaw o Cursor. Inicias sesión con tu cuenta de Badgie mediante OAuth 2.1 y el asistente accede solo a lo que permite tu rol.
¿Un profesor ve lo mismo que el director?
No. Los permisos dependen del rol: escuela, profesor o alumno. El asistente hereda exactamente los permisos que esa persona tiene en Badgie.
¿Qué necesito para usar la Badgie CLI?
Node 20 o superior en macOS, Linux o Windows. Se ejecuta con npx @badgie/cli, inicias sesión con login y ya puedes listar herramientas con tools o ejecutarlas con run.
¿El asistente puede cambiar datos del club sin mi permiso?
Las acciones de escritura se proponen para que las apruebes, y lo que afecta a menores nunca se ejecuta en automático.
