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, dispubblicare, approvare, bloccare, impacchettare e registrare server MCP per l'uso negli ambienti Dataverse.

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
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
--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
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
--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.

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
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
--dry-run Mostra cosa sarebbe stato fatto senza eseguire
-?, -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
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
--dry-run Mostra cosa sarebbe stato fatto senza eseguire
-?, -h, --help Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp approve

Approvare un server MCP.

a365 develop-mcp approve [options]

Questo comando approva un server MCP da usare nell'ambiente.

Opzioni approve

Option Description
-s, --server-name <server-name> Nome del server MCP da approvare
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
--dry-run Mostra cosa sarebbe stato fatto senza eseguire
-?, -h, --help Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp block

Bloccare un server MCP.

a365 develop-mcp block [options]

Usare questo comando per impedire l'uso di un server MCP nell'ambiente.

Opzioni block

Option Description
-s, --server-name <server-name> Nome del server MCP da bloccare
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
--dry-run Mostra cosa sarebbe stato fatto senza eseguire
-?, -h, --help Visualizzare informazioni sulla Guida e sull'utilizzo

develop-mcp package-mcp-server

Generare un pacchetto server MCP per l'invio nell'interfaccia di amministrazione di Microsoft.

a365 develop-mcp package-mcp-server [options]

Usare questo comando per creare un pacchetto di distribuzione per un server MCP che è possibile inviare all'interfaccia di amministrazione Microsoft.

Opzioni package-mcp-server

Option Description
--server-name <server-name> Nome server MCP (OBBLIGATORIO)
--developer-name <developer-name> Nome visualizzato del server di pubblicazione o dello sviluppatore (OBBLIGATORIO)
--icon-url <icon-url> URL pubblico a un'icona PNG per il server MCP (OBBLIGATORIO)
--output-path <output-path> Directory di destinazione per il pacchetto ZIP generato (REQUIRED)
--dry-run Mostra cosa sarebbe stato fatto senza eseguire
-c, --config <config> Percorso del file di configurazione (impostazione predefinita: a365.config.json)
-?, -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
--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
  • Last updated on