Outils MCP intégrés

PowerShell Universal inclut des outils MCP intégrés à /api/v1/mcp. Ils aident les clients MCP à inspecter le dépôt de configuration de PowerShell Universal, à découvrir les applets de commande, à lire la sortie des tâches et les notifications, et à appliquer les modifications de dépôt prises en charge.

Les outils intégrés sont distincts des outils d'IA personnalisés. Connectez un client MCP à /api/v1/mcp et authentifiez-vous avec un jeton d'application PowerShell Universal.

Se connecter à partir de Visual Studio Code

GitHub Copilot peut appeler les outils intégrés lorsque Visual Studio Code est connecté au serveur MCP de PowerShell Universal.

Appuyez sur Ctrl+Shift+P, exécutez MCP: Add Server..., sélectionnez HTTP, puis entrez l'URL du terminal MCP. Par défaut, l'URL est http://localhost:5000/api/v1/mcp.

La configuration settings.json résultante ressemble à ceci :

"mcp": {
  "servers": {
    "PSU": {
      "url": "http://localhost:5000/api/v1/mcp"
    }
  }
}

Pour vous authentifier avec un jeton d'application PowerShell Universal, incluez-le comme jeton bearer dans l'en-tête Authorization :

"mcp": {
  "servers": {
    "PSU": {
      "url": "http://localhost:5000/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <your-app-token>"
      }
    }
  }
}

Remplacez <your-app-token> par un jeton correspondant à l'utilisateur et aux rôles PowerShell Universal que le client doit utiliser. Ne soumettez pas au contrôle de code source une configuration contenant un véritable jeton d'application.

Si la connexion réussit, GitHub Copilot affiche les outils PowerShell Universal disponibles.

Contrôle d'accès

La plupart des outils intégrés nécessitent le rôle Administrator ou Operator. search_ant_design_controls prend aussi en charge le rôle App Editor. get_job_output_by_id nécessite un utilisateur authentifié et vérifie que cet utilisateur a la permission de lire la tâche demandée ou son autorisation de lecture configurée.

Utilisez un jeton d'application dédié avec seulement le rôle requis par le client MCP. Les outils d'écriture dans le dépôt peuvent créer, mettre à jour, déplacer et supprimer des fichiers de configuration; n'accordez donc pas d'accès Administrator ou Operator à un client MCP non fiable.

Flux typique

1. Appelez list_resource_types et list_resources pour identifier la ressource de configuration.
2. Utilisez les outils de dépôt et de commande pour inspecter les fichiers et les applets de commande pertinents.
3. Appliquez une modification délibérée du dépôt avec un outil d'écriture lorsque vous y êtes autorisé.
4. Appelez reload_resource pour recharger la ressource touchée.
5. Utilisez get_notifications ou get_job_output_by_id pour vérifier le résultat.

Outils de ressources et de commandes

Outil	Description
list_resource_types	Liste les types de ressources PowerShell Universal disponibles.
list_resources	Liste les ressources d'un type sélectionné, avec filtrage par caractères génériques.
reload_resource	Recharge un type de ressource sélectionné après une modification de la configuration.
list_commands	Liste les commandes d'un module PowerShell.
command_help	Retourne l'aide ciblée ou complète d'une commande, de ses paramètres et de ses exemples.
list_app_commands	Liste les applets de commande de développement d'applis Universal.

Outils de dépôt et outils opérationnels

Outils de dépôt

Les outils suivants inspectent et gèrent les fichiers et répertoires relatifs au dépôt :

Outil	Description
list_files	Liste les fichiers et les répertoires.
search_files	Recherche dans les noms de fichiers et de répertoires.
search_file_content	Recherche dans le contenu des fichiers du dépôt.
get_file_content	Lit un fichier du dépôt.
set_file_content	Remplace le contenu d'un fichier du dépôt.
new_file_system_item	Crée un fichier ou un répertoire dans le dépôt.
move_file_system_item	Déplace ou renomme un élément du dépôt.
delete_file_system_item	Supprime un élément du dépôt.

Tous les chemins sont relatifs au dépôt. Utilisez les outils de découverte avant de modifier un fichier, et appelez reload_resource après une modification de configuration autorisée.

Outils opérationnels

Outil	Description
get_notifications	Retourne les notifications récentes, avec filtrage optionnel par état de lecture, niveau, heure ou curseur.
get_job_output_by_id	Retourne la sortie du pipeline ou du flux de tâches lorsque l'appelant est autorisé à lire cette tâche.
search_ant_design_controls	Recherche parmi les contrôles de portail Ant Design et PSBlazor disponibles et retourne leurs paramètres.

Limites des outils et cibles d'exécution

PowerShell Universal prend en charge une limitation optionnelle du débit des outils MCP par minute et une limite optionnelle de tâches concurrentes pour les tâches d'outils d'IA. Configurez ces limites dans les paramètres du serveur pour protéger l'instance contre une activité excessive des outils.

Les outils d'IA personnalisés peuvent aussi définir des cibles Run In et Run On. Ces paramètres contrôlent l'environnement et l'ordinateur ou le groupe d'ordinateurs utilisés lorsqu'un outil personnalisé démarre une tâche. Ils ne modifient pas les exigences d'autorisation des outils MCP intégrés listés sur cette page.

Exemples

Utilisez la découverte de ressources avant de modifier la configuration :

list_resource_types
list_resources(type: "scripts", filter: "Inventory*")
get_file_content(path: "scripts/Inventory.ps1")

Après une mise à jour autorisée, rechargez et inspectez les notifications :

set_file_content(path: "scripts/Inventory.ps1", content: "<new script content>")
reload_resource(resourceType: "scripts")
get_notifications(unreadOnly: true, levels: "Warning,Error")