Pregúntale a Claude Code por los datos de tu juego con MCP

El Model Context Protocol (MCP) es un estándar abierto que permite que los asistentes de IA llamen herramientas de otros servicios. Game Stats AI aloja un servidor MCP, así que Claude Code puede leer tus reportes y responder preguntas sobre tu juego en lenguaje natural.

Para mostrar cómo se ve eso, conectamos Claude Code a un juego de pelea de ejemplo con seis personajes y 600 partidas en dos versiones, 1.0.0 y 1.1.0. El juego envía cada partida al endpoint de partidas con un valor win y loss para cada jugador, y un reporte de personajes convierte esos valores en una tasa de victoria para cada personaje.

Paso 1: crea un token de servidor

Para leer reportes se necesita un token server. Un token client solo puede enviar telemetría, así que el servidor MCP lo rechaza. En Configuración > Tokens de API, elige Server cuando crees el token.

Un token de servidor puede leer todos los reportes de tu cuenta, así que mantenlo en tu propio equipo y nunca lo incluyas dentro de un build del juego. El token pertenece a una sola cuenta, así que Claude solo puede leer los reportes de esa cuenta y nunca necesitas pasar un id de cuenta.

Paso 2: agrega el servidor a Claude Code

Ejecuta esto en el directorio del proyecto donde usas Claude Code, con tu token en lugar de YOUR_SERVER_TOKEN:

claude mcp add --transport http game-stats https://gamestats.ai/api/v1/mcp --header "Authorization: Bearer YOUR_SERVER_TOKEN"

Claude Code guarda el servidor y el token en su propia configuración, no en los archivos de tu proyecto, así que no se agrega nada a tu repositorio.

Paso 3: verifica la conexión

Lista tus servidores MCP para confirmar que Claude Code puede llegar a Game Stats AI:

claude mcp list

El servidor de Game Stats AI debería aparecer como conectado:

game-stats: https://gamestats.ai/api/v1/mcp (HTTP) - ✔ Connected

Paso 4: haz una pregunta

Pregúntale a Claude Code por tu juego como le preguntarías a alguien de tu equipo. En el juego de ejemplo, la versión 1.1.0 debilitó a un personaje llamado Volt, así que preguntamos:

¿Cambió la tasa de victoria de Volt entre la versión 1.0.0 y la 1.1.0 de nuestro juego?

Claude listó las versiones del juego para encontrar sus ids, encontró el reporte de personajes y luego leyó ese reporte dos veces: una filtrado a 1.0.0 y otra filtrado a 1.1.0. Respondió con los números del reporte:

Agregó que Volt tenía la tasa de victoria más alta de todos los personajes en 1.0.0 y que en 1.1.0 está cerca del 50%, en línea con el resto del elenco.

Paso 5: haz preguntas de seguimiento

Cada pregunta puede apoyarse en los mismos reportes. Preguntamos:

¿Cuál es el personaje más débil en nuestra última versión y en cuántas partidas se basa eso?

Claude leyó el reporte de personajes filtrado a 1.1.0 y nombró a Gale, con una tasa de victoria del 45.0% en 100 partidas (45 victorias, 55 derrotas). También señaló que 100 partidas son una muestra pequeña, así que la diferencia con el 50% todavía podría ser ruido, y sugirió revisar de nuevo cuando haya más datos de 1.1.0 antes de cambiar el personaje.

Qué puede y qué no puede hacer Claude

El servidor MCP le da a Claude las mismas herramientas de solo lectura que el asistente de la app. Claude puede listar y ejecutar tus reportes con filtros como la versión y el rango de fechas, buscar jugadores, personajes, logros y versiones, y contar, desglosar o graficar partidas y eventos en cualquier rango de fechas. Los resultados enlazan a la página correspondiente en Game Stats AI.

No puede enviar eventos, crear ni editar reportes, ni cambiar nada en tu cuenta. Para tasas y desgloses con varias métricas, Claude usa los reportes que ya configuraste, así que si ningún reporte cubre una pregunta, crea ese reporte primero y luego pregunta de nuevo.