> 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/limit-tools.md).

# Limiter ce qu’un agent peut faire

Restreindre le serveur MCP de Devolutions CLI aux outils en lecture seule, masquer les outils destructeurs, garder les valeurs de secret hors du modèle, ou permettre une courte liste d’outils.

Par défaut, `devo mcp` donne à votre client d’IA tous les outils qu’il a : lire, modifier et supprimer des coffres et des entrées, gérer l’accès et résoudre des valeurs de secret. La plupart des agents ont besoin de beaucoup moins. Ajoutez des options de restriction à la commande `devo mcp` dans la configuration de votre client, et les outils que vous masquez n’atteignent jamais le modèle.

## Choisir la bonne option

<table><thead><tr><th width="230">CHOISIR</th><th>CE QUI SE PASSE</th><th>À UTILISER QUAND</th></tr></thead><tbody><tr><td><code>--read-only</code></td><td>Seuls les outils marqués en lecture seule restent. Rien qui crée, modifie, déplace ou supprime des données.</td><td>L’agent explore ou fait un rapport : chercher des entrées, passer en revue l’accès, lire les journaux.</td></tr><tr><td><code>--deny-destructive</code></td><td>Masque les outils marqués comme destructifs, comme la suppression d’une entrée, d’un coffre, d’un groupe, d’un utilisateur ou de variables, et le redémarrage ou l’arrêt du processus en arrière-plan. Les outils qui créent ou mettent à jour des données restent.</td><td>L’agent peut organiser vos coffres, mais ne doit rien supprimer.</td></tr><tr><td><code>--deny-open-world</code></td><td>Masque les outils marqués comme capables d’atteindre des hôtes ou des réseaux externes. Aucun outil que le serveur expose aujourd’hui ne porte cette marque, donc cette option n’a actuellement aucun effet.</td><td>Votre politique l’exige, donc le paramètre est déjà en place si de tels outils sont ajoutés. Vérifiez ce qu’il masque avec <code>devo mcp catalog</code>.</td></tr><tr><td><code>--deny-tool &#x3C;tool></code></td><td>Masque les outils que vous nommez. Répétez l’option pour plusieurs outils.</td><td>Un outil précis ne doit jamais être disponible, comme <code>RDM_resolve_secret_reference</code>.</td></tr><tr><td><code>--allow-tool &#x3C;tool></code></td><td>Ne garde <strong>que</strong> les outils que vous nommez. Répétez l’option pour plusieurs outils.</td><td>L’agent a une seule tâche et a besoin de deux ou trois outils.</td></tr></tbody></table>

{% hint style="warning" %}
`--deny-destructive` ne masque pas chaque modification. L’octroi ou la révocation de l’accès à un coffre, la mise à jour ou le déplacement d’entrées et la création de coffres ne sont pas marqués comme destructifs. Quand l’agent ne doit rien modifier, utilisez `--read-only`.
{% endhint %}

## Garder les valeurs secrètes hors du modèle

L’outil `RDM_resolve_secret_reference` retourne la valeur d’un secret à votre client d’IA. Lire un secret ne modifie pas votre coffre, donc cet outil est marqué en lecture seule, et `--read-only` le conserve.

Pour être certain qu’aucune valeur secrète n’atteint le modèle, refusez-la par son nom :

```bash
devo mcp --read-only --deny-tool RDM_resolve_secret_reference
```

Quand l’agent a besoin d’un identifiant pour exécuter un outil, faites-lui utiliser `devo secret run` à la place. La valeur va seulement à cet outil. Consultez [Donner un identifiant à un agent sans l’exposer](/cli/fr/guides/ai-agents/run-an-agent.md).

## Combiner des options

Vous pouvez utiliser plusieurs options ensemble. Un outil n’est exposé que s’il respecte chaque règle :

1. Un outil nommé dans `--deny-tool` est toujours masqué, même si vous le nommez aussi dans `--allow-tool`.
2. Quand vous utilisez `--allow-tool`, chaque outil que vous n’avez pas nommé est masqué.
3. `--read-only`, `--deny-destructive` et `--deny-open-world` s’appliquent ensuite à ce qui reste. `--allow-tool` ne les remplace pas : un outil destructif que vous autorisez reste masqué par `--deny-destructive`.

Les noms d’outils ne tiennent pas compte de la casse. Par exemple, pour laisser un agent chercher des entrées et les lire, et rien d’autre :

```bash
devo mcp --allow-tool RDM_search_entries --allow-tool RDM_get_entry
```

Dans la configuration de votre client, chaque option et chaque valeur est un élément distinct dans `args` :

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

## Prévisualiser votre configuration

`devo mcp catalog` énumère les outils sans démarrer le serveur, et accepte les mêmes options de restriction :

```bash
devo mcp catalog --read-only --deny-tool RDM_resolve_secret_reference --json
```

Dans le résultat, chaque outil affiche `visible` (exposé avec ces options), `readOnly`, `destructive`, `openWorld` et `sensitive`. La sortie texte n’affiche que les 25 premiers outils exposés, donc utilisez `--json` pour les voir tous.

{% hint style="info" %}
L’aperçu marque toujours `RDM_resolve_secret_reference` comme masqué (`"sensitive": true`), parce qu’il laisse de côté les outils qui retournent des valeurs de secret. `devo mcp` démarré par votre client d’IA l’expose, à moins que vous ne le refusiez avec `--deny-tool` ou que vous l’excluiez de `--allow-tool`. Ne vous fiez pas à l’aperçu pour savoir si des valeurs de secret peuvent atteindre le modèle : vérifiez vos options `--deny-tool` et `--allow-tool`.
{% endhint %}

## Bon à savoir

* Les restrictions s’appliquent au démarrage du serveur. Pour les changer, modifiez la configuration de votre client et redémarrez le serveur depuis votre client.
* Les restrictions limitent les outils MCP, pas votre accès. Le serveur agit toujours avec vos permissions sur l’espace de travail. Pour un agent qui doit voir moins, connectez-le avec un compte ou une clé d’application qui a moins de permissions, dans son propre contexte. Consultez [Basculer entre les espaces de travail](/cli/fr/guides/connect/switch-workspaces.md).
* L’agent peut toujours exécuter des commandes `devo` dans un shell si votre client le lui permet. Les restrictions MCP ne s’appliquent pas à ces commandes. Consultez [Donner un identifiant à un agent sans l’exposer](/cli/fr/guides/ai-agents/run-an-agent.md).

## Suivant

* [Connect an AI client with MCP](/cli/fr/guides/ai-agents/connect-mcp.md)
* [What stays hidden, and what doesn't](/cli/fr/guides/understand/security-model.md)
* [Commands](/cli/fr/reference/commands.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/limit-tools.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.