Piloter Dokos depuis un assistant externe
Piloter Dokos depuis un assistant externe
L'assistant intégré vit dans Dokos. À l'inverse, un assistant que vous utilisez déjà ailleurs — Claude Code dans un terminal, l'application Claude sur votre poste, agy, Vibe CLI, OpenCode — peut travailler sur votre site Dokos. Il lit vos documents, exécute vos rapports et prépare vos écritures, avec les mêmes permissions et les mêmes confirmations.
C'est Dokos CLI qui fait la jonction : le même outil sert de ligne de commande pour un administrateur et de passerelle MCP pour un assistant.
Prérequis
Dokos CLI installé sur le poste, et connecté à votre site — voir Installation et Configuration :
dokos configure # enregistre l'URL du site et une clé d'API
dokos sites # vérifie quel site est actif
Les droits de l'assistant sont ceux de l'utilisateur dont la clé d'API est enregistrée. Une clé issue d'un compte restreint donne un assistant restreint : c'est le premier levier de contrôle, avant tout réglage.
Les assistants en terminal : une commande
dokos agent install --print # prévisualiser sans rien écrire
dokos agent install # installer dans tous les runtimes détectés
La commande enregistre la passerelle auprès de chaque assistant détecté, auto-approuve les seuls outils de lecture, et installe l'assistant Dokos dans une bibliothèque partagée par tous les runtimes. Les lectures s'exécutent alors sans interruption, les écritures continuent de demander confirmation en langage clair. L'opération est sans effet si elle est relancée.
L'application Claude : un plugin
Claude Cowork et l'application Claude de bureau ne lisent pas la configuration des outils en terminal : elles s'équipent par plugin. Dans Claude, ouvrez Customize → Plugins → Add marketplace, saisissez https://gitlab.com/dokos/dokos-cli, puis installez le plugin dokos.
Le plugin demande le chemin de l'exécutable dokos : une application de bureau n'hérite pas des chemins de votre terminal, il faut donc le lui indiquer. Récupérez-le avec which dokos (macOS, Linux) ou where dokos (Windows).
Explorer sans risque : les sites en lecture seule
Un site peut être marqué en lecture seule. Toute écriture est alors refusée avant même que la demande ne quitte le poste, quel que soit l'assistant employé et quelles que soient ses permissions sur le site.
dokos sites --read-only production
dokos sites --writable production # et inversement
C'est la manière recommandée de laisser un assistant explorer un site de production : analyser des données, préparer un rapport, comprendre un paramétrage, sans qu'aucune modification ne soit possible.
Les compétences suivent le site
Les compétences que vous écrivez dans Dokos ne servent pas qu'à l'assistant intégré. Dokos CLI récupère celles que le site publie et les installe localement, si bien que votre assistant externe applique vos procédures et pas seulement des connaissances génériques.
dokos skill pull # récupérer les compétences du site actif
dokos skill list # voir la bibliothèque locale et l'origine de chaque compétence
Une compétence n'est publiée que si vous l'avez explicitement autorisée — la case Partager avec les assistants externes dans l'éditeur de compétences. Le site refuse en outre de publier une compétence qui s'appuie sur un outil propre à l'application, sans équivalent hors de Dokos : mieux vaut ne pas l'envoyer que l'envoyer inutilisable.
La récupération est incrémentale et se rafraîchit automatiquement une fois par jour au démarrage d'une session. Une compétence que vous avez écrite localement n'est jamais écrasée par une compétence du site portant le même nom. Sur un site où l'application Dokos AI n'est pas installée, l'assistant fonctionne simplement avec les compétences fournies avec l'outil.
Voir aussi
- Dokos CLI — Intégration avec les agents — le détail technique : outils exposés, enregistrement manuel, conseils d'usage
- L'assistant — l'assistant intégré à Dokos
- Connecter des outils externes à l'assistant — le branchement inverse