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

Note

De Agent 365 CLI bevat niet langer de develop-mcp approve, develop-mcp block, en develop-mcp package-mcp-server commando's. 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

Een lokale server evalueren met automatische engineselectie:

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

Evalueer een geverifieerde server, waarbij het token wordt geleverd via een omgevingsvariabele en artefacten die 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"

Genereer alleen de checklist en scoor deze vervolgens met je eigen LLM:

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

Een specifieke score-engine forceren:

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 je niet doorgeeft --auth-token. Gebruik deze variabele in plaats van de vlag, omdat het de token buiten proceslijsten en shellgeschiedenis houdt.
A365_EVAL_COPILOT_MODEL Overrul het GitHub Copilot-model. Vereist een exacte model-ID, zoals claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL Overschrijf het Claude Code-model. Accepteert een modelalias (zoals haiku) of een volledige model-ID.

develop-mcp grant-agents-access

Verleen toestemming van een bring-your-own (BYO) MCP-server aan agentidentiteiten die deze missen.

a365 develop-mcp grant-agents-access --mcp-server-name <NAME> --agent-blueprint-id <GUID> [options]

Minimaal vereiste permissies: Globale Administrator (of een andere rol met rechten om tenant-brede OAuth2-toestemmingen te creëren)

Gebruik dit commando om agentidentiteiten te vinden en te fixen die geen bring-your-own (BYO) MCP-server kunnen aanroepen omdat ze de Tools.ListInvoke.All toestemming daarvoor missen. Het commando geeft een lijst van de agentinstanties van de gespecificeerde blueprint die de toestemming missen, en laat je vervolgens kiezen aan welke je het toekent.

De naam van de MCP-server wordt opgelost in een Microsoft Entra-applicatie waarbij - BYO aan de naam wordt toegevoegd. Wordt ext_Learn1 bijvoorbeeld omgezet in ext_Learn1 - BYO. De grant zelf is een tenant-brede (AllPrincipals) gedelegeerde OAuth2-toestemmingsgrant op de dienstprincipal van die applicatie, dus het geldt voor elke huidige en toekomstige agent-instantie van de blueprint, niet alleen voor de exemplaren die tijdens de run staan vermeld.

Je kent de blauwdruk GUID meestal niet van tevoren. Als je zonder --agent-blueprint-id waarde of ongeldig is, wordt de namen en ID's van Microsoft van de eerste partij geprint zodat je het kunt vinden. Passing --help print dezelfde lijst.

Nadat het commando rapporteert dat agentinstanties de toestemming missen, geef Enter all om deze aan elke getoonde instantie toe te kennen, een komma-gescheiden lijst van de weergegeven nummers (bijvoorbeeld 1,3) om deze aan specifieke instanties toe te kennen, of druk Enter om het verlenen over te slaan. Geef --yes door naar grant aan elke vermelde instantie zonder prompt, bijvoorbeeld in een script.

Als meer dan één Entra-applicatie dezelfde <name> - BYO weergavenaam heeft, geeft het commando alle overeenkomsten weer en vraagt welke gebruikt moet worden in plaats van te raden.

Het commando gebruikt niet de client-app die is geconfigureerd in a365.config.json. In plaats daarvan logt het in als de Microsoft Graph Command Line Tools-applicatie (14d82eec-204b-4c2f-b7e8-296a70dab67e) en vraagt het om de volgende Microsoft Graph gedelegeerde scopes:

  • Application.Read.All
  • AgentIdentity.Read.All
  • DelegatedPermissionGrant.ReadWrite.All

De eerste keer dat je het commando uitvoert in een tenant, zie je een admin-toestemmingsprompt voor deze scopes. Een Global Administrator of Privileged Role Administrator moet deze scopes toewijzen aan de Microsoft Graph Command Line Tools enterprise-applicatie. Na toestemming vereist elke run slechts één aanmelding. Als het commando geen token kan verkrijgen, geeft het foutbericht de applicatie en de scopes die het commando heeft aangevraagd een naam.

grant-agents-access Opties

Option Description
--agent-blueprint-id <agent-blueprint-id> Agent blueprint ID (GUID) voor de agentinstanties om te controleren. Als je deze optie weglaat of een ongeldige waarde geeft, print het commando de namen en ID's van de eerste partij blauwdrukken.
-s, --mcp-server-name <mcp-server-name> Required. MCP-servernaam. De Entra-toepassing lost op als <name> - BYO.
--tenant-id <tenant-id> Azure AD-tenant-id. Standaard is de huidige Azure CLI-context.
-y, --yes Verleen de ontbrekende toestemming aan elke vermelde agentinstantie zonder dat je erom vraagt.
--device-code Gebruik apparaatcode-authenticatie in plaats van de interactieve browserflow (de WAM-broker op Windows). Gebruik wanneer WAM geen inlogdialoog kan tonen, zoals een ingebedde of externe terminal. Opent https://microsoft.com/devicelogin in je browser.
--dry-run Rapporteer welke agentinstanties de toestemming missen zonder deze te verlenen.
-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
--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]

Dit commando vermeldt alle MCP-servers die momenteel zijn ingezet in de gespecificeerde 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.

Important

Het publiceren van een MCP-server keurt het niet goed. Publiceren stuurt de server alleen naar je tenant en creëert een wachtende goedkeuringsaanvraag. Voordat een agent de server kan gebruiken, moet een tenantbeheerder deze goedkeuren op de pagina Aangevraagde Hulpmiddelen in het Microsoft 365-beheercentrum. Totdat de beheerder het verzoek goedkeurt, blijft de server niet beschikbaar voor agenten. Wanneer het commando slaagt, print de CLI een herinnering om je tenantbeheerder te vragen de server goed te keuren.

Wanneer je publiceert, maakt de CLI de volgende Microsoft Entra-appregistraties aan in je tenant:

App registration Purpose When created
<server-name>-PublicClients Bevat de OAuth-rechten die clienthosts (zoals Visual Studio Code en de Microsoft Copilot CLI) gebruiken om de gepubliceerde MCP-server aan te roepen. De CLI maakt deze app voor elke server.
<server-name>-A365Proxy Fungeert als een vertrouwelijke client-app met een client secret. De CLI stuurt de inloggegevens van de app door naar het platform, dat deze gebruikt om de Power Platform-connector voor de server te maken. De CLI maakt deze app alleen aan voor aangepaste (niet-Dataverse) MCP-servers. Eerste-partij Dataverse-servers, zoals msdyn_DataverseMCPServer, slaan deze app over omdat het platform hen met een eigen app bedient.

Omdat het commando app-registraties aanmaakt, moet het account dat de CLI draait de Application.ReadWrite.All Microsoft Graph-toestemming hebben. Zonder deze toestemming publish faalt het. Als publicatie faalt, verwijdert de CLI de app-registraties die het heeft aangemaakt. Als je de server depubliceert, verwijder dan deze app-registraties handmatig.

In huurders die de levensduur van klantgeheimen beperken met een appManagementPolicies polis, stel --secret-lifetime-months je een levensduur in binnen de limiet voor het <server-name>-A365Proxy cliëntgeheim.

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.
--service-tree-id <service-tree-id> ServiceTree ID voor de Microsoft Entra-appregistraties die publish worden aangemaakt. Vereist in Microsoft corporate tenants.
-l, --secret-lifetime-months <months> Levensduur in maanden (1-24) voor het client secret in de <server-name>-A365Proxy Microsoft Entra-app. Wanneer het wordt weggelaten, past Microsoft Entra ID zijn standaardlevensduur van ongeveer 2 jaar toe. Als de polis van appManagementPolicies je huurder een kortere maximumregeling handhaaft, stel dan een waarde binnen die limiet.
-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

Beoordeel en keur MCP-verzoeken goed

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. Verplicht wanneer --auth-typeExternalOAuth is
--idp-token-url <url> Externe OAuth-token URL. Verplicht wanneer --auth-typeExternalOAuth is
--idp-scopes <scopes> Externe OAuth-scopen. Verplicht wanneer --auth-typeExternalOAuth is
--idp-client-id <client-id> Externe OAuth client ID. Verplicht wanneer --auth-typeExternalOAuth is
--idp-client-secret <client-secret> Externe OAuth-clientgeheim. Verplicht wanneer --auth-typeExternalOAuth is
--api-key-location <location> API-sleutellocatie: Header of Query. Verplicht wanneer --auth-typeAPIKey is
--api-key-name <name> API-sleutelparameter of headernaam, bijvoorbeeld X-API-Key of token. Verplicht wanneer --auth-typeAPIKey is
--dry-run Laten zien wat er zou gebeuren zonder uitvoering
-v, --verbose Uitgebreide logboekregistratie inschakelen
-?, -h, --help Help- en gebruiksgegevens weergeven
  • Laatst bijgewerkt om