> 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/rdm/it/ribbon-menu-bar/tools/all-tools/mcp-server.md).

# Server MCP

{% hint style="danger" %}
La funzionalità server MCP in Remote Desktop Manager (RDM) è sperimentale e viene fornita COSÌ COM'È. Il suo utilizzo può comportare la trasmissione di dati sensibili o personali a fornitori di AI/LLM di terze parti, che Devolutions non controlla.

Prima di procedere, consulti la nostra [Informativa su sicurezza e riservatezza per l'utilizzo del server MCP](/rdm/it/ribbon-menu-bar/tools/all-tools/mcp-server/security-and-confidentiality-disclaimer-for-mcp-server-usage.md).
{% endhint %}

***Server MCP (sperimentale)*** le consente di comunicare con Remote Desktop Manager utilizzando un client MCP con il suo Large Language Model (LLM) preferito. Con questo metodo, gli utenti possono interagire con l'applicazione Remote Desktop Manager tramite prompt testuali, che permettono loro di creare casseforti e cartelle in modo rapido ed efficiente, inviare comandi alle connessioni aperte e molto altro.

Sebbene i server MCP funzionino sfruttando strumenti preconfigurati, non è necessario che l'utente vi faccia riferimento durante la scrittura dei prompt. Ad esempio, identificare le voci con credenziali non aggiornate e aggiornarle in batch può richiedere l'uso di più strumenti, ma l'utente deve solo scrivere una semplice frase chiedendo che le password obsolete vengano aggiornate.

{% hint style="info" %}
Lo strumento ***Server MCP (sperimentale)*** può essere disabilitato completamente [applicando l'oggetto Criteri di gruppo (GPO) appropriato](/rdm/it/knowledge-base/how-to-articles/apply-policies-gpos.md).
{% endhint %}

### Configurazione del server MCP

Il server MCP di RDM è ospitato localmente sul suo desktop e, in quanto tale, è compatibile con la maggior parte dei client MCP che supportano gli MCP locali. Di seguito alcuni dei metodi per configurarlo:

**Utilizzo di Visual Studio Code**

1. In Visual Studio Code, apra la palette dei comandi (<kbd>CTRL</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>) ed esegua `MCP: Open User Configuration`. Questo apre il file `mcp.json` nel suo profilo utente o lo crea se non viene trovato.
2. Si connetta a Remote Desktop Manager utilizzando uno dei seguenti metodi:

   * Con WinGet, esegua `winget install jetsocat`, quindi:

   ```
   {
   	"servers": {
   		"rdm-mcp": {
   			"type": "stdio",
   			"command": "jetsocat",
   			"args": ["mcp-proxy", "-", "np://RDM.MCP"]
   		}
   	},
   	"inputs": []
   }
   ```

   * Direttamente:

   ```
   {
   	"servers": {
   		"rdm-mcp": {
   			"type": "stdio",
   			"command": "C:\\Program Files\\Devolutions\\Remote Desktop Manager\\runtimes\\win-x64\\native\\jetsocat.exe",
   			"args": ["mcp-proxy", "-", "np://RDM.MCP"]
   		}
   	},
   	"inputs": []
   }
   ```
3. Apra Remote Desktop Manager e clicchi su ***Strumenti*** – ***Altri strumenti*** – ***Server MCP (sperimentale)***.
4. Nella finestra ***Server MCP (sperimentale)***, clicchi sul pulsante ***Avvia***.

**Utilizzo di Claude Desktop**

1. Apra Claude Desktop e clicchi su ***Impostazioni*** – ***Sviluppatore*** – ***Modifica configurazione***.
2. Apra `claude_desktop_config.json` e aggiunga il seguente contenuto:

   ```
   {
   	"mcpServers": {
   		"rdm-mcp": {
   			"type": "stdio",
   			"command": "jetsocat",
   			"args": ["mcp-proxy", "-", "np://RDM.MCP"]
   		}
   	}
   }
   ```

   Se utilizza Claude Code (CLI), può eseguire questo script PowerShell:

   ```powershell
   claude mcp add-json rdm --scope user '{"type": "stdio", "command": "jetsocat", "args": ["mcp-proxy", "-", "np://RDM.MCP"]}'
   ```

   Oppure questa riga di comando:

   ```
   claude mcp add-json rdm --scope user '{"type": "stdio", "command": "jetsocat", "args": ["mcp-proxy", "-", "np://RDM.MCP"]}
   ```
3. Riavvii Claude Desktop. Il server dovrebbe quindi essere elencato nella sezione ***Sviluppatore*** e gli strumenti disponibili nella chat stessa.

**Utilizzo di Codex CLI**

1. Apra Codex in Visual Studio Code.
2. Clicchi su ***Impostazioni*** nel pannello Codex, quindi su ***Impostazioni MCP*** – ***Apri config.toml***. Clicchi per creare un nuovo file di configurazione o utilizzi quello attuale.
3. Aggiunga il seguente contenuto:

   ```
   [mcp_servers."rdm-mcp"]

   command = 'C:\Program Files\Devolutions\Remote Desktop Manager\runtimes\win-x64\native\jetsocat.exe'

   args    = ['mcp-proxy', '-', 'np://RDM.MCP']
   ```

{% hint style="info" %}
Il server MCP può essere impostato per avviarsi all'avvio di Remote Desktop Manager selezionando l'opzione situata in ***File*** – ***Impostazioni*** – ***AI*** – ***Server MCP (sperimentale)***.
{% endhint %}

### Strumenti

Come indicato sopra, i server MCP di Remote Desktop Manager offrono strumenti che possono essere richiamati tramite prompt utilizzando il suo client MCP. I client MCP le permettono di selezionare gli strumenti che meglio si adattano alle sue esigenze.

{% hint style="success" %}
Un buon modo per ridurre i rischi per la sicurezza è disabilitare gli strumenti in grado di eliminare dati sensibili o infrastrutture complesse.
{% endhint %}

Per maggiori dettagli su ciascuno strumento, chieda al suo LLM un elenco o consulti le tabelle seguenti.

| Gestione degli spazi di lavoro |                                                                         |
| ------------------------------ | ----------------------------------------------------------------------- |
| `RDM_list_datasources`         | Elenca tutti gli spazi di lavoro disponibili in Remote Desktop Manager. |

**GESTIONE DELLE VOCI**

| Operazioni di base sulle voci |                                                           |
| ----------------------------- | --------------------------------------------------------- |
| `RDM_list_entries`            | Elenca tutte le voci in una cassaforte.                   |
| `RDM_get_entry`               | Recupera informazioni dettagliate su una voce specifica.  |
| `RDM_create_folders`          | Crea strutture di cartelle all'interno di una cassaforte. |

| Modifica delle voci          |                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------ |
| `RDM_update_entry_name`      | Aggiorna il nome di una voce.                                                        |
| `RDM_update_entry_host`      | Aggiorna l'indirizzo host/server di una voce.                                        |
| `RDM_update_entry_host_port` | Aggiorna il numero di porta di una voce.                                             |
| `RDM_update_entry_username`  | <p>Aggiorna il campo</p><p><em><strong>Username</strong></em></p><p>di una voce.</p> |
| `RDM_update_entry_password`  | <p>Aggiorna il campo</p><p><em><strong>Password</strong></em></p><p>di una voce.</p> |
| `RDM_update_entry_domain`    | <p>Aggiorna il campo</p><p><em><strong>Domain</strong></em></p><p>di una voce.</p>   |
| `RDM_batch_edit_entries`     | Modifica in batch più voci utilizzando mappature di proprietà.                       |

| Organizzazione delle voci |                                                                              |
| ------------------------- | ---------------------------------------------------------------------------- |
| `RDM_move_entries`        | Sposta più voci in una cartella diversa all'interno della stessa cassaforte. |
| `RDM_copy_entries`        | Copia più voci in una cartella diversa o nella radice di una cassaforte.     |

| Gestione OTP           |                                                                                                            |
| ---------------------- | ---------------------------------------------------------------------------------------------------------- |
| `RDM_add_otp_to_entry` | Aggiunge una configurazione di one-time password (OTP) o di autenticazione a più fattori (MFA) a una voce. |
| `RDM_get_entry_otp`    | Genera e recupera l'OTP corrente per una voce.                                                             |

**GESTIONE DELLE CONNESSIONI**

| Azioni comuni                          |                                                                    |
| -------------------------------------- | ------------------------------------------------------------------ |
| `close_connection`                     | Chiude una scheda di connessione.                                  |
| `get_connection_info`                  | Ottiene le informazioni (nome, tipo, ID) di una connessione.       |
| `RDM_open_connection`                  | Apre una voce di sessione in Remote Desktop Manager.               |
| `RDM_list_opened_connections`          | Elenca tutte le connessioni attualmente aperte.                    |
| `RDM_list_opened_connection_actions`   | Elenca le azioni disponibili per le connessioni aperte (per tipo). |
| `RDM_execute_opened_connection_action` | Esegue azioni sulle connessioni aperte.                            |

| Connessioni RDP        |                                                                            |
| ---------------------- | -------------------------------------------------------------------------- |
| `send_ctrl_alt_delete` | Invia <kbd>CTRL</kbd>+<kbd>Alt</kbd>+<kbd>Delete</kbd> a una sessione RDP. |
| `send_command`         | Esegue comandi tramite Devolutions Agent sulla macchina remota.            |
| `logoff`               | Esegue la disconnessione da una sessione RDP.                              |
| `toggle_view_only`     | Attiva/disattiva la modalità solo visualizzazione.                         |

| Connessioni SSH                          |                                                                                     |
| ---------------------------------------- | ----------------------------------------------------------------------------------- |
| `send_command`                           | Invia comandi a un terminale SSH.                                                   |
| `send_command_from_a_vault_script_entry` | Esegue voci di script della cassaforte su un terminale SSH.                         |
| `send_break`                             | Invia un segnale di interruzione (<kbd>CTRL</kbd>+<kbd>C</kbd>) a un terminale SSH. |
| `clear_terminal`                         | Cancella lo schermo del terminale SSH.                                              |
| `get_terminal_status`                    | Recupera lo stato della connessione e lo stato del terminale SSH.                   |

| Connessioni SQL Server |                                                                                        |
| ---------------------- | -------------------------------------------------------------------------------------- |
| `start_sql_agent`      | Avvia il servizio SQL Server Agent.                                                    |
| `stop_sql_agent`       | Arresta il servizio SQL Server Agent.                                                  |
| `restart_sql_server`   | Riavvia il servizio SQL Server.                                                        |
| `refresh_data`         | Aggiorna i dati di SQL Server (database, account di accesso, ecc.).                    |
| `create_new_query`     | Crea una nuova scheda di query SQL con il testo della query e il database specificati. |
| `get_database_schema`  | Recupera uno schema di database completo (tabelle, colonne, relazioni, ecc.).          |

| Macchine virtuali Hyper-V |                                                       |
| ------------------------- | ----------------------------------------------------- |
| `list_vms`                | Elenca tutte le macchine virtuali su un host Hyper-V. |
| `start_vm`                | Avvia una macchina virtuale.                          |
| `stop_vm`                 | Arresta una macchina virtuale.                        |
| `restart_vm`              | Riavvia una macchina virtuale.                        |

| gestione delle casseforti  |                                                                                    |
| -------------------------- | ---------------------------------------------------------------------------------- |
| `RDM_create_vaults`        | Crea una o più casseforti con richieste intelligenti per le informazioni mancanti. |
| `RDM_list_vaults`          | Elenca tutte le casseforti in uno spazio di lavoro specificato.                    |
| `RDM_list_vault_templates` | Elenca i modelli di cassaforte disponibili per uno spazio di lavoro specificato.   |

| Metadati e modelli                 |                                                                                                               |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `RDM_list_entry_metadata`          | Fornisce metadati sui tipi di voce e sui relativi nomi visualizzati localizzati.                              |
| `RDM_list_entry_property_mappings` | Elenca tutte le proprietà delle voci disponibili che possono essere modificate tramite la modifica in blocco. |
| `RDM_create_custom_entry_template` | Crea modelli di voce personalizzati con i campi specificati.                                                  |

| Registrazione e audit |                                                                                |
| --------------------- | ------------------------------------------------------------------------------ |
| `RDM_get_entry_logs`  | Recupera i log delle attività per una voce specifica in un intervallo di date. |


---

# 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/rdm/it/ribbon-menu-bar/tools/all-tools/mcp-server.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.