Naslaginformatie over cli-opdrachten develop-mcp voor agent 365

MCP-servers beheren in Dataverse-omgevingen. Het develop-mcp commando biedt opties om MCP-servers te publiceren, depubliceren, goedkeuren, blokkeren, verpakken en registreren voor gebruik in Dataverse-omgevingen.

Minimale rol vereist: varieert per subopdracht

Syntax

a365 develop-mcp [command] [options]

Options

Option Description
-v, --verbose Uitgebreide logboekregistratie inschakelen
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp list-environments

Vermeld alle Dataverse-omgevingen die beschikbaar zijn voor MCP-serverbeheer.

a365 develop-mcp list-environments [options]

Met deze opdracht worden alle Dataverse-omgevingen weergegeven waar u MCP-servers kunt beheren.

list-environments Opties

Option Description
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-v, --verbose Uitgebreide logboekregistratie inschakelen
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp list-servers

Geef MCP-servers weer in een specifieke Dataverse-omgeving.

a365 develop-mcp list-servers [options]

Met deze opdracht worden alle MCP-servers weergegeven die momenteel zijn geïmplementeerd in de opgegeven Dataverse-omgeving.

list-servers Opties

Option Description
-e, --environment-id <environment-id> ID van Dataverse-omgeving
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-v, --verbose Uitgebreide logboekregistratie inschakelen
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp publish

Publiceer een MCP-server naar een Dataverse-omgeving.

a365 develop-mcp publish [options]

Gebruik deze opdracht om een MCP-server te publiceren naar de opgegeven Dataverse-omgeving.

publish Opties

Option Description
-e, --environment-id <environment-id> ID van Dataverse-omgeving
-s, --server-name <server-name> MCP-servernaam om te publiceren
-a, --alias <alias> Alias voor de MCP-server
-d, --display-name <display-name> Weergavenaam voor de MCP-server
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp unpublish

De publicatie van een MCP-server ongedaan maken vanuit een Dataverse-omgeving.

a365 develop-mcp unpublish [options]

Gebruik deze opdracht om een MCP-server te verwijderen uit de opgegeven Dataverse-omgeving.

unpublish Opties

Option Description
-e, --environment-id <environment-id> ID van Dataverse-omgeving
-s, --server-name <server-name> MCP-servernaam om publicatie ongedaan te maken
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp approve

Een MCP-server goedkeuren.

a365 develop-mcp approve [options]

Met deze opdracht wordt een MCP-server goedgekeurd voor gebruik in de omgeving.

approve Opties

Option Description
-s, --server-name <server-name> MCP-servernaam die moet worden goedgekeurd
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp block

Een MCP-server blokkeren.

a365 develop-mcp block [options]

Gebruik deze opdracht om te voorkomen dat een MCP-server in uw omgeving wordt gebruikt.

block Opties

Option Description
-s, --server-name <server-name> MCP-servernaam die moet worden geblokkeerd
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp package-mcp-server

Genereer een MCP-serverpakket voor verzending in Microsoft beheercentrum.

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

Gebruik deze opdracht om een implementatiepakket te maken voor een MCP-server die u kunt verzenden naar het Microsoft-beheercentrum.

package-mcp-server Opties

Option Description
--server-name <server-name> MCP-servernaam (VEREIST)
--developer-name <developer-name> Weergavenaam van uitgever of ontwikkelaar (VEREIST)
--icon-url <icon-url> Openbare URL naar een PNG-pictogram voor de MCP-server (VEREIST)
--output-path <output-path> Doelmap voor het gegenereerde ZIP-pakket (VEREIST)
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-c, --config <config> Pad naar configuratiebestand (standaard: a365.config.json)
-?, , -h--help Help- en gebruiksgegevens weergeven

develop-mcp register-external-mcp-server

Registreer een externe MCP-server met Entra, externe OAuth, API-sleutel of geen authenticatie.

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

