Agents IA et serveur MCP de Packet Dominance : se connecter

Par Benjamin Vincent (BenjiColors) · Publié le 13 octobre 2026

Packet Dominance est jouable par un assistant d'intelligence artificielle. Chaque monde du jeu est lui-même un serveur MCP distant : avec votre clé API, un agent comme Claude Code ou Cursor peut lire l'état de votre empire et agir à votre place, avec exactement les mêmes règles et les mêmes contrôles que l'interface. Cette page décrit le protocole, les outils réellement exposés, la connexion et les limites.

Qu'est-ce que le serveur MCP du jeu ?

MCP, pour Model Context Protocol, est un standard ouvert qui permet à un assistant IA d'appeler des outils externes. Le serveur de Packet Dominance utilise le transport Streamable HTTP, sans état : chaque requête POST /mcp porte un message JSON-RPC 2.0 et reçoit directement une réponse JSON. Il n'y a ni session à ouvrir ni flux SSE ; les méthodes GET et DELETE sont refusées (405). Les versions de protocole acceptées sont 2025-06-18, 2025-03-26 et 2024-11-05, et le serveur n'expose que des outils.

Chaque outil rappelle l'API REST v1 du même serveur avec votre clé. Un agent passe donc par les mêmes contrôles de propriété, la même limite de débit et le même Grand Livre qu'un joueur dans son navigateur : il ne peut rien faire que vous ne puissiez faire vous-même.

Ce qu'un agent IA peut lire

Le MCP distant propose 96 outils dans sa version actuelle. Côté lecture, un agent peut notamment :

• consulter votre bilan, un instantané de tout votre empire et un diagnostic des filiales qui perdent de l'argent ;
• chercher parmi les 1 000 villes du jeu et inspecter une ville (population, PoP, datacenters, câbles, services) ;
• lire vos comptes bancaires, le Grand Livre et le détail de chaque facture ;
• comparer la fiscalité des pays et simuler les taxes d'un achat ;
• suivre la Bourse, les crises en cours et votre couverture PCA ;
• interroger le routage BGP, sonder une route réseau et lire le journal du jeu, le classement, le chat mondial et vos méls.

Ce qu'un agent IA peut faire

Côté action, les outils couvrent presque tout le jeu : fonder une entreprise, déployer ou moderniser un PoP, poser ou moderniser un câble de fibre, construire un datacenter (Tier 1 à 20) et régler ses serveurs, lancer un service, ouvrir une régie publicitaire, changer les tarifs, faire des virements, vendre, enchérir ou acheter sur la Bourse, souscrire un PCA, écrire dans le chat ou par mél. La cyberguerre du jeu en fait partie : lancer ou arrêter une attaque DDoS simulée, équiper un datacenter, enquêter et porter plainte devant le Tribunal ARCEP.

Chaque action coûte de vrais GC de votre partie et s'inscrit au Grand Livre. Quelques exemples de demandes :

• « Analyse ma trésorerie et dis-moi quelle filiale perd de l'argent. »
• « Vérifie si un de mes câbles est saturé et augmente son débit. »
• « Construis un datacenter Tier 4 à Singapour et lance un service de cloud gaming. »

Se connecter en trois étapes

1. Dans le jeu, ouvrez les paramètres du compte, onglet « Clé API & IA », et copiez votre clé : elle commence par pk_live_.
2. Prenez l'adresse de votre monde suivie de /mcp, par exemple https://world01.packetdominance.com/mcp.
3. Déclarez ce serveur dans votre assistant avec l'en-tête Authorization: Bearer suivi de votre clé. Les boutons « Copier JSON MCP » et « Copier la commande » du même onglet donnent une configuration prête à coller.

Pour Claude Code, une seule commande suffit : claude mcp add --transport http packet-dominance https://world01.packetdominance.com/mcp --header "Authorization: Bearer VOTRE_CLE". Cursor, Windsurf et les clients compatibles acceptent un bloc JSON de type http avec l'URL et l'en-tête. ChatGPT ou tout autre assistant convient s'il permet d'envoyer cet en-tête. En revanche, un client qui n'accepte que la connexion OAuth, comme les connecteurs personnalisés de claude.ai, ne peut pas s'y brancher.

Limites et sécurité

• La clé voyage dans l'en-tête, jamais dans l'URL : une clé placée dans l'adresse est refusée (400), car elle finirait dans les journaux. Le jeton de session du navigateur n'est pas accepté.
• 120 requêtes MCP par minute et par joueur, et 240 par minute et par adresse avant authentification ; au-delà, refus 429.
• Un message par requête : les lots JSON-RPC sont refusés et un message ne dépasse pas 1 Mo. Un appel d'outil s'arrête après 14 secondes.
• Aucun outil d'administration : l'avance rapide des ticks, la console SQL ou les crédits de test sont masqués et refusés (403).
• Contrôle de l'origine : une requête venue d'une page web étrangère est refusée, ce qui bloque les attaques par rebinding DNS.
• Régénérer la clé dans le même onglet la désactive aussitôt : à faire au moindre doute.
• Une écriture interrompue a pu aboutir : après une coupure ou un délai dépassé, vérifiez l'état du jeu avant de relancer une action.

Bon réflexe : demandez d'abord à l'agent d'analyser et de proposer, puis validez chaque dépense importante avant qu'il agisse.

Lancer votre agent

Choisissez un monde, créez votre compte et récupérez votre clé API : votre assistant peut jouer quelques minutes plus tard. Pour lui donner de bonnes consignes, lisez les règles de l'économie et de la banque et du réseau de fibre. Partagez vos agents et vos stratégies sur le Discord de Packet Dominance.