Connecter mon agent
Beans Workbench offre deux façons d'obtenir l'aide d'une IA. Beans Assistant est le chat
intégré au Workbench : rien à installer, il voit la page où vous êtes et demande avant de
modifier un fichier. Votre propre agent (Claude Code, Claude Desktop, Codex CLI, Gemini CLI,
Cursor, ou tout autre client MCP) peut utiliser les mêmes outils via le serveur MCP du
Workbench, dzt mcp ; c'est ce que cette page configure. Elle contient aussi la liste des autres
serveurs MCP (Blender, Sketchfab, les vôtres) dont Beans Assistant peut utiliser les outils.
Pour la seconde façon, il faut que l'agent soit installé ; il tourne sur son propre abonnement,
aucun compte Beans n'est nécessaire.
Dans les deux cas, les secrets de vos paramètres (jeton de la passerelle, clés d'API, URL de
webhooks, clé de signature) ne sont jamais envoyés à un modèle : Beans Assistant masque chaque
résultat d'outil avant qu'il quitte le Workbench, et l'outil qui décrit votre installation à un
agent (dayz_environment) ne donne que des dossiers.
L'écran
- Deux façons d'obtenir l'aide d'une IA (carte du haut) : un rappel des deux façons, Ouvrir Beans Assistant quand l'assistant intégré est disponible, et Comment ça marche, qui ouvre cette page.
- Connecter mon agent (carte de gauche) : une ligne par agent avec son état sur cet ordinateur : connecté (le serveur est dans sa configuration et sa commande existe), détecté (installé, non connecté), non installé, ou commande introuvable (connecté à un Workbench déplacé ou supprimé). Chaque ligne a À la main et, tant qu'il n'est pas connecté, Connecter.
- Tester le serveur et Rechercher à nouveau (sous les lignes) : Tester le serveur vérifie
que le serveur du Workbench répond ; Rechercher à nouveau cherche de nouveau les agents. Le
chemin à droite est le programme
dztque les agents vont démarrer. - Skills Beans : avec un plan Modder ou Creator, un agent connecté reçoit aussi les skills
Beans (procédures vérifiées, chargées une à une avec
skill_load, pour votre seul usage : les conditions interdisent de les partager). Casual et le mois gratuit donnent les outils sans les skills. Se connecter avec Steam est proposé quand vous ne l'êtes pas. - Journal (apparaît après une action) : ce qu'a fait Connecter, ou pourquoi cela a échoué.
- Outils exposés (carte de droite) : après Tester le serveur, chaque outil que le serveur offre avec sa description. Dessous, des exemples de demandes : un clic en écrit une dans Beans Assistant (c'est vous qui l'envoyez), ou la copie quand l'assistant intégré n'est pas configuré.
- Serveurs MCP pour Beans Assistant (carte du bas) : les serveurs externes que vous avez ajoutés, chacun avec son état (non démarré, connexion…, prêt, N outils, erreur, désactivé), Activé, Tester, Outils, Modifier et supprimer. Au-dessus de la liste : Ajouter un serveur, Importer du JSON, Ajouter Blender, Ajouter Sketchfab, Tout connecter.
Premiers pas
- Ouvrez Connecter mon agent dans la barre latérale (le groupe Lancer).
- Trouvez votre agent dans la carte de gauche. S'il indique non installé, installez-le, puis Rechercher à nouveau.
- Cliquez sur Connecter sur sa ligne. Pour Claude Desktop, quittez-le d'abord complètement (icône de la barre système comprise).
- Redémarrez l'agent pour qu'il charge le serveur. Il y apparaît sous le nom
dayz. - Cliquez sur Tester le serveur : la carte de droite liste les outils que votre agent a désormais.
- Dans votre agent, demandez quelque chose qui en a besoin, par exemple l'un des exemples de demandes.
Suivre la visite guidée (dans l'app)
Tâches courantes
Utiliser Beans Assistant, le chat intégré
- Appuyez sur Ctrl+J, ou cliquez sur l'étincelle dans la barre latérale ou dans l'en-tête d'une page. Le panneau s'ouvre à droite ; sur l'Accueil, le chat est dans la page.
- Saisissez votre demande.
@mentionne un fichier, Ctrl+V colle une image, le trombone joint des fichiers. Les secrets de vos réglages (webhooks, clés, jetons) sont retirés du texte joint, et les fichiers de réglages et de session du Workbench ne sont jamais joints. Les réponses n'affichent aucune image du web : un lien d'image s'affiche comme son texte. - Lisez la pastille sous la zone de message :
Contexte : …nomme ce que la page envoie avec votre message. Cliquez dessus pour lire le texte exact ; cliquez sur sa croix pour cesser de l'envoyer. - Choisissez le mode (voir Concepts), puis appuyez sur Entrée.
Il s'affiche sauf si vous l'avez désactivé dans les Paramètres (connexion avec Steam). Chaque compte connecté a un petit usage gratuit par mois avec le modèle par défaut, pour l'essayer ; un plan (un par compte Steam) en donne davantage, avec une limite par jour qui se réinitialise chaque jour à 00:00 UTC (Casual 12 €, environ 14 demandes GLM 5.3 Flash par jour ; Modder 29 €, environ 20 ; Creator 79 €, environ 60), et les packs ajoutent des crédits qui n'expirent pas. La barre en haut du panneau montre ce qui est utilisé ; cliquez-la pour le détail. Suivre sa visite guidée (dans l'app)
Lancer une recette
Les recettes sont des tâches guidées : importer une arme, ajouter un verrou de véhicule, configurer un marchand, publier sur le Workshop. Ouvrez le catalogue avec Recettes dans l'en-tête du panneau (même en pleine conversation), Aide > Recettes dans la barre de menus, Voir les N sur l'Accueil, ou les puces qu'une page montre quand elle est vide. Cherchez par mots ou filtrez par catégorie (Créer, Améliorer, Tester et corriger, Serveur, Publier), puis cliquez sur une carte : une nouvelle conversation démarre, pose les questions de la recette, propose un plan et avance étape par étape, chaque étape finie par une vérification. Une carte avec un cadenas et le nom d'une offre demande cette offre ; un clic le dit et ouvre la boutique. Le panneau d'aide (F1) de chaque page liste ses recettes.
La durée d'une carte est celle de l'assistant : « une première version en ~20 min » pour une recette qui crée quelque chose, « une session de ~30 min » pour une recette qui améliore un mod existant. Quand les étapes d'une recette sont faites, Et ensuite sous la liste propose les recettes qui suivent d'habitude (tester en jeu et corriger, ajouter une fonctionnalité, équilibrer, publier).
Construire un mod sur plusieurs jours
Un vrai mod demande plus d'une séance. Planifier un mod sur plusieurs jours (sur l'Accueil, ou
En faire un projet après une recette) demande l'objectif, pour qui il est et sa taille, puis
écrit une feuille de route : un objectif et des étapes (une première version, un test en jeu, des
corrections, une fonctionnalité, des finitions, une publication), gardée dans
.beans/ROADMAP.json du mod. Vous l'approuvez comme toute modification de fichier et pouvez la
modifier. Chaque conversation sur ce mod commence avec la feuille de route : Beans reprend là où
vous vous êtes arrêté. Continuer sur l'Accueil lance une session sur la prochaine étape :
l'assistant lit le code des sessions précédentes, fait l'étape, la vérifie, la marque faite et
ajoute ce qu'il a trouvé (un bug, un point à reprendre) comme nouvelles étapes. Les recettes
Améliorer (ajouter une fonctionnalité, corriger ce que les testeurs ont signalé, équilibrer prix et
butin) et Tester en jeu et corriger marchent de la même façon sur n'importe quel mod.
Voir son usage et ses achats, prendre un plan ou un pack
- Une fois connecté avec Steam, une barre d'usage s'affiche dans l'en-tête du panneau (et au-dessus du champ de saisie sur l'Accueil) : la limite de votre plan, sinon l'usage gratuit du mois, avec le nombre approximatif de demandes restantes, et vos crédits de packs. Cliquez dessus : un menu s'ouvre avec les barres d'usage, chacune avec sa réinitialisation et le nombre approximatif de demandes restantes.
- Compte et utilisation : les barres d'usage, votre abonnement, les réponses par jour sur les 30 derniers jours, vos achats avec leurs reçus et les prix par modèle.
- Plans et packs : la boutique. Chaque plan indique ce qu'il comprend (tous les modèles, toutes les recettes) et environ combien de demandes par jour ; chaque pack, environ combien de demandes il paie. Cochez la case du droit de rétractation de 14 jours, puis cliquez sur un plan ou un pack ; la page de paiement s'ouvre dans votre navigateur et le compte se met à jour une fois le paiement fait. Avec un plan, cliquez sur un autre pour en changer : il démarre dès son paiement, l'ancien prend fin et Stripe crédite son temps non utilisé.
Les recettes du catalogue (actions guidées) sont incluses dans un plan Beans ; sans plan, une recette par mois est gratuite (la pastille au-dessus du catalogue dit si elle est utilisée). Les outils restent gratuits. Auditer mon mod relit un mod dans une nouvelle conversation : sécurité, données des joueurs, performances, compatibilité, test en jeu, puis un rapport avec les corrections. Un mod que vous créez est le vôtre : sa première ligne indique qu'il a été réalisé avec Beans Workbench, et vous pouvez la retirer.
Les modèles ne coûtent pas la même chose. Le sélecteur a deux groupes : Inclus, le modèle par défaut (GLM 5.3 Flash), sur lequel comptent le mois gratuit et les abonnements ; et Premium, les modèles Claude (Haiku, Sonnet, Opus), qui répondent mieux et consomment l'abonnement plus vite. Chaque modèle affiche son tarif à côté de son nom (×1 pour le modèle par défaut, ×6 pour un modèle six fois plus cher), et après chaque réponse une ligne indique environ combien de demandes restent dans la limite qui l'a payée, ou, quand les packs ont payé, son coût et pourquoi. L'usage gratuit du mois ne vaut que pour le modèle par défaut : avec un autre modèle choisi, une demande refusée le dit. Quand plus rien ne reste, la conversation dit quand la limite revient, avec Plans et packs. Une demande ne démarre que si une limite peut la payer : son contexte et une réponse (le mois gratuit, puis la journée du plan, puis les packs). Quand ce qui reste est trop peu pour le modèle choisi (une longue conversation avec Claude Max, par exemple), la demande est refusée avant de démarrer et indique un modèle moins cher qui tient, avec un bouton qui le choisit et renvoie la demande. La réponse reste dans ce que la limite peut payer ; ce qu'une réponse dépasse encore compte sur la journée (ou le mois) suivant. 4. Gérer l'abonnement (avec un abonnement) ouvre le portail de facturation Stripe pour résilier ou changer de carte ; Se déconnecter oublie la session.
Les Paramètres proposent la même chose sous Compte et usage, avec Se connecter avec Steam quand vous êtes déconnecté.
Approuver, refuser ou annuler un changement
- En mode Demander avant, chaque changement est d'abord montré (un diff pour les fichiers) avec trois réponses : oui ; oui et ne plus demander pour cet outil dans cette conversation ; non, en disant quoi faire à la place.
- Après une réponse qui a modifié des fichiers, cliquez sur N fichiers modifiés dessous pour voir les diffs.
- Rétablir le fichier remet un fichier en place ; Annuler les modifications de cette réponse les remet tous.
- Revenir sur l'un de vos messages remet les fichiers comme ils étaient à ce message, coupe la conversation là et rend son texte à la zone de message. Quand un fichier ne peut pas être remis (verrouillé, en lecture seule), le retour s'arrête : la conversation reste telle quelle.
- Un fichier que vous avez modifié depuis est montré avec ce qui a changé et demande : écraser
ou ignorer. Les fichiers du jeu ne sont jamais modifiés. Les fichiers supprimés par une
annulation sont conservés dans un dossier
.beans-reverted.
Connecter un agent à la main
- Cliquez sur À la main sur la ligne de l'agent. Rien n'est modifié.
- Pour Claude Code, lancez la commande affichée dans un terminal. Pour les autres, ajoutez les lignes affichées au fichier nommé au-dessus. Copier les copie.
- Redémarrez l'agent, puis Rechercher à nouveau : la ligne doit indiquer connecté.
Vérifier que le serveur fonctionne
- Cliquez sur Tester le serveur. Le Workbench démarre
dzt mcp, fait la poignée de main MCP et demande la liste des outils. - Une notification donne le nombre d'outils et la carte de droite les liste. Un échec s'affiche dans le journal de la carte de gauche.
Tester le serveur ne vérifie que le côté du Workbench. S'il réussit et que votre agent n'affiche
toujours aucun outil, l'agent n'a pas été redémarré, ou sa configuration pointe vers un autre
dzt (commande introuvable : cliquez sur Connecter pour le faire pointer vers ce
Workbench).
Ajouter Blender ou un autre serveur MCP pour Beans Assistant
- Dans la carte du bas, cliquez sur Ajouter Blender (demande
uvet l'add-on mcp-for-blender activé dans Blender), Ajouter Sketchfab (demande Node.js et votre propre clé d'API Sketchfab, que le formulaire réclame), ou Ajouter un serveur pour tout autre. - Pour Ajouter un serveur, donnez un nom, puis soit une commande locale avec ses arguments (un par ligne) soit une URL distante. Les valeurs d'environnement et les en-têtes restent sur cet ordinateur.
- Cliquez sur Tester sur sa ligne : l'état devient prêt, N outils, ou erreur avec la raison. Outils liste ce qu'il offre.
- Laissez De confiance désactivé sauf si vous voulez que ses outils s'exécutent sans demander.
Importer du JSON prend le bloc mcpServers d'une configuration de Claude Desktop ou de
Claude Code.
Exemples
Cette page n'a pas d'exemple à ouvrir. Les exemples de demandes sous la liste des outils sont des requêtes à essayer avec l'un ou l'autre des assistants.
Concepts
- MCP (Model Context Protocol) est la façon standard pour un agent IA d'appeler les outils offerts par un autre programme. Voir https://modelcontextprotocol.io.
dztest le programme en ligne de commande du Workbench ;dzt mcpest le serveur MCP, qui parle par l'entrée et la sortie standard. L'agent le démarre lui-même à chaque exécution : la fenêtre du Workbench n'a pas besoin d'être ouverte.- Connecter enregistre le serveur sous le nom
dayz. Claude Code est enregistré par sa propre commande (claude mcp add --scope user). Pour Codex CLI, une section[mcp_servers.dayz]est ajoutée à sonconfig.toml; pour Gemini CLI, Cursor et Claude Desktop, une entréedayzest ajoutée àmcpServersdans leur fichier JSON. Le fichier précédent est conservé à côté sous le nom<file>.beans-backup. Un fichier qui n'est pas du JSON pur est laissé tel quel et À la main s'ouvre à la place. - Modes de Beans Assistant. Demander avant : les lectures s'exécutent d'elles-mêmes, chaque changement est montré et attend votre réponse. Auto : les changements dans vos dossiers s'exécutent sans demander ; la publication demande toujours, ainsi que chaque outil d'un serveur externe qui n'est pas de confiance. Auto n'est pas conservé au démarrage suivant. Plan : l'assistant ne fait que lire, puis propose un plan ; rien ne change avant que vous l'approuviez.
- Contexte. Chaque page dit à Beans Assistant ce qu'elle montre (fichier ouvert, sélection, onglet, modifications non enregistrées, derniers problèmes) plus les dossiers qui comptent. Il est court, sans secrets, et n'est renvoyé que lorsqu'il a changé. Un agent externe ne le reçoit pas : il ne voit que les résultats d'outils.
- Points de contrôle. Avant que l'assistant modifie un fichier, le Workbench en garde un instantané. C'est ce qu'utilisent les diffs, Rétablir, Annuler et Revenir.
- Serveur de confiance. Les outils d'un serveur MCP externe sont nommés
mcp__<server>__<tool>et sont demandés à chaque fois, même en Auto, sauf si le serveur est marqué de confiance.
Pièges
- Connecter un agent sans le redémarrer : les agents lisent leurs serveurs au démarrage.
- Cliquer sur Connecter pendant que Claude Desktop tourne : il réécrit sa configuration depuis sa mémoire et perd le serveur. La page refuse et vous dit de le quitter d'abord.
- Déplacer ou supprimer le Workbench après avoir connecté : la ligne affiche commande introuvable ; Connecter la répare.
- Lire Tester le serveur comme un test de l'agent : il montre seulement que
dzt mcprépond. - Marquer un serveur de confiance pour faire cesser les questions : un serveur MCP tourne avec vos droits. N'ajoutez que des serveurs de confiance, et réservez De confiance à ceux que vous connaissez bien.
- S'attendre à retrouver dans votre propre agent les serveurs externes de la carte du bas : ils sont pour Beans Assistant. Ajoutez-les à votre agent dans la configuration propre à l'agent.
- Supprimer un serveur efface ses réglages tout de suite, y compris une clé saisie dans son environnement.
Pour les agents
dzt mcpsert les outils ;dzt toolsles liste ;dzt tool <name> '<json>'en appelle un depuis un terminal.dayz_environmentdonne les dossiers détectés (jamais de clés ni d'URL de webhooks).- À la main, l'enregistrement est
claude mcp add --scope user dayz -- "<path to dzt>" mcp, ou un serveur nommédayzavec la commande<path to dzt>et les arguments["mcp"]. dzt loginconnecte à la passerelle Beans ; avec un abonnement,dzt mcpajoute alors les règles Beans à ses instructions et proposeskill_load.dzt checkpoints list,show <conversation>,revert <conversation>font l'annulation des modifications de fichiers de Beans Assistant sans la fenêtre.- La page lit la configuration de chaque agent pour trouver le serveur
dayzet ne l'écrit que sur Connecter :~/.claude.json(via le programmeclaude),~/.codex/config.toml,~/.gemini/settings.json,~/.cursor/mcp.json, etclaude_desktop_config.jsondans le dossier de configuration de Claude Desktop. Les serveurs externes sont enregistrés dans les paramètres du Workbench. - Ne lisez, n'affichez ni ne demandez jamais le jeton de la passerelle, les clés d'API, les URL de webhooks, ni l'environnement et les en-têtes des serveurs externes.
- La page dit à Beans Assistant : le chemin de
dzt(ou « introuvable »), les agents connectés, les agents détectés mais non connectés, le nombre d'outils qui ont répondu au dernier test, si Beans Assistant est disponible, les noms des serveurs externes activés, et les erreurs de son journal. - Ancres qu'une visite peut désigner :
assistant-builtin,assistant-agents,assistant-agent,assistant-connect,assistant-manual,assistant-test,assistant-skills,assistant-tools,assistant-prompts,assistant-servers,assistant-server-add,assistant-server-blender; dans le panneau Beans Assistant :beans-composer,beans-context,beans-mode,beans-history.
Voir aussi
- Paramètres : afficher ou masquer Beans Assistant, vos dossiers.
- Accueil : les actions guidées de Beans Assistant.
- Modèles : où atterrissent les modèles faits avec Blender via l'assistant.
- Le Workbench : la barre latérale, le panneau d'aide, les visites.
docs/ASSISTANT.mddans le dépôt : ce qui est envoyé, crédits et abonnements, la passerelle.