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

# 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](/powershell-universal/de/intelligence/ai-tools.md) 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:

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

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

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

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

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


---

# 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.