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

# Strumenti MCP integrati

PowerShell Universal include diversi strumenti MCP integrati che aiutano gli agenti di codifica a ispezionare le risorse PSU e a conoscere la superficie dei comandi locale. Sono disponibili dall'endpoint `/api/v1/mcp`.

Questi strumenti integrati sono separati dai suoi [AI Tools](/powershell-universal/it/intelligence/ai-tools.md) personalizzati. In pratica, risultano più utili quando un agente deve ispezionare script, endpoint, app o la guida dei cmdlet prima di apportare una modifica.

Per accedervi da remoto, colleghi un client MCP a `/api/v1/mcp` e si autentichi con un token app PSU. Gli strumenti integrati richiedono l'accesso `Administrator` o `Operator`.

## Flusso tipico

La maggior parte delle sessioni di codifica segue uno schema come questo:

1. Chiami `list_resource_types` per vedere quali tipi di risorse PSU sono disponibili.
2. Chiami `list_resources` per trovare lo script, l'endpoint, l'app o il workflow specifico di cui ha bisogno.
3. Chiami `list_commands` o `list_app_commands` per scoprire i cmdlet disponibili su quel server PSU.
4. Chiami `command_help` per una guida mirata sul cmdlet che intende utilizzare.
5. Chiami `reload_resource` dopo aver modificato la configurazione affinché PSU ricarichi la risorsa.

## list\_resource\_types

Restituisce i tipi di risorsa disponibili sull'istanza PSU connessa, come script, endpoint, app e workflow.

Utilizzi prima questo strumento anziché indovinare i nomi dei tipi disponibili.

Esempio:

```
list_resource_types
```

## list\_resources

Elenca le risorse di un determinato tipo e le restituisce in formato JSON.

Parametri:

* `type` - Il tipo di risorsa da ispezionare. Utilizzi un valore restituito da `list_resource_types`.
* `filter` - Un filtro con caratteri jolly che corrisponde ai nomi o alle descrizioni delle risorse.

Esempio:

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

## list\_commands

Cerca i comandi in un modulo PowerShell installato sul server PSU.

Parametri:

* `module` - Il nome del modulo.
* `name` - Un filtro per il nome del comando. Sono supportati i caratteri jolly.

Di solito è seguito da `command_help`.

Esempio:

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

## command\_help

Restituisce le informazioni della guida per un comando disponibile sul server PSU.

Parametri:

* `module` - Il nome del modulo.
* `command` - Il comando da ispezionare.
* `parameter` - Nome del parametro o modello con caratteri jolly facoltativo.
* `full` - Include l'output completo della guida.
* `examples` - Include gli esempi.

Inizi con una guida mirata invece di richiedere sempre il testo completo della guida.

Esempio:

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

## list\_app\_commands

Restituisce i cmdlet specifici delle app utilizzati per creare le app PSU, in particolare i comandi dei componenti `UD` e di interattività.

Parametro:

* `filter` - Un filtro con caratteri jolly per il nome del comando.

Esempio:

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

## reload\_resource

Ricarica un tipo di risorsa PSU dopo la modifica dei file o della configurazione.

Parametro:

* `resourceType` - Il tipo di risorsa da ricaricare.

Esempio:

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

Questo è particolarmente utile quando un agente modifica la configurazione tramite un checkout locale o un file system remoto e PSU deve quindi recepire la modifica.


---

# 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/it/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.