Integrierte MCP-Tools

PowerShell Universal enthält mehrere integrierte MCP-Tools, die Coding-Agents dabei helfen, PSU-Ressourcen zu untersuchen und die lokale Befehlsoberfläche kennenzulernen. Diese sind über den Endpunkt /api/v1/mcp verfügbar.

Diese integrierten Tools sind von Ihren benutzerdefinierten AI Tools getrennt. In der Praxis sind sie am nützlichsten, wenn ein Agent Skripte, Endpunkte, Apps oder Cmdlet-Hilfen untersuchen muss, bevor er eine Änderung vornimmt.

Um remote darauf zuzugreifen, verbinden Sie einen MCP-Client mit /api/v1/mcp und authentifizieren Sie sich mit einem PSU-App-Token. Die integrierten Tools erfordern Administrator- oder Operator-Zugriff.

Typischer Ablauf

Die meisten Coding-Sitzungen folgen einem Muster wie diesem:

1. Rufen Sie list_resource_types auf, um zu sehen, welche Arten von PSU-Ressourcen verfügbar sind.
2. Rufen Sie list_resources auf, um das benötigte Skript, den Endpunkt, die App oder den Workflow zu finden.
3. Rufen Sie list_commands oder list_app_commands auf, um die auf diesem PSU-Server verfügbaren Cmdlets zu ermitteln.
4. Rufen Sie command_help auf, um gezielte Hilfe zu dem Cmdlet zu erhalten, das Sie verwenden möchten.
5. Rufen Sie reload_resource auf, nachdem Sie die Konfiguration geändert haben, damit PSU die Ressource neu lädt.

list_resource_types

Gibt die auf der verbundenen PSU-Instanz verfügbaren Ressourcentypen zurück, wie Skripte, Endpunkte, Apps und Workflows.

Verwenden Sie dies zuerst, anstatt die verfügbaren Typnamen zu erraten.

Beispiel:

list_resource_types

list_resources

Listet Ressourcen eines bestimmten Typs auf und gibt sie als JSON zurück.

Parameter:

• type - Der zu untersuchende Ressourcentyp. Verwenden Sie einen von list_resource_types zurückgegebenen Wert.
• filter - Ein Platzhalterfilter, der auf Ressourcennamen oder -beschreibungen passt.

Beispiel:

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

list_commands

Sucht nach Befehlen in einem auf dem PSU-Server installierten PowerShell-Modul.

Parameter:

• module - Der Modulname.
• name - Ein Befehlsnamenfilter. Platzhalter werden unterstützt.

Darauf folgt üblicherweise command_help.

Beispiel:

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

command_help

Gibt Hilfeinformationen zu einem auf dem PSU-Server verfügbaren Befehl zurück.

Parameter:

• module - Der Modulname.
• command - Der zu untersuchende Befehl.
• parameter - Optionaler Parametername oder Platzhaltermuster.
• full - Die vollständige Hilfeausgabe einbeziehen.
• examples - Beispiele einbeziehen.

Beginnen Sie mit gezielter Hilfe, anstatt immer den vollständigen Hilfetext anzufordern.

Beispiel:

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

list_app_commands

Gibt die app-spezifischen Cmdlets zurück, die zum Erstellen von PSU-Apps verwendet werden, insbesondere UD-Komponenten- und Interaktivitätsbefehle.

Parameter:

• filter - Ein Platzhalterfilter für den Befehlsnamen.

Beispiel:

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

reload_resource

Lädt einen PSU-Ressourcentyp neu, nachdem Dateien oder Konfigurationen geändert wurden.

Parameter:

• resourceType - Der neu zu ladende Ressourcentyp.

Beispiel:

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

Dies ist besonders nützlich, wenn ein Agent die Konfiguration über einen lokalen Checkout oder ein Remote-Dateisystem bearbeitet und PSU die Änderung anschließend übernehmen muss.