Interroger Claude Code sur vos données de jeu avec MCP

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants d'IA d'appeler des outils dans d'autres services. Game Stats AI héberge un serveur MCP : Claude Code peut donc lire vos rapports et répondre à vos questions sur votre jeu en langage courant.

Pour montrer à quoi cela ressemble, nous avons connecté Claude Code à un jeu de combat d'exemple avec six personnages et 600 matchs répartis sur deux versions, 1.0.0 et 1.1.0. Le jeu envoie chaque match à l'endpoint des matchs avec une valeur win et loss pour chaque joueur, et un rapport de personnages en tire un taux de victoire pour chaque personnage.

Étape 1 : créer un token serveur

La lecture des rapports exige un token serveur. Un token client ne peut qu'envoyer de la télémétrie, le serveur MCP le refuse donc. Dans Paramètres > Tokens API, choisissez « Server » au moment de créer le token.

Un token serveur peut lire tous les rapports de votre compte : gardez-le sur votre propre machine et ne l'embarquez jamais dans un build du jeu. Le token appartient à un seul compte, Claude ne peut donc lire que les rapports de ce compte, et vous n'avez jamais besoin de fournir un identifiant de compte.

Étape 2 : ajouter le serveur à Claude Code

Exécutez cette commande dans le dossier du projet où vous utilisez Claude Code, en remplaçant YOUR_SERVER_TOKEN par votre token :

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

Claude Code enregistre le serveur et le token dans sa propre configuration, pas dans les fichiers de votre projet : rien n'est ajouté à votre dépôt.

Étape 3 : vérifier la connexion

Listez vos serveurs MCP pour confirmer que Claude Code peut joindre Game Stats AI :

claude mcp list

Le serveur Game Stats AI doit apparaître comme connecté :

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

Étape 4 : poser une question

Interrogez Claude Code sur votre jeu comme vous le feriez avec un collègue. Dans le jeu d'exemple, la version 1.1.0 a affaibli un personnage nommé Volt, nous avons donc demandé :

Le taux de victoire de Volt a-t-il changé entre la version 1.0.0 et la version 1.1.0 de notre jeu ?

Claude a listé les versions du jeu pour trouver leurs identifiants, a trouvé le rapport de personnages, puis l'a lu deux fois : une fois filtré sur 1.0.0 et une fois filtré sur 1.1.0. Il a répondu avec les chiffres du rapport :

Il a ajouté que Volt avait le meilleur taux de victoire de tous les personnages en 1.0.0 et qu'il se situe autour de 50 % en 1.1.0, comme le reste du roster.

Étape 5 : poser des questions de suivi

Chaque question peut s'appuyer sur les mêmes rapports. Nous avons demandé :

Quel est le personnage le plus faible dans notre dernière version, et sur combien de parties cela repose-t-il ?

Claude a lu le rapport de personnages filtré sur 1.1.0 et a désigné Gale, avec un taux de victoire de 45,0 % sur 100 parties (45 victoires, 55 défaites). Il a aussi signalé que 100 parties forment un petit échantillon, donc l'écart avec 50 % pourrait encore relever du hasard, et a suggéré de vérifier à nouveau avec davantage de données 1.1.0 avant de modifier le personnage.

Ce que Claude peut faire et ne peut pas faire

Le serveur MCP donne à Claude les mêmes outils en lecture seule que l'assistant intégré à l'application. Claude peut lister et exécuter vos rapports avec des filtres comme la version et la période, retrouver des joueurs, des personnages, des succès et des versions, et compter, ventiler ou suivre dans le temps les matchs et les événements bruts sur n'importe quelle période. Les résultats renvoient vers la page correspondante dans Game Stats AI.

Il ne peut pas envoyer d'événements, créer ou modifier des rapports, ni changer quoi que ce soit dans votre compte. Pour les taux et les ventilations sur plusieurs métriques, Claude s'appuie sur les rapports que vous avez déjà configurés : si aucun rapport ne couvre une question, créez d'abord ce rapport, puis posez-la à nouveau.