Gebruik dit commando om een extern gehoste (derdepartij) MCP-server bij je tenant te registreren. Het commando maakt de Microsoft Entra-appregistraties aan die het platform nodig heeft, roept het Agent 365-platform aan om de MCP-server toe te voegen, en configureert de omleidings-URI's en API-rechten op de nieuwe app-registraties.

De servernaam moet beginnen met het ext_ voorvoegsel en maximaal 20 tekens lang zijn, bijvoorbeeld ext_MyServer. Toolnamen moeten exact overeenkomen met de namen die door de externe MCP-server worden blootgesteld. Niet overeenkomende namen zorgen ervoor dat tool-aanroepen tijdens runtime falen.

Je kunt parameters op drie manieren invoeren:

  • Geef ze door als commandoregelopties.
  • Geef een JSON-bestand met --input-file. Commandoregelopties overschrijven waarden uit het bestand. Zie register-external-mcp-server-sample.json in de CLI-sjablonen voor de bestandsstructuur.
  • Laat alle vereiste waarde die interactief wordt geïnspireerd weg.

Nadat de registratie succesvol is, vraag je je tenant-beheerder om de nieuwe MCP-server goed te keuren voordat agenten deze kunnen gebruiken. Als je je hebt geregistreerd bij ExternalOAuth, voeg ook de weergegeven redirect-URI toe aan je externe IDP-applicatie.

Important

Als de registratie faalt nadat de Microsoft Entra-appregistraties zijn aangemaakt, worden de apps niet automatisch teruggedraaid. Verwijder ze handmatig in het Azure-portaal voordat je het opnieuw probeert.

register-external-mcp-server Opties

Sommige opties zijn alleen nodig voor specifieke authenticatietypen, zoals beschreven in de kolom beschrijving.

Option Description
-s, --server-name <server-name> MCP-servernaam. Moet bijvoorbeeld beginnen met ext_ maximaal 20 tekens en maximaal 20 tekens zijn ext_MyServer
-u, --server-url <server-url> Externe MCP-server-URL. Moet een geldige HTTP- of HTTPS-URL zijn
-a, --auth-type <auth-type> Authenticatietype: EntraOAuth, ExternalOAuth, , APIKey, of NoAuth
--publisher <publisher> Publisher-naam (gebruikt in pakketmetadata)
--description <description> Serverbeschrijving (gebruikt in pakketmetadata)
--tools <tools> Een door comma gescheiden lijst van toolnamen die door deze server worden blootgesteld, bijvoorbeeld tool1,tool2,tool3
-f, --input-file <input-file> Pad naar een JSON-bestand met de registratieparameters
--remote-scopes <remote-scopes> Scopes voor de externe MCP-server, bijvoorbeeld api://{appId-guid}/{scopeName}. Wordt gebruikt met EntraOAuth
-t, --tenant-id <tenant-id> Entra tenant ID voor de app-registratie. Standaard naar de huidige az login huurder
--service-tree-id <service-tree-id> ServiceTree ID voor de Entra-appregistratie. Vereist in Microsoft-bedrijfstenants
--idp-authorization-url <url> Externe OAuth-autorisatie-URL. Vereist wanneer --auth-type is ExternalOAuth
--idp-token-url <url> Externe OAuth-token URL. Vereist wanneer --auth-type is ExternalOAuth
--idp-scopes <scopes> Externe OAuth-scopen. Vereist wanneer --auth-type is ExternalOAuth
--idp-client-id <client-id> Externe OAuth client ID. Vereist wanneer --auth-type is ExternalOAuth
--idp-client-secret <client-secret> Externe OAuth-clientgeheim. Vereist wanneer --auth-type is ExternalOAuth
--api-key-location <location> API-sleutellocatie: Header of Query. Vereist wanneer --auth-type is APIKey
--api-key-name <name> API-sleutelparameter of headernaam, bijvoorbeeld X-API-Key of token. Vereist wanneer --auth-type is APIKey
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-v, --verbose Uitgebreide logboekregistratie inschakelen
-?, , -h--help Help- en gebruiksgegevens weergeven
  • Last updated on