Intégration IA & MCP
Connectez des assistants IA à vos parties de Killer grâce au Model Context Protocol (MCP).
Qu'est-ce que MCP ?
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux clients IA de découvrir et d'appeler des outils exposés par un serveur. Notre API implémente MCP sur/mcp afin que des assistants comme Claude, Cursor ou Mistral puissent créer des parties, ajouter des joueurs, lancer des jeux, etc.Point d'accès
Le point d'accès MCP se trouve sur l'origine de l'API. Si vous auto-hébergez, adaptez le nom de domaine.Production
https://api.the-killer.online/mcpDéveloppement
http://localhost:3001/mcpAuthentification
Les outils d'administration nécessitent le private_token de la partie. Transmettez-le dans l'en-têteAuthorization exactement comme il est retourné lors de la création. Le token est une chaîne simple (sans préfixe Bearer).Créez d'abord une partie avec
create_game (pas d'authentification) pour obtenir un private_token.Outils disponibles
Ces outils sont exposés par le serveur MCP. Ceux qui modifient des données nécessitent le token privé de la partie.create_gameCréer une nouvelle partie (sans auth).get_gameLire une partie. Le dossier complet uniquement avec un token valide.update_gameRenommer ou reprogrammer une partie.start_gameDémarrer une partie maintenant (besoin d'au moins 2 joueurs).delete_gameSupprimer une partie et tous ses joueurs.list_playersLister les joueurs d'une partie.add_playerAjouter un joueur à une partie.update_playerMettre à jour le nom ou l'action d'un joueur.remove_playerRetirer un joueur d'une partie.
Configuration selon votre fournisseur d'IA
La plupart des clients MCP acceptent un serveur HTTP(S) lorsque vous fournissez l'URL du point d'accès et un en-têteAuthorization statique. Choisissez votre client ci-dessous et copiez la configuration correspondante. Remplacez YOUR_GAME_PRIVATE_TOKEN par le token privé de la partie à gérer.Claude Code
Claude Code prend en charge les serveurs MCP HTTP distants. Ajoutez-le depuis la ligne de commande ou écrivez l'entrée directement dans le
.mcp.json du projet ou dans ~/.claude.json.{
"mcpServers": {
"killer-game": {
"type": "http",
"url": "https://api.the-killer.online/mcp",
"headers": {
"Authorization": "YOUR_GAME_PRIVATE_TOKEN"
}
}
}
}Claude Desktop
Claude Desktop attend actuellement un serveur
stdio ou SSE. Pour un point d'accès Streamable HTTP, utilisez un petit pont stdio comme mcp-remote.{
"mcpServers": {
"killer-game": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.the-killer.online/mcp",
"--header",
"Authorization:${MCP_AUTH_TOKEN}"
],
"env": {
"MCP_AUTH_TOKEN": "YOUR_GAME_PRIVATE_TOKEN"
}
}
}
}Cursor
Cursor détecte automatiquement le Streamable HTTP depuis un champ
url. Ajoutez l'entrée au .cursor/mcp.json du projet ou au ~/.cursor/mcp.json global.{
"mcpServers": {
"killer-game": {
"url": "https://api.the-killer.online/mcp",
"headers": {
"Authorization": "YOUR_GAME_PRIVATE_TOKEN"
}
}
}
}Mistral / Le Chat
Dans Le Chat ou Mistral Work, allez dans Connectors → Ajouter un connecteur → Connecteur MCP personnalisé, collez l'URL du serveur et choisissez l'authentification HTTP Bearer Token avec le token de votre partie.
Tout autre client MCP
Si votre client accepte un serveur MCP HTTP, configurez l'URL et un en-tête
Authorization. Pour les clients limités au stdio, faites transiter les requêtes via un pont local qui transmet le JSON-RPC au point d'accès HTTP.{
"url": "https://api.the-killer.online/mcp",
"headers": {
"Authorization": "YOUR_GAME_PRIVATE_TOKEN"
}
}Redémarrez votre client après avoir enregistré la configuration, puis approuvez le serveur lorsqu'il vous est proposé.