For the complete documentation index, see llms.txt. This page is also available as Markdown.

Connecter un client d’IA avec MCP

devo mcp transforme Devolutions CLI en serveur Model Context Protocol (MCP). Votre client d’IA le démarre, et le modèle obtient des outils pour travailler sur votre espace de travail : lister les coffres, chercher des entrées, examiner l’accès, générer des mots de passe, et plus encore. C’est le même espace de travail et les mêmes permissions que les commandes devo que vous exécutez vous-même.

Avant de commencer

  • Devolutions CLI est installé, et la commande devo est sur le PATH du client d’IA.

  • Vous êtes connecté. Le serveur MCP n’a pas d’outil de connexion : il utilise les contextes que vous avez enregistrés avec devo login, en commençant par le contexte actuel. Consultez Se connecter à vos espaces de travail.

  • Votre client MCP peut démarrer un serveur local par l’entrée et la sortie standard (stdio), ce que font la plupart des clients.

Ajoutez le serveur à votre client

La plupart des clients MCP décrivent un serveur local par une commande et ses arguments. Ajoutez une entrée comme celle-ci à la configuration MCP de votre client :

{
  "mcpServers": {
    "devolutions": {
      "command": "devo",
      "args": ["mcp", "--deny-tool", "RDM_resolve_secret_reference"]
    }
  }
}

La clé qui contient les serveurs (mcpServers ici) et le fichier où elle va dépendent de votre client. Consultez la documentation de votre client pour savoir où ajouter un serveur stdio local.

Redémarrez le client ou rechargez ses serveurs MCP. Le client démarre devo mcp lui-même et l’arrête à la fin de la session : vous ne l’exécutez pas dans un terminal.

Options que vous pouvez ajouter

OPTION
CE QU’IL FAIT

--context <context-name>

Utilise ce contexte enregistré au lieu du contexte actuel. Utile quand l’agent doit travailler sur un seul espace de travail.

--read-only, --deny-destructive, --deny-open-world, --allow-tool, --deny-tool

Limitez les outils que le modèle obtient. Consultez Limiter ce qu’un agent peut faire.

--server-name <name>

Nom du serveur envoyé au client quand il se connecte. La valeur par défaut est Remote Desktop Manager Devo CLI MCP Server.

Par exemple, pour donner à un agent un accès en lecture seule à un seul espace de travail :

Ce que le modèle peut faire

Tous les noms d’outils commencent par RDM_. Ils couvrent ces domaines :

ZONE
EXEMPLES

Espaces de travail

Énumère les espaces de travail que la session peut utiliser (profil local et chaque contexte Devolutions Cloud ou Devolutions Server enregistré) et bascule entre eux pour le reste de la session.

Coffres et entrées

Énumérer les coffres, rechercher des entrées, obtenir une entrée, énumérer ses métadonnées, ses pièces jointes, ses permissions et ses journaux ; créer, mettre à jour ou supprimer des coffres ; mettre à jour, déplacer ou supprimer des entrées ; exporter les journaux d’activité vers un fichier local.

Utilisateurs et accès

Énumérer les utilisateurs et les groupes, créer ou supprimer des groupes, supprimer des utilisateurs, énumérer l’accès aux coffres, accorder ou révoquer un rôle de coffre, énumérer les rôles de sécurité et les jeux de permissions.

Mots de passe

Générez localement des mots de passe robustes, lisibles, des phrases de passe ou des mots de passe par motif.

Secrets

Résout une référence devo:// vers sa valeur (RDM_resolve_secret_reference). La réponse contient le secret.

Processus en arrière-plan

Vérifie, démarre, recharge, redémarre ou arrête le processus en arrière-plan de Devolutions CLI.

Les outils qui créent, modifient ou suppriment des coffres, des entrées, des groupes, des utilisateurs ou des accès exigent une confirmation explicite dans la requête. C’est le modèle qui donne cette confirmation, pas vous : pour tenir le modèle à l’écart des modifications, utilisez --read-only.

Le serveur MCP ne peut pas démarrer de programmes avec des secrets : pour qu’un agent exécute un outil avec un identifiant, utilisez devo secret run. Consultez Donner un identifiant à un agent sans l’exposer.

Voir la liste des outils

Pour voir quels outils le serveur expose, sans le démarrer :

Dans le résultat JSON, les outils que le serveur exposerait ont "visible": true. La sortie texte n’affiche que les 25 premiers. devo mcp catalog accepte les mêmes options de restriction que devo mcp, donc vous pouvez prévisualiser une configuration avant de la donner à votre client. Une exception : l’aperçu marque toujours RDM_resolve_secret_reference comme masqué, même quand devo mcp l’exposerait. Consultez Limiter ce qu’un agent peut faire.

Bon à savoir

  • Le processus en arrière-plan démarre de lui-même. Quand le serveur a besoin de votre espace de travail, devo mcp démarre le processus en arrière-plan de Devolutions CLI avant de répondre au client, à moins que vous ne démarriez le serveur avec --daemon require, --daemon never ou --no-daemon-autostart. Si des outils signalent que le processus n’est pas disponible, consultez Le processus en arrière-plan ne démarre pas.

  • L’espace de travail de la session peut changer. Sauf si vous démarrez le serveur avec --read-only, le modèle peut changer l’espace de travail pour le reste de la session, parmi le profil local et les contextes que vous avez enregistrés. Les outils qui le changent ne sont pas en lecture seule, donc --read-only les masque.

  • Le serveur s’exécute sous votre compte. Tout programme qui peut démarrer devo mcp sous votre compte d’utilisateur obtient le même accès à vos coffres.

Suivant

Mis à jour

Ce contenu vous a-t-il été utile ?