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, te depubliceren en te registreren voor gebruik in Dataverse-omgevingen.

Note

De develop-mcp approve, develop-mcp block, en develop-mcp package-mcp-server commando's worden verwijderd uit de Agent 365 CLI. Tenantbeheerders voeren nu servergoedkeuring en -blokkering uit in het Microsoft admin center — lopende verzoeken worden beoordeeld op de pagina Requested Agents. De CLI produceert geen MCP-serverpakketten meer voor Admin Center-indiening; Beheerders installeren en beheren servers direct in het administratiecentrum.

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 evaluate

Beoordeel je MCP-server aan de hand van wetenschappelijke best practices om de productiegereedheid te beoordelen. Deze tool levert een uitgebreid evaluatierapport met scores, uitleg en actiepunten. Het commando ontdekt de tools die een MCP-server blootstelt, voert een reeks deterministische en door AI beoordeelde semantische controles uit tegen hun schema's, en produceert een HTML-rapport dat de kwaliteit van het schema beoordeelt en geprioriteerde actiepunten voor verbetering opsomt.

a365 develop-mcp evaluate --server-url <server-url> [--auth-token <auth-token>] [options]

evaluate Opties

Option	Description
-u, --server-url <server-url>	Required. De streambare HTTP-endpoint-URL van de MCP-server (eindigt meestal op /mcp).
--auth-token <auth-token>	Optional. Alleen nodig wanneer de MCP-server authenticatie vereist. Draagtoken voor de server. Geef de voorkeur aan de A365_MCP_AUTH_TOKEN omgevingsvariabele; een token dat via de commandoregel wordt doorgegeven, is zichtbaar voor proceslijsten en shellgeschiedenis.
-o, --output-dir <output-dir>	Map voor de checklist- en rapportbestanden. Standaard is de huidige map (.).
--eval-engine <eval-engine>	Welke lokale codeeragent beoordeelt de semantische controles: auto (standaard; probeer GitHub Copilot, dan Claude Code), github-copilot, claude-code, of none (sla AI-score over en verwacht een vooraf gescorede checklist).
-v, --verbose	Uitgebreide logboekregistratie inschakelen.
-?, , -h--help	Help- en gebruiksgegevens weergeven.

voorbeelden van evaluate

Evalueer een lokale server met automatische engineselectie:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp"

Evalueer een geauthenticeerde server, waarbij het token via een omgevingsvariabele wordt geleverd en artefacten naar een submap worden geschreven:

$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"

Maak alleen de checklist en beoordeel deze vervolgens met je eigen LLM:

a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --eval-engine none

Dwing een specifieke score-engine af:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp" --eval-engine claude-code

Leer hoe je MCP-servers kunt evalueren

omgevingsvariabelen evaluate

Gebruik de volgende omgevingsvariabelen om authenticatie te bieden en optioneel te bepalen welk model elke lokale score-engine gebruikt.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Bearer-token voor de MCP-server, gebruikt wanneer --auth-token het niet wordt doorgegeven. Voorkeur boven de vlag omdat het de token buiten proceslijsten en shellgeschiedenis houdt.
A365_EVAL_COPILOT_MODEL	Overrul het GitHub Copilot-model. Vereist bijvoorbeeld een exacte model-ID.claude-haiku-4.5
A365_EVAL_CLAUDE_MODEL	Overschrijf het Claude Code-model. Accepteert een modelalias (bijvoorbeeld haiku) of een volledige model-ID.

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

Wanneer je publiceert, maakt de CLI een <server-name>-PublicClients Microsoft Entra app-registratie aan in je tenant. Deze app heeft de OAuth-rechten die clienthosts (zoals Visual Studio Code en de Microsoft 365 Copilot CLI) gebruiken om de gepubliceerde MCP-server aan te roepen. Omdat het commando een app-registratie aanmaakt, moet het account dat de CLI draait de Application.ReadWrite.All Microsoft Graph toestemming hebben. Zonder draaien publish faalt.

Note

Bied --publisher-name aan voor aangepaste (door gebruikers gemaakte) MCP-servers. De waarde wordt geschreven naar de ontwikkelaarsmetadata van het gepubliceerde pakket en is vereist voor deze servers. Het wordt genegeerd voor first-party Microsoft-owned servers (bijvoorbeeld msdyn_DataverseMCPServer), die altijd publiceren als "Microsoft". Wanneer je het weglaat, vraagt de CLI er interactief naar; pass --yes om te publiceren zonder prompts in CI of gescripte contexten.

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
-p, --publisher-name <publisher-name>	Publisher-naam geschreven in de metadata van het gepubliceerde pakket. Vereist voor aangepaste (door gebruikers gemaakte) MCP-servers; genegeerd voor first-party servers in handen van Microsoft. Interactief gepromptt wanneer het werd weggelaten.
-y, --yes	Sla het interactieve "Doorgaan met publiceren?" over. (y/N)" confirmation. Gebruik in CI of gescripte contexten.
--dry-run	Laten zien wat er zou gebeuren zonder uitvoering
-v, --verbose	Uitgebreide logboekregistratie inschakelen
-?, , -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
--dry-run	Laten zien wat er zou gebeuren zonder uitvoering
-?, , -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
-l, --secret-lifetime-months <months>	Levensduur in maanden (1-24) voor gegenereerde clientgeheimen op de gemaakte Entra-apps. Standaard 24 maanden (2 jaar). Stel een waarde in die lager is dan het appManagementPolicies plafond in je huurder als je huurderspolis een korter maximum afdwingt
--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