For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 è sul PATH del 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

OPZIONE
CHE COSA FA

--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:

AREA
ESEMPI

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 mcp avvia il processo in background di Devolutions CLI prima di rispondere al client, a meno che non avvii il server con --daemon require, --daemon never o --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-only li nasconde.

  • Il server viene eseguito come lei. Qualsiasi programma che può avviare devo mcp con l’account utente ottiene lo stesso accesso alle casseforti.

Successivo

Ultimo aggiornamento

È stato utile?