Laisser un assistant IA comme Claude Code piloter votre Asterobot via MCP, en sachant ce qu'il peut faire, ce qu'il ne peut pas faire, et ce qu'il faut garder en tête avant de le laisser agir.
Asterobot peut être piloté par un assistant IA, comme vous le pilotez depuis Asteroboard. L'assistant se connecte à Asterobot, voit tout ce qu'Asteroboard sait faire sous la forme d'une liste d'outils, et les appelle pendant que vous discutez avec lui : « ajoute un bot sur mon deuxième compte et connecte-le », « quelles tables contiennent les monstres et ce qu'ils lâchent », « écris un script qui salue la guilde quand le bot se connecte ». Ce chapitre explique ce qu'un assistant reçoit, comment en connecter un, et à quoi faire attention.
Ce qu'est MCP
MCP, pour Model Context Protocol, est la façon standard dont les assistants parlent aux programmes. Asterobot le parle à l'adresse /mcp, juste à côté de l'adresse qu'utilise Asteroboard. Tout assistant qui prend en charge MCP en HTTP peut se connecter : Claude Code, Codex, Cursor, un assistant de bureau ou un programme à vous. Rien dans Asterobot n'est lié à l'un d'eux, et il n'y a rien à installer côté Asterobot : c'est actif dès qu'Asterobot démarre.
Ce qu'un assistant peut faire
Asteroboard fait tout par le port d'Asterobot, et un assistant reçoit le même port. Il peut donc faire ce que vous faites sur chaque page d'Asteroboard :
- Comptes Ankama : en ajouter un, le connecter automatiquement ou à la main, répondre au code qu'Ankama envoie, rafraîchir ou vérifier une connexion, le déconnecter.
- Bots : ajouter, modifier et supprimer des bots, les connecter et les déconnecter, répondre à une question de connexion, déplacer le personnage sur sa carte, l'emmener sur la carte suivante par un côté, utiliser une porte, un zaap, une ressource ou une sortie de sa carte, lire la console d'un bot, choisir les messages que le bot reflète, et envoyer un message sur sa connexion.
- Paquets : installer un paquet du marché quand vous lui donnez l'identifiant du fichier, créer un paquet, modifier son script et son manifeste, le charger, le lancer, l'arrêter et le recharger, lire et modifier ses réglages, cliquer ses actions, le mettre à jour, le supprimer.
- Combats : activer ou désactiver le module de combat d'un bot, choisir son profil, sa vitesse et les combats qu'il joue, lire son journal des tours, et créer, modifier, importer et supprimer des profils de combat.
- Jeu : lister, télécharger, extraire, vérifier et désinstaller des versions de jeu, parcourir les tables de données de jeu, chercher des textes et des noms, et lancer des requêtes SQL.
- Tout le reste : lire et modifier les réglages, gérer les proxys, connecter et déconnecter Asterobot d'asterobot.net, vérifier qu'Asterobot répond, et suivre ce qui se passe par les événements et le journal.
Chaque outil est une action d'Asterobot, nommée d'après ce qu'elle fait : get-bots liste vos bots, post-bot-connect en connecte un, put-config-key modifie un réglage. Il y en a une centaine. L'assistant lit avec chacun une courte description écrite pour lui, vous n'avez donc pas à lui expliquer Asterobot. Quand il lance quelque chose qui prend du temps, comme connecter un bot, la réponse lui dit quel événement attendre, et il peut suivre cet événement avec un outil prévu pour ça. Outils, événements et limites donne les détails.
Ce qu'il ne peut pas faire
- Arrêter Asterobot ou remettre tous les réglages à zéro. Ces deux actions sont cachées aux assistants, sauf si vous les autorisez dans les réglages. Voir Réglages MCP.
- Exporter ou importer un paquet sous forme de zip. Il faut pour cela un fichier sur votre ordinateur, ce qu'un assistant ne manipule pas. Installer depuis le marché, et créer ou modifier un paquet sur place, fonctionnent.
- Parcourir le marché. Il peut installer un paquet quand vous lui donnez l'identifiant ou l'adresse du fichier sur asterobot.net, mais il n'a aucun moyen de chercher dans le marché lui-même.
- Plus qu'un script. Un assistant écrit et lance les mêmes scripts que vous écririez : ils peuvent se déplacer sur une carte, changer de carte, utiliser les éléments d'une carte et parler au jeu, et ils rencontrent les mêmes limites, décrites dans Ce que les scripts peuvent faire.
- Ce qu'Asterobot refuse. Quand votre compte asterobot.net ne donne pas à Asterobot l'accès au protocole du jeu, les outils qui en ont besoin répondent que le moteur de jeu n'est pas disponible, exactement comme Asteroboard l'afficherait.
Note
Bientôt disponible. L'assistant ne peut pas encore lire cette documentation à travers Asterobot. En attendant, il travaille à partir de ce que chaque outil dit de lui-même, de la référence des scripts qu'il peut récupérer, et de ce qu'il sait déjà de Dofus. Vous pouvez coller une page de cette documentation dans la conversation quand il en a besoin.
À garder en tête
Un assistant agit en votre nom. Tout ce que vous pouvez faire depuis Asteroboard, il peut le faire, sur vos comptes Ankama et avec votre compte asterobot.net. Sécurité liste ce que cela couvre.
La plupart des assistants demandent avant de modifier quelque chose. Chaque outil dit s'il se contente de lire. Des assistants comme Claude Code demandent votre permission avant un outil qui modifie quelque chose, et vous laissent autoriser un outil une fois ou pour de bon. Regardez ce qu'un outil s'apprête à faire avant de l'autoriser, comme vous liriez une boîte de dialogue avant de cliquer sur OK.
Il lit ce que d'autres écrivent. La console et le trafic d'un bot contiennent les messages de chat des autres joueurs. Un assistant qui les lit pourrait prendre un message écrit pour le piéger pour une instruction. Asterobot ne filtre pas cela. Gardez les demandes de permission actives pour les outils qui modifient des choses, et ne laissez pas un assistant tourner sans surveillance sur un bot dans un chat animé.
Les secrets restent cachés. Les réponses des outils ne contiennent jamais website.token ni vos mots de passe d'authentification basique, même par les outils de réglages : ces valeurs sont remplacées par [redacted].
Suite : Connecter un assistant.