Informazioni di riferimento sul comando dell'interfaccia della riga di comando di Agent 365 develop-mcp

Gestire i server MCP in ambienti Dataverse. Il develop-mcp comando offre opzioni per pubblicare, disattivare e registrare server MCP per l'uso negli ambienti Dataverse.

Note

I develop-mcp approvecomandi , develop-mcp block, e develop-mcp package-mcp-server sono stati rimossi dalla CLI dell'Agente 365. Gli amministratori dei tenant ora eseguono l'approvazione e il blocco del server nel centro amministrativo Microsoft — le richieste pendenti vengono esaminate nella pagina Requested Agents. La CLI non produce più pacchetti server MCP per l'invio tramite Admin Center; Admin a bordo e gestiscono i server direttamente nel centro amministratore.

Ruolo minimo richiesto: varia in base al sottocomando

Syntax

a365 develop-mcp [command] [options]

Options

Option	Description
-v, --verbose	Abilitare la registrazione dettagliata
-?, -h, --help	Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp list-environments

Elencare tutti gli ambienti Dataverse disponibili per la gestione del server MCP.

a365 develop-mcp list-environments [options]

Questo comando visualizza tutti gli ambienti Dataverse in cui è possibile gestire i server MCP.

Opzioni list-environments

Option	Description
--dry-run	Mostra cosa sarebbe stato fatto senza eseguire
-v, --verbose	Abilitare la registrazione dettagliata
-?, -h, --help	Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp list-servers

Elencare i server MCP in un ambiente Dataverse specifico.

a365 develop-mcp list-servers [options]

Questo comando mostra tutti i server MCP attualmente distribuiti nell'ambiente Dataverse specificato.

Opzioni list-servers

Option	Description
-e, --environment-id <environment-id>	ID dell'ambiente Dataverse
--dry-run	Mostra cosa sarebbe stato fatto senza eseguire
-v, --verbose	Abilitare la registrazione dettagliata
-?, -h, --help	Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp publish

Pubblicare un server MCP in un ambiente Dataverse.

a365 develop-mcp publish [options]

Usare questo comando per pubblicare un server MCP nell'ambiente Dataverse specificato.

Quando pubblichi, la CLI crea una registrazione <server-name>-PublicClients Microsoft Entra app nel tuo tenant. Questa app detiene i permessi OAuth che gli host client (come Visual Studio Code e la CLI Microsoft 365 Copilot) usano per chiamare il server MCP pubblicato. Poiché il comando crea una registrazione dell'app, l'account che esegue la CLI deve avere il permesso Application.ReadWrite.All Microsoft Graph. Funzionare publish senza fallisce.

Note

Fornire --publisher-name server MCP personalizzati (creati dagli utenti). Il valore viene scritto sui metadati sviluppatori del pacchetto pubblicato ed è richiesto per questi server. Viene ignorato per i server di proprietà di Microsoft di prima parte (ad esempio, msdyn_DataverseMCPServer), che pubblicano sempre come "Microsoft". Quando lo ometti, la CLI lo avvia in modo interattivo; passare --yes per pubblicare senza prompt in contesti CI o scriptati.

Opzioni publish

Option	Description
-e, --environment-id <environment-id>	ID dell'ambiente Dataverse
-s, --server-name <server-name>	Nome del server MCP da pubblicare
-a, --alias <alias>	Alias per il server MCP
-d, --display-name <display-name>	Nome visualizzato per il server MCP
-p, --publisher-name <publisher-name>	Nome Publisher scritto sui metadati del pacchetto pubblicato. Richiesto per server MCP personalizzati (creati dall'utente); ignorati per server di proprietà Microsoft di prima parte. Stimolato in modo interattivo quando omesso.
-y, --yes	Saltare la modalità interattiva "Procedere con la pubblicazione? (y/N)" confirmation. Uso in contesti CI o scriptati.
--dry-run	Mostra cosa sarebbe stato fatto senza eseguire
-v, --verbose	Abilitare la registrazione dettagliata
-?, -h, --help	Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp unpublish

Annullare la pubblicazione di un server MCP da un ambiente Dataverse.

a365 develop-mcp unpublish [options]

Usare questo comando per rimuovere un server MCP dall'ambiente Dataverse specificato.

Opzioni unpublish

Option	Description
-e, --environment-id <environment-id>	ID dell'ambiente Dataverse
-s, --server-name <server-name>	Nome del server MCP per annullare la pubblicazione
--dry-run	Mostra cosa sarebbe stato fatto senza eseguire
-?, -h, --help	Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp register-external-mcp-server

Registra un server MCP esterno con Entra, OAuth esterno, chiave API o senza autenticazione.

a365 develop-mcp register-external-mcp-server [options]

Usa questo comando per registrare un server MCP ospitato esternamente (di terze parti) presso il tuo inquilino. Il comando crea le registrazioni dell'app Microsoft Entra di cui la piattaforma ha bisogno, chiama la piattaforma Agent 365 per aggiungere il server MCP e configura gli URI di reindirizzamento e i permessi API sulle nuove registrazioni dell'app.

Il nome del server deve iniziare con il ext_ prefisso ed essere lungo al massimo 20 caratteri, ad esempio ext_MyServer. I nomi degli strumenti devono corrispondere esattamente ai nomi esposti dal server MCP remoto. I nomi non corrispondenti causano fallimento delle invocazioni degli strumenti a runtime.

Puoi fornire i parametri in tre modi:

• Passale come opzioni in linea di comando.
• Fornisci un file JSON con --input-file. Le opzioni della riga di comando sovrascrivono i valori del file. Vedi register-external-mcp-server-sample.json nei template CLI la struttura del file.
• Ometti qualsiasi valore necessario da stimolare in modo interattivo.

Dopo che la registrazione avrà avuto successo, chiedi al tuo amministratore tenant di approvare il nuovo server MCP prima che gli agenti possano utilizzarlo. Se ti sei registrato con ExternalOAuth, aggiungi anche l'URI di reindirizzamento visualizzato alla tua applicazione IDP esterna.

Important

Se la registrazione fallisce dopo la creazione delle registrazioni dell'app Microsoft Entra, le app non vengono automaticamente annullate. Eliminali manualmente dal portale Azure prima di riprovare.

Opzioni register-external-mcp-server

Alcune opzioni sono richieste solo per tipi specifici di autenticazione, come descritto nella colonna di descrizione.

Option	Description
-s, --server-name <server-name>	Nome del server MCP. Deve iniziare con ext_ e avere al massimo 20 caratteri, ad esempio ext_MyServer
-u, --server-url <server-url>	URL remoto del server MCP. Deve essere un URL HTTP o HTTPS valido
-a, --auth-type <auth-type>	Tipo di autenticazione: EntraOAuth, ExternalOAuth, APIKey, o NoAuth
--publisher <publisher>	Publisher name (usato nei metadati del pacchetto)
--description <description>	Descrizione del server (utilizzata nei metadati del pacchetto)
--tools <tools>	Ad esempio, elenco separato da virgole dei nomi degli strumenti esposti da questo server tool1,tool2,tool3
-f, --input-file <input-file>	Percorso verso un file JSON con i parametri di registrazione
--remote-scopes <remote-scopes>	Scope per il server MCP remoto, ad api://{appId-guid}/{scopeName}esempio. Usato con EntraOAuth
-t, --tenant-id <tenant-id>	Entra tenant ID per la registrazione dell'app. Predefinito all'attuale az login inquilino
--service-tree-id <service-tree-id>	ServiceTree ID per la registrazione dell'app Entra. Richiesto nei tenant aziendali Microsoft
-l, --secret-lifetime-months <months>	Durata di vita in mesi (1-24) per i segreti dei client generati sulle app Entra create. Il tempo predefinito è di 24 mesi (2 anni). Stabilisci un valore inferiore al appManagementPolicies limite massimo per il tuo inquilino se la tua politica applica un massimo più breve
--idp-authorization-url <url>	URL di autorizzazione OAuth esterno. Obbligatorio quando --auth-type è ExternalOAuth
--idp-token-url <url>	URL esterno del token OAuth. Obbligatorio quando --auth-type è ExternalOAuth
--idp-scopes <scopes>	Scope OAuth esterni. Obbligatorio quando --auth-type è ExternalOAuth
--idp-client-id <client-id>	ID client OAuth esterno. Obbligatorio quando --auth-type è ExternalOAuth
--idp-client-secret <client-secret>	Segreto client OAuth esterno. Obbligatorio quando --auth-type è ExternalOAuth
--api-key-location <location>	Posizione della chiave API: Header oppure Query. Obbligatorio quando --auth-type è APIKey
--api-key-name <name>	Parametro o nome dell'intestazione della chiave API, ad esempio X-API-Key o token. Obbligatorio quando --auth-type è APIKey
--dry-run	Mostra cosa sarebbe stato fatto senza eseguire
-v, --verbose	Abilitare la registrazione dettagliata
-?, -h, --help	Visualizzare informazioni sulla Guida e sull'utilizzo