Connettere un client IA con MCP
devo mcp trasforma Devolutions CLI in un server Model Context Protocol (MCP). Il client IA lo avvia e il modello ottiene strumenti per lavorare sullo spazio di lavoro: elencare le casseforti, cercare le voci, esaminare l’accesso, generare password e altro. È lo stesso spazio di lavoro e le stesse autorizzazioni dei comandi devo che esegue lei.
Prima di iniziare
Devolutions CLI è installato e il comando
devoè sulPATHdel client IA.Ha effettuato l’accesso. Il server MCP non ha uno strumento di accesso: usa i contesti salvati con
devo login, a partire da quello corrente. Consulti Connettersi agli spazi di lavoro.Il client MCP può avviare un server locale tramite input e output standard (stdio), come fanno la maggior parte dei client.
Aggiunga il server al suo client
La maggior parte dei client MCP descrive un server locale con un comando e i suoi argomenti. Aggiunga una voce come questa alla configurazione MCP del client:
{
"mcpServers": {
"devolutions": {
"command": "devo",
"args": ["mcp", "--deny-tool", "RDM_resolve_secret_reference"]
}
}
}La chiave che contiene i server (mcpServers qui) e il file in cui va dipendono dal client. Consulti la documentazione del client per sapere dove aggiungere un server stdio locale.
Riavvii il client o ricarichi i suoi server MCP. Il client avvia devo mcp da solo e lo ferma quando la sessione finisce: non lo esegue in un terminale.
Opzioni che può aggiungere
--context <context-name>
Usa questo contesto salvato invece di quello corrente. Utile quando l’agente deve lavorare su un solo spazio di lavoro.
--read-only, --deny-destructive, --deny-open-world, --allow-tool, --deny-tool
Limiti gli strumenti che il modello ottiene. Consulti Limitare ciò che un agente può fare.
--server-name <name>
Nome del server inviato al client quando si connette. Il valore predefinito è Remote Desktop Manager Devo CLI MCP Server.
Per esempio, per dare a un agente accesso in sola lettura a un solo spazio di lavoro:
Che cosa può fare il modello
Tutti i nomi degli strumenti iniziano con RDM_. Coprono queste aree:
Spazi di lavoro
Elenca gli spazi di lavoro che la sessione può usare (profilo locale e ogni contesto salvato di Devolutions Cloud o Devolutions Server) e passa dall’uno all’altro per il resto della sessione.
Casseforti e voci
Elencare casseforti, cercare voci, ottenere una voce, elencare metadati, allegati, autorizzazioni e log; creare, aggiornare o eliminare casseforti; aggiornare, spostare o eliminare voci; esportare i log delle attività in un file locale.
Utenti e accesso
Elencare utenti e gruppi, creare o eliminare gruppi, eliminare utenti, elencare l’accesso alle casseforti, concedere o revocare un ruolo di cassaforte, elencare ruoli di sicurezza e set di autorizzazioni.
Password
Generi in locale password robuste, leggibili, passphrase o password da modello.
Segreti
Risolve un riferimento devo:// nel suo valore (RDM_resolve_secret_reference). La risposta contiene il segreto.
Processo in background
Controlla, avvia, ricarica, riavvia o arresta il processo in background di Devolutions CLI.
Gli strumenti che creano, modificano o eliminano casseforti, voci, gruppi, utenti o accessi richiedono una conferma esplicita nella richiesta. È il modello a dare quella conferma, non lei: per tenere il modello lontano dalle modifiche, usi --read-only.
Il server MCP non può avviare programmi con segreti: perché un agente esegua uno strumento con una credenziale, usi devo secret run. Consulti Dare una credenziale a un agente senza esporla.
Vedere l’elenco degli strumenti
Per vedere quali strumenti il server espone, senza avviarlo:
Nel risultato JSON, gli strumenti che il server esporrebbe hanno "visible": true. L’output di testo mostra solo i primi 25. devo mcp catalog accetta le stesse opzioni di restrizione di devo mcp, quindi può vedere in anteprima una configurazione prima di darla al client. Un’eccezione: l’anteprima contrassegna sempre RDM_resolve_secret_reference come nascosto, anche quando devo mcp lo esporrebbe. Consulti Limitare ciò che un agente può fare.
Buono a sapersi
Il processo in background si avvia da solo. Quando il server ha bisogno dello spazio di lavoro,
devo mcpavvia il processo in background di Devolutions CLI prima di rispondere al client, a meno che non avvii il server con--daemon require,--daemon nevero--no-daemon-autostart. Se gli strumenti segnalano che il processo non è disponibile, consulti Il processo in background non si avvia.Lo spazio di lavoro della sessione può cambiare. A meno che non avvii il server con
--read-only, il modello può cambiare lo spazio di lavoro per il resto della sessione, tra il profilo locale e i contesti che ha salvato. Gli strumenti che lo cambiano non sono di sola lettura, quindi--read-onlyli nasconde.Il server viene eseguito come lei. Qualsiasi programma che può avviare
devo mcpcon l’account utente ottiene lo stesso accesso alle casseforti.
Successivo
Ultimo aggiornamento
È stato utile?