Agent 365 CLI-kommandoreference develop-mcp

Administrer MCP-servere i Dataverse-miljøer. Kommandoen develop-mcp giver muligheder for at offentliggøre, afpublicere og registrere MCP-servere til brug i Dataverse-miljøer.

Note

, develop-mcp approvedevelop-mcp block, og develop-mcp package-mcp-server kommandoerne fjernes fra Agent 365 CLI. 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 oplysninger om hjælp og brug

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 motorvalg:

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

Evaluer en autentificeret server, hvor tokenet leveres gennem 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"

Lav kun tjeklisten, og giv den derefter din egen LLM:

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

Tving en specifik scoringsmotor:

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

Lær hvordan du evaluerer MCP-servere

evaluate Miljøvariable

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 for MCP-serveren, bruges når --auth-token den ikke bliver overleveret. Foretrukket frem for flaget, fordi det holder tokenet ude af proceslister og shell-historik.
A365_EVAL_COPILOT_MODEL	Overstyr GitHub Copilot-modellen. Kræver for eksempel claude-haiku-4.5en eksakt model-ID.
A365_EVAL_CLAUDE_MODEL	Overstyr Claude Code-modellen. Accepterer et modelalias (for eksempel haiku) eller et fuldt model-ID.

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 oplysninger om hjælp og brug

develop-mcp list-servers

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

a365 develop-mcp list-servers [options]

Denne kommando viser alle MCP-servere, der i øjeblikket er installeret i det angivne 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 oplysninger om hjælp og brug

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

Når du publicerer, opretter CLI'en en <server-name>-PublicClients Microsoft Entra app-registrering i din lejer. Denne app har OAuth-tilladelserne, som klienthoster (såsom Visual Studio Code og Microsoft 365 Copilot CLI) bruger til at kalde den offentliggjorte MCP-server. Fordi kommandoen opretter en app-registrering, skal kontoen, der kører CLI'en, have tilladelsen Application.ReadWrite.All Microsoft Graph. At køre publish uden den fejler.

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.
-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 oplysninger om hjælp og brug

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 oplysninger om hjælp og brug

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 oplysninger om hjælp og brug