Claude Code vragen stellen over je gamedata met MCP

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten tools in andere diensten kunnen aanroepen. Game Stats AI host een MCP-server, zodat Claude Code je rapporten kan lezen en vragen over je game in gewone taal kan beantwoorden.

Om te laten zien hoe dat eruitziet, hebben we Claude Code verbonden met een voorbeeld-vechtgame met zes personages en 600 matches verdeeld over twee versies, 1.0.0 en 1.1.0. De game stuurt elke match naar het matches-endpoint met een waarde voor win en loss per speler, en een personagerapport maakt daar een winrate per personage van.

Stap 1: maak een servertoken aan

Voor het lezen van rapporten heb je een server-token nodig. Een client-token kan alleen telemetrie versturen, dus de MCP-server weigert het. Kies bij Instellingen > API-tokens voor Server wanneer je het token aanmaakt.

Een servertoken kan alle rapporten in je account lezen, dus houd het op je eigen computer en neem het nooit op in een build van je game. Het token hoort bij één account, dus Claude kan alleen de rapporten van dat account lezen en je hoeft nooit een account-id mee te geven.

Stap 2: voeg de server toe aan Claude Code

Voer dit uit in de projectmap waar je Claude Code gebruikt, met je eigen token in plaats van YOUR_SERVER_TOKEN:

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

Claude Code slaat de server en het token op in zijn eigen configuratie, niet in je projectbestanden, dus er komt niets in je repository terecht.

Stap 3: controleer de verbinding

Toon je MCP-servers om te bevestigen dat Claude Code Game Stats AI kan bereiken:

claude mcp list

De Game Stats AI-server hoort als verbonden te staan:

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

Stap 4: stel een vraag

Stel Claude Code een vraag over je game zoals je die aan een teamgenoot zou stellen. In de voorbeeldgame maakte versie 1.1.0 een personage genaamd Volt zwakker, dus vroegen we:

Is de winrate van Volt veranderd tussen versie 1.0.0 en 1.1.0 van onze game?

Claude haalde de versies van de game op om hun id's te vinden, zocht het personagerapport en las dat rapport twee keer: één keer gefilterd op 1.0.0 en één keer gefilterd op 1.1.0. Het antwoordde met de cijfers uit het rapport:

Claude voegde eraan toe dat Volt in 1.0.0 de hoogste winrate van alle personages had en in 1.1.0 rond de 50% zit, in lijn met de rest van de selectie.

Stap 5: stel vervolgvragen

Elke vraag kan voortbouwen op dezelfde rapporten. We vroegen:

Welk personage is het zwakst in onze nieuwste versie, en op hoeveel potjes is dat gebaseerd?

Claude las het personagerapport gefilterd op 1.1.0 en noemde Gale, met een winrate van 45.0% over 100 potjes (45 gewonnen, 55 verloren). Het wees er ook op dat 100 potjes een kleine steekproef is, zodat het verschil met 50% nog toeval kan zijn, en raadde aan opnieuw te kijken zodra er meer data van 1.1.0 is voordat je het personage aanpast.

Wat Claude wel en niet kan

De MCP-server geeft Claude dezelfde alleen-lezen tools als de assistent in de app. Claude kan je rapporten ophalen en uitvoeren met filters zoals versie en periode, spelers, personages, achievements en versies opzoeken, en ruwe matches en events tellen, uitsplitsen of in de tijd uitzetten over elke periode. Resultaten linken naar de bijbehorende pagina in Game Stats AI.

Claude kan geen events versturen, geen rapporten aanmaken of bewerken en niets in je account wijzigen. Voor percentages en uitsplitsingen met meerdere metrics gebruikt Claude de rapporten die je al hebt ingesteld, dus als geen enkel rapport een vraag dekt, maak dat rapport dan eerst aan en stel de vraag daarna opnieuw.