Désactiver le point d'accès des assistants, cacher des actions aux assistants ou autoriser celles qui le sont, plafonner la taille des réponses, et lire ce qu'Asterobot dit quand quelque chose ne va pas.
Cinq réglages sur Serveur > Config contrôlent ce que reçoivent les assistants. Tous sont lus au démarrage d'Asterobot.
| Clé | Type | Valeur par défaut | Redémarrage nécessaire |
|---|---|---|---|
mcp.enabled |
Activé ou désactivé | Activé | Oui |
mcp.tags |
Liste de textes | Vide | Oui |
mcp.denyOperations |
Liste de textes | Vide | Oui |
mcp.allowOperations |
Liste de textes | Vide | Oui |
mcp.maxResponseBytes |
Nombre | 100000 |
Oui |
mcp.enabled
Activé ou désactivé. Par défaut : activé. Redémarrage nécessaire.
Désactivez-le et plus rien ne répond sur /mcp : l'adresse n'existe pas, et la console d'Asterobot affiche MCP disabled by configuration au démarrage. Tout le reste d'Asterobot est inchangé.
mcp.tags
Liste de textes. Par défaut : vide. Redémarrage nécessaire.
Ne proposer que les actions de certaines parties d'Asterobot. Chaque entrée est le nom d'un groupe d'actions, et un assistant voit une action quand elle appartient à au moins un groupe que vous avez listé. Les groupes sont AccountManager, BotManager, Config, Events, FightProfiles, Galaxy, GameData, GameManager, Library, Logger, ProxyManager, Runtime et Website ; la casse n'a pas d'importance. Vide veut dire tous les groupes.
Par exemple, ["GameData", "Library"] donne à un assistant le navigateur de données de jeu et vos paquets, et rien qui touche aux comptes ou aux bots.
mcp.denyOperations
Liste de textes. Par défaut : vide. Redémarrage nécessaire.
Les actions jamais proposées à un assistant, en plus des deux cachées par défaut. Chaque entrée est le nom d'une action tel que l'assistant le verrait, dans n'importe quelle graphie : post-bot-connect et PostBotConnect sont la même action. Demandez à l'assistant de lister ses outils pour obtenir les noms, ou prenez ceux de Ce qu'un assistant peut faire.
Important
Une entrée qui ne nomme aucune action désactive tout le point d'accès, volontairement : vous vouliez cacher quelque chose, et ce ne serait pas le cas. La console d'Asterobot affiche alors MCP disabled avec l'entrée dans la raison, et les appels à /mcp répondent avec la même raison. Corrigez l'orthographe et redémarrez.
mcp.allowOperations
Liste de textes. Par défaut : vide. Redémarrage nécessaire.
Les deux actions cachées par défaut, delete-runtime (arrêter Asterobot) et delete-config (remettre chaque réglage à sa valeur par défaut), proposées malgré tout. Mêmes règles de graphie que mcp.denyOperations. Une entrée qui ne nomme aucune action est ignorée, avec un avertissement dans la console.
mcp.maxResponseBytes
Nombre. Par défaut : 100000. Redémarrage nécessaire.
La plus grande réponse qu'un outil renvoie entière, en octets. Au-delà, des entrées sont retirées à la fin de la plus grande liste de la réponse, et l'assistant apprend comment restreindre sa requête. La valeur par défaut correspond à peu près à ce que les assistants affichent d'un bloc ; augmentez-la si le vôtre en supporte plus, baissez-la pour garder des réponses courtes.
Quand quelque chose ne va pas
Asterobot ne refuse jamais de démarrer à cause du point d'accès des assistants. Ce qui peut arriver à la place s'affiche dans la console et le terminal, sur Serveur > Console :
| Ligne | Ce qu'elle veut dire | Que faire |
|---|---|---|
MCP ready |
Tout fonctionne. skipped=0 est l'état normal. |
Rien. |
MCP skipped an operation avec operation= et err= |
Une action n'a pas pu être proposée, les autres le sont. Les instructions de l'assistant la nomment aussi. | Cela ne devrait pas arriver avec un Asterobot publié. Signalez-le avec la ligne. |
MCP disabled avec err= |
Rien ne fonctionne. La raison est un réglage, presque toujours une entrée de mcp.denyOperations qui ne nomme aucune action. |
Corrigez le réglage et redémarrez. |
The MCP is reachable from the network without authentication |
Asterobot écoute sur une adresse réseau sans authentification basique. Pas une erreur, un rappel. | Définissez server.basicAuth ou écoutez sur 127.0.0.1, comme l'explique Sécurité. |
Tant que le point d'accès est désactivé par un réglage, un assistant qui l'appelle reçoit une erreur dont le message commence par MCP unavailable: et donne la même raison que la console.
La liste complète des réglages est dans la Référence des réglages.