> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/fr/guides/ai-agents/connect-mcp.md).

# Connecter un client d’IA avec MCP

Ajouter le serveur MCP de Devolutions CLI à Claude Code, GitHub Copilot ou un autre client MCP, et comprendre ce que le modèle peut voir et faire.

`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](/cli/fr/guides/connect.md).
* 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.

{% hint style="warning" %}
Le serveur MCP peut retourner une valeur de secret à votre client d’IA, par l’outil `RDM_resolve_secret_reference`. Tout ce que le client reçoit peut atteindre le modèle et sa transcription. Si le modèle n’a pas besoin des valeurs, démarrez le serveur avec `--deny-tool RDM_resolve_secret_reference`. Consultez [Limiter ce qu’un agent peut faire](/cli/fr/guides/ai-agents/limit-tools.md).
{% endhint %}

## 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 :

```json
{
  "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

<table><thead><tr><th width="260">OPTION</th><th>CE QU’IL FAIT</th></tr></thead><tbody><tr><td><code>--context &#x3C;context-name></code></td><td>Utilise ce contexte enregistré au lieu du contexte actuel. Utile quand l’agent doit travailler sur un seul espace de travail.</td></tr><tr><td><code>--read-only</code>, <code>--deny-destructive</code>, <code>--deny-open-world</code>, <code>--allow-tool</code>, <code>--deny-tool</code></td><td>Limitez les outils que le modèle obtient. Consultez <a href="/cli/fr/guides/ai-agents/limit-tools.md">Limiter ce qu’un agent peut faire</a>.</td></tr><tr><td><code>--server-name &#x3C;name></code></td><td>Nom du serveur envoyé au client quand il se connecte. La valeur par défaut est <code>Remote Desktop Manager Devo CLI MCP Server</code>.</td></tr></tbody></table>

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

```json
{
  "mcpServers": {
    "devolutions": {
      "command": "devo",
      "args": ["mcp", "--context", "<context-name>", "--read-only", "--deny-tool", "RDM_resolve_secret_reference"]
    }
  }
}
```

## Ce que le modèle peut faire

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

<table><thead><tr><th width="200">ZONE</th><th>EXEMPLES</th></tr></thead><tbody><tr><td><strong>Espaces de travail</strong></td><td>É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.</td></tr><tr><td><strong>Coffres et entrées</strong></td><td>É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.</td></tr><tr><td><strong>Utilisateurs et accès</strong></td><td>É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.</td></tr><tr><td><strong>Mots de passe</strong></td><td>Générez localement des mots de passe robustes, lisibles, des phrases de passe ou des mots de passe par motif.</td></tr><tr><td><strong>Secrets</strong></td><td>Résout une référence <code>devo://</code> vers sa valeur (<code>RDM_resolve_secret_reference</code>). La réponse contient le secret.</td></tr><tr><td><strong>Processus en arrière-plan</strong></td><td>Vérifie, démarre, recharge, redémarre ou arrête le processus en arrière-plan de Devolutions CLI.</td></tr></tbody></table>

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](/cli/fr/guides/ai-agents/run-an-agent.md).

## Voir la liste des outils

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

```bash
devo mcp catalog --json
```

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](/cli/fr/guides/ai-agents/limit-tools.md#preview-your-configuration).

## 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](/cli/fr/aide/troubleshooting/daemon-wont-start.md).
* **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

* [Limit what an agent can do](/cli/fr/guides/ai-agents/limit-tools.md)
* [Give an agent a credential without exposing it](/cli/fr/guides/ai-agents/run-an-agent.md)
* [What stays hidden, and what doesn't](/cli/fr/guides/understand/security-model.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/fr/guides/ai-agents/connect-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.