> 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/powershell-universal/fr/intelligence/built-in-mcp-tools.md).

# Outils MCP intégrés

PowerShell Universal inclut plusieurs outils MCP intégrés qui aident les agents de codage à inspecter les ressources PSU et à apprendre la surface de commandes locale. Ces outils sont disponibles depuis le point de terminaison `/api/v1/mcp`.

Ces outils intégrés sont distincts de vos [outils IA](/powershell-universal/fr/intelligence/ai-tools.md) personnalisés. En pratique, ils sont particulièrement utiles lorsqu'un agent doit inspecter des scripts, des points de terminaison, des applications ou l'aide sur des cmdlets avant d'effectuer une modification.

Pour y accéder à distance, connectez un client MCP à `/api/v1/mcp` et authentifiez-vous avec un jeton d'application PSU. Les outils intégrés requièrent un accès `Administrator` ou `Operator`.

## Flux typique

La plupart des sessions de codage suivent un modèle semblable à celui-ci :

1. Appeler `list_resource_types` pour voir les types de ressources PSU disponibles.
2. Appeler `list_resources` pour trouver le script, le point de terminaison, l'application ou le flux de travail spécifique dont vous avez besoin.
3. Appeler `list_commands` ou `list_app_commands` pour découvrir les cmdlets disponibles sur ce serveur PSU.
4. Appeler `command_help` pour obtenir une aide ciblée sur le cmdlet que vous prévoyez d'utiliser.
5. Appeler `reload_resource` après avoir modifié la configuration afin que PSU recharge la ressource.

## list\_resource\_types

Retourne les types de ressources disponibles sur l'instance PSU connectée, tels que les scripts, les points de terminaison, les applications et les flux de travail.

Utilisez cet outil en premier plutôt que de deviner les noms de types disponibles.

Exemple :

```
list_resource_types
```

## list\_resources

Répertorie les ressources d'un type donné et les retourne au format JSON.

Paramètres :

* `type` — Le type de ressource à inspecter. Utilisez une valeur retournée par `list_resource_types`.
* `filter` — Un filtre générique qui correspond aux noms ou descriptions de ressources.

Exemple :

```json
{
	"type": "<resource type from list_resource_types>",
	"filter": "deploy*"
}
```

## list\_commands

Recherche des commandes dans un module PowerShell installé sur le serveur PSU.

Paramètres :

* `module` — Le nom du module.
* `name` — Un filtre sur le nom de commande. Les caractères génériques sont pris en charge.

Cette commande est généralement suivie de `command_help`.

Exemple :

```json
{
	"module": "Universal",
	"name": "*PSUAi*"
}
```

## command\_help

Retourne des informations d'aide pour une commande disponible sur le serveur PSU.

Paramètres :

* `module` — Le nom du module.
* `command` — La commande à inspecter.
* `parameter` — Nom de paramètre ou motif générique optionnel.
* `full` — Inclure la sortie d'aide complète.
* `examples` — Inclure des exemples.

Commencez par une aide ciblée plutôt que de toujours demander le texte d'aide complet.

Exemple :

```json
{
	"module": "Universal",
	"command": "Invoke-PSUAiAgent",
	"parameter": "Prompt",
	"full": false,
	"examples": true
}
```

## list\_app\_commands

Retourne les cmdlets spécifiques aux applications utilisés pour construire des applications PSU, notamment les commandes de composants `UD` et d'interactivité.

Paramètre :

* `filter` — Un filtre générique pour le nom de commande.

Exemple :

```json
{
	"filter": "New-UD*"
}
```

## reload\_resource

Recharge un type de ressource PSU après que des fichiers ou la configuration ont été modifiés.

Paramètre :

* `resourceType` — Le type de ressource à recharger.

Exemple :

```json
{
	"resourceType": "<resource type from list_resource_types>"
}
```

Cet outil est particulièrement utile lorsqu'un agent modifie la configuration via une extraction locale ou un système de fichiers distant, et que PSU doit prendre en compte la modification.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/fr/intelligence/built-in-mcp-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.