Agent 365 CLI-kommandoreference develop-mcp

Administrer MCP-servere i Dataverse-miljøer. Kommandoen develop-mcp giver muligheder for at publicere, afpublicere, registrere og give agent-tilladelser til MCP-servere til brug i Dataverse-miljøer.

Note

Agent 365 CLI indeholder develop-mcp approveikke længere , develop-mcp block, og develop-mcp package-mcp-server kommandoerne. Lejeradministratorer udfører nu servergodkendelse og blokering i Microsoft admin center — ventende anmodninger gennemgås på siden Requested Agents. CLI'en producerer ikke længere MCP-serverpakker til indsendelse til administrationscenter; Administratorer ombord og administrerer servere direkte i administrationscentret.

Minimumrolle kræves: Varierer efter underkommando

Syntax

a365 develop-mcp [command] [options]

Indstillinger

Option	Description
-v, --verbose	Aktivér detaljeret logføring
-?, -h, --help	Vis hjælp og brugsvejledning

develop-mcp evaluate

Evaluer din MCP-server mod videnskabelige bedste praksisser for at vurdere produktionsparathed. Dette værktøj udgiver en omfattende evalueringsrapport med scores, forklaringer og handlingspunkter. Kommandoen opdager de værktøjer, en MCP-server eksponerer, kører et sæt deterministiske og AI-scorede semantiske kontroller mod deres skemaer og producerer en HTML-rapport, der vurderer skemakvalitet og oplister prioriterede handlingspunkter til forbedring.

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

evaluate indstillinger

Option	Description
-u, --server-url <server-url>	Required. MCP-serverens streambare HTTP-endpoint-URL (typisk ender på /mcp).
--auth-token <auth-token>	Optional. Kun nødvendigt, når MCP-serveren kræver autentificering. Bærertoken for serveren. Foretrækker A365_MCP_AUTH_TOKEN miljøvariablen; et token, der sendes på kommandolinjen, er synligt for proceslister og shellhistorik.
-o, --output-dir <output-dir>	Mappe til tjekliste- og rapportfiler. Som standard er den aktuelle mappe (.).
--eval-engine <eval-engine>	Hvilken lokal kodningsagent scorer de semantiske tjek: auto (standard; prøv GitHub Copilot, derefter Claude Code), github-copilot, claude-code eller none (spring AI-bedømmelse over og forvent en forudbedømt tjekliste).
-v, --verbose	Aktivér detaljeret logføring.
-?, -h, --help	Vis oplysninger om hjælp og brug.

evaluate Eksempler

Evaluer en lokal server med automatisk programvalg:

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

Evaluer en godkendt server med tokenet leveret via en miljøvariabel og artefakter skrevet til en undermappe:

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

Opret kun tjeklisten, og bedøm den derefter med din egen LLM:

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

Gennemtving et bestemt pointprogram:

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

Lær hvordan du evaluerer MCP-servere

evaluate miljøvariabler

Brug følgende miljøvariabler til at give autentificering og eventuelt styre, hvilken model hver lokal scoringsmotor bruger.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Bærertoken til MCP-serveren, brugt når du ikke passerer --auth-token. Brug denne variabel i stedet for flaget, fordi det holder tokenet ude af proceslister og shell-historik.
A365_EVAL_COPILOT_MODEL	Overstyr GitHub Copilot-modellen. Kræver en nøjagtig model-ID, såsom claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL	Overstyr Claude Code-modellen. Accepterer et modelalias (såsom haiku) eller et fuldt model-ID.

develop-mcp grant-agents-access

Giv en bring-your-own (BYO) MCP-server tilladelse til agentidentiteter, der mangler den.

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

Minimum nødvendige tilladelser: Global administrator (eller en anden rolle med rettigheder til at oprette lejere-dækkende OAuth2-tilladelser)

Brug denne kommando til at finde og rette agentidentiteter, der ikke kan kalde en bring-your-own (BYO) MCP-server, fordi de mangler tilladelsen Tools.ListInvoke.All til den. Kommandoen lister agentinstanserne af den specificerede blueprint, som mangler tilladelsen, og lader dig derefter vælge, hvilke du vil tildele den.

MCP-servernavnet afløses til en Microsoft Entra-applikation, hvor - BYO det tilføjes navnet. For eksempel ext_Learn1 opløses til ext_Learn1 - BYO. Selve tilskuddet er en tenant-wide (AllPrincipals) delegeret OAuth2-tilladelse på applikationens tjenesteprincipal, så det gælder for alle nuværende og fremtidige agentinstanser af blueprintet, ikke kun dem, der er angivet ved kørsel.

Du kender som regel ikke blueprint-GUID'en på forhånd. Hvis du passerer --agent-blueprint-id uden en værdi, eller en ugyldig, udskriver du Microsoft first-party blueprint-navne og ID'er, så du kan finde den. At sende --help dem udskriver den samme liste.

Efter kommandoen rapporterer, at agentinstanserne mangler tilladelsen, skal Enter all gives for at give den til alle viste instanser, en komma-separeret liste over de viste tal (for eksempel 1,3) for at give den til specifikke instanser, eller trykke Enter for at springe fordelingen over. Godkend --yes til at give til hver angivet instans uden prompt, for eksempel i et script.

Hvis mere end én Entra-applikation deler samme <name> - BYO visningsnavn, lister kommandoen alle matches og spørger, hvilken der skal bruges, i stedet for at gætte.

Kommandoen bruger ikke klientappen, der er konfigureret i a365.config.json. I stedet logger den ind som Microsoft Graph Command Line Tools-applikationen (14d82eec-204b-4c2f-b7e8-296a70dab67e) og anmoder om følgende Microsoft Graph-delegerede scopes:

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

Første gang du kører kommandoen i en lejer, ser du en admin-samtykkeprompt for disse scopes. En Global Administrator eller Privileged Role Administrator skal tildele disse scopes til Microsoft Graph Command Line Tools enterprise-applikationen. Efter samtykke kræver hver gennemgang kun én login. Hvis kommandoen ikke kan hente et token, navngiver fejlmeddelelsen applikationen og de scopes, som kommandoen har anmodet om.

grant-agents-access indstillinger

Option	Description
--agent-blueprint-id <agent-blueprint-id>	Agent blueprint ID (GUID) til agentinstanserne at tjekke. Hvis du udelader denne mulighed eller giver en ugyldig værdi, udskriver kommandoen de første parts blueprint-navne og ID'er.
-s, --mcp-server-name <mcp-server-name>	Required. MCP-servernavn. Entra-applikationen afgøres som <name> - BYO.
--tenant-id <tenant-id>	Azure AD-lejer-id. Defaults til den nuværende Azure CLI-kontekst.
-y, --yes	Giv den manglende tilladelse til alle nævnte agentinstanser uden at blive bedt om det.
--device-code	Brug enhedskode-autentificering i stedet for den interaktive browser-flow (WAM-mægleren på Windows). Brug når WAM ikke kan vise en login-dialog, såsom en indlejret eller fjernterminal. Åbner https://microsoft.com/devicelogin i din browser.
--dry-run	Rapportér, hvilke agentinstanser der mangler tilladelsen uden at give den.
-v, --verbose	Aktivér detaljeret logføring
-?, -h, --help	Vis hjælp og brugsvejledning

develop-mcp list-environments

Angiv alle dataversemiljøer, der er tilgængelige til MCP-serveradministration.

a365 develop-mcp list-environments [options]

Denne kommando viser alle Dataverse-miljøer, hvor du kan administrere MCP-servere.

list-environments indstillinger

Option	Description
--dry-run	Vis, hvad der skal gøres uden at udføre
-v, --verbose	Aktivér detaljeret logføring
-?, -h, --help	Vis hjælp og brugsvejledning

develop-mcp list-servers

Vis MCP-servere i et bestemt Dataverse-miljø.

a365 develop-mcp list-servers [options]

Denne kommando lister alle MCP-servere, der aktuelt er deployeret i det specificerede Dataverse-miljø.

list-servers indstillinger

Option	Description
-e, --environment-id <environment-id>	Dataverse-miljø-id
--dry-run	Vis, hvad der skal gøres uden at udføre
-v, --verbose	Aktivér detaljeret logføring
-?, -h, --help	Vis hjælp og brugsvejledning

develop-mcp publish

Publicer en MCP-server til et Dataverse-miljø.

a365 develop-mcp publish [options]

Brug denne kommando til at publicere en MCP-server til det angivne Dataverse-miljø.

Important

At udgive en MCP-server godkender det ikke. Publicering indsender kun serveren til din lejer og opretter en ventende godkendelsesanmodning. Før nogen agent kan bruge serveren, skal en lejeradministrator godkende den på siden Requested Tools i Microsoft 365 Administration. Indtil administratoren godkender anmodningen, forbliver serveren utilgængelig for agenter. Når kommandoen lykkes, udskriver CLI en påmindelse om at bede din lejeradministrator om at godkende serveren.

Når du publicerer, opretter CLI følgende Microsoft Entra-appregistreringer i din lejer:

App registration	Purpose	When created
<server-name>-PublicClients	Indeholder OAuth-tilladelserne, som klienthoster (såsom Visual Studio Code og Microsoft Copilot CLI) bruger til at kalde den publicerede MCP-server.	CLI'en opretter denne app for hver server.
<server-name>-A365Proxy	Fungerer som en fortrolig klientapp med en klienthemmelighed. CLI'en videresender appens legitimationsoplysninger til platformen, som bruger dem til at skabe Power Platform-connectoren til serveren.	CLI opretter denne app kun til brugerdefinerede (ikke-Dataverse) MCP-servere. Førsteparts Dataverse-servere, såsom msdyn_DataverseMCPServer, springer denne app over, fordi platformen foranlægger dem med sin egen app.

Fordi kommandoen opretter app-registreringer, skal kontoen, der kører CLI, have Microsoft Graph-tilladelsen Application.ReadWrite.All . Uden denne tilladelse publish fejler det. Hvis publicering fejler, sletter CLI'en de app-registreringer, den har oprettet. Hvis du fjerner serveren, så slet disse app-registreringer manuelt.

I lejere, der begrænser klienthemmelighedernes levetid med en appManagementPolicies police, bruges --secret-lifetime-months til at sætte en levetid inden for grænsen for <server-name>-A365Proxy klienthemmeligheden.

Note

Tilbyd --publisher-name brugeroprettede MCP-servere. Værdien skrives til den publicerede pakkes udviklermetadata og kræves for disse servere. Det ignoreres for førsteparts Microsoft-ejede servere (for eksempel msdyn_DataverseMCPServer), som altid udgiver som "Microsoft". Når du udelader det, beder CLI'en interaktivt om det; pass --yes for at publicere uden prompts i CI eller scriptede kontekster.

publish indstillinger

Option	Description
-e, --environment-id <environment-id>	Dataverse-miljø-id
-s, --server-name <server-name>	MCP-servernavn, der skal publiceres
-a, --alias <alias>	Alias for MCP-serveren
-d, --display-name <display-name>	Vist navn på MCP-serveren
-p, --publisher-name <publisher-name>	Publisher-navnet er skrevet til den publicerede pakkemetadata. Påkrævet for brugeroprettede MCP-servere; ignoreret til fordel for førstepartsservere ejede af Microsoft. Promptet interaktivt, når det udelades.
--service-tree-id <service-tree-id>	ServiceTree ID for Microsoft Entra-appregistreringerne, der publish oprettes. Påkrævet i Microsoft corporate-lejere.
-l, --secret-lifetime-months <months>	Levetid i måneder (1-24) for klienthemmeligheden i <server-name>-A365Proxy Microsoft Entra-appen. Når den udelades, anvender Microsoft Entra ID sin standardlevetid på cirka 2 år. Hvis din lejers appManagementPolicies police håndhæver en kortere maksimum, så sæt en værdi inden for denne grænse.
-y, --yes	Spring det interaktive "Fortsæt med publiceren? (y/N)" confirmation. Brug i CI eller scriptede sammenhænge.
--dry-run	Vis, hvad der skal gøres uden at udføre
-v, --verbose	Aktivér detaljeret logføring
-?, -h, --help	Vis hjælp og brugsvejledning

Gennemgå og godkend MCP-anmodninger

develop-mcp unpublish

Annuller publiceringen af en MCP-server fra et Dataverse-miljø.

a365 develop-mcp unpublish [options]

Brug denne kommando til at fjerne en MCP-server fra det angivne Dataverse-miljø.

unpublish indstillinger

Option	Description
-e, --environment-id <environment-id>	Dataverse-miljø-id
-s, --server-name <server-name>	MCP-servernavn, der skal annulleres
--dry-run	Vis, hvad der skal gøres uden at udføre
-?, -h, --help	Vis hjælp og brugsvejledning

develop-mcp register-external-mcp-server

Registrer en ekstern MCP-server med Entra, ekstern OAuth, API-nøgle eller ingen autentificering.

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

Brug denne kommando til at registrere en eksternt hostet (tredjeparts) MCP-server hos din lejer. Kommandoen opretter de Microsoft Entra-appregistreringer, som platformen har brug for, kalder Agent 365-platformen for at tilføje MCP-serveren og konfigurerer omdirigerings-URI'er og API-tilladelser på de nye app-registreringer.

Servernavnet skal starte med præfikset ext_ og være højst 20 tegn langt, for eksempel ext_MyServer. Værktøjsnavne skal nøjagtigt matche de navne, der er afsløret af den eksterne MCP-server. Forkerte navne får værktøjskald til at fejle under kørsel.

Du kan levere parametre på tre måder:

• Send dem som kommandolinje-muligheder.
• Giv en JSON-fil med --input-file. Kommandolinjeindstillinger overskriver værdier fra filen. Se register-external-mcp-server-sample.json i CLI-skabelonerne for filstrukturen.
• Udelad enhver nødvendig værdi, der skal promptes interaktivt.

Når registreringen er lykkedes, skal du bede din lejeradministrator om at godkende den nye MCP-server, før agenterne kan bruge den. Hvis du har registreret dig med ExternalOAuth, tilføj også den viste omdirigerings-URI til din eksterne IDP-applikation.

Important

Hvis registreringen fejler efter at Microsoft Entra-appregistreringerne er oprettet, rulles appsene ikke automatisk tilbage. Slet dem manuelt i Azure-portalen, før du prøver igen.

register-external-mcp-server indstillinger

Nogle muligheder er kun nødvendige for specifikke autentificeringstyper, som beskrevet i kolonnen beskrivelse.

Option	Description
-s, --server-name <server-name>	MCP-servernavn. Skal starte med ext_ og være højst 20 tegn, for eksempel ext_MyServer
-u, --server-url <server-url>	Fjern MCP-server-URL. Skal være en gyldig HTTP- eller HTTPS-URL
-a, --auth-type <auth-type>	Autentificeringstype: EntraOAuth, ExternalOAuth, , APIKeyeller NoAuth
--publisher <publisher>	Publisher-navn (brugt i pakkemetadata)
--description <description>	Serverbeskrivelse (brugt i pakkemetadata)
--tools <tools>	For eksempel en komma-separeret liste over værktøjsnavne, der er eksponeret af denne server, tool1,tool2,tool3
-f, --input-file <input-file>	Sti til en JSON-fil med registreringsparametrene
--remote-scopes <remote-scopes>	Scopes for den fjern-MCP-server, for eksempel api://{appId-guid}/{scopeName}. Brugt med EntraOAuth
-t, --tenant-id <tenant-id>	Entra lejer-ID til app-registreringen. Defaults til den nuværende az login lejer
--service-tree-id <service-tree-id>	ServiceTree ID til entra-appens registrering. Påkrævet i Microsoft corporate-lejere
-l, --secret-lifetime-months <months>	Levetid i måneder (1-24) for genererede klienthemmeligheder på de oprettede Entra-apps. Som standard er det 24 måneder (2 år). Sæt en værdi, der er lavere end appManagementPolicies loftet i din lejer, hvis din lejerforsikring håndhæver et kortere maksimum
--idp-authorization-url <url>	Ekstern OAuth-autorisations-URL. Påkrævet, når --auth-type er ExternalOAuth
--idp-token-url <url>	Ekstern OAuth-token URL. Påkrævet, når --auth-type er ExternalOAuth
--idp-scopes <scopes>	Eksterne OAuth-scopes. Påkrævet, når --auth-type er ExternalOAuth
--idp-client-id <client-id>	Ekstern OAuth-klient-ID. Påkrævet, når --auth-type er ExternalOAuth
--idp-client-secret <client-secret>	Ekstern OAuth klienthemmelighed. Påkrævet, når --auth-type er ExternalOAuth
--api-key-location <location>	API-nøgleplacering: Header eller Query. Påkrævet, når --auth-type er APIKey
--api-key-name <name>	API-nøgleparameter eller headernavn, for eksempel X-API-Key eller token. Påkrævet, når --auth-type er APIKey
--dry-run	Vis, hvad der skal gøres uden at udføre
-v, --verbose	Aktivér detaljeret logføring
-?, -h, --help	Vis hjælp og brugsvejledning