Kommandoreferanse for Agent 365 CLI develop-mcp

Administrer MCP-servere i dataverse miljøer. Kommandoen develop-mcp gir muligheter for å publisere, avpublisere og registrere MCP-servere for bruk i Dataverse-miljøer.

Note

, develop-mcp approve, og develop-mcp block kommandoene develop-mcp package-mcp-serverfjernes fra Agent 365 CLI. Leietakeradministratorer utfører nå servergodkjenning og blokkering i Microsoft administrasjonssenter — ventende forespørsler vurderes på siden Requested Agents. CLI-en produserer ikke lenger MCP-serverpakker for innsending til administrasjonssenteret; Administratorer ombord og administrerer servere direkte i administrasjonssenteret.

Minimumsrolle kreves: Varierer etter underkommando

Syntax

a365 develop-mcp [command] [options]

Alternativer

Option	Description
-v, --verbose	Aktiver detaljert logging
-?, -h, --help	Vis hjelp og bruksinformasjon

develop-mcp evaluate

Vurder MCP-serveren din mot vitenskapelige beste praksiser for å vurdere produksjonsberedskap. Dette verktøyet gir en omfattende evalueringsrapport med poeng, forklaringer og handlingspunkter. Kommandoen oppdager verktøyene en MCP-server eksponerer, kjører et sett med deterministiske og AI-vurderte semantiske kontroller mot skjemaene deres, og produserer en HTML-rapport som vurderer skjemaets kvalitet og lister opp prioriterte handlingspunkter for forbedring.

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

evaluate Alternativer

Option	Description
-u, --server-url <server-url>	Required. MCP-serverens strømlinjebare HTTP-endepunkts-URL (ender vanligvis på /mcp).
--auth-token <auth-token>	Optional. Bare nødvendig når MCP-serveren krever autentisering. Bærertoken for serveren. Foretrekk miljøvariabelen A365_MCP_AUTH_TOKEN ; et token som sendes på kommandolinjen er synlig for prosesslister og skallhistorikk.
-o, --output-dir <output-dir>	Mappe for sjekkliste- og rapportfiler. Som standard er den nåværende katalogen (.).
--eval-engine <eval-engine>	Hvilken lokal kodingsagent vurderer de semantiske sjekkene: auto (standard; prøv GitHub Copilot, deretter Claude Code), github-copilot, claude-code, eller none (hopp over AI-poeng og forvent en forhåndsscoret sjekkliste).
-v, --verbose	Aktiver detaljert logging.
-?, -h, --help	Vis informasjon om hjelp og bruk.

evaluate Eksempler

Evaluer en lokal server med automatisk motorvalg:

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

Evaluer en godkjent server, med tokenet levert gjennom 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"

Generer sjekklisten, og score den deretter med din egen LLM:

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

Fremtving en bestemt poengmotor:

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

Lær hvordan du evaluerer MCP-servere

evaluate-miljøvariabler

Bruk følgende miljøvariabler for å gi autentisering og eventuelt kontrollere hvilken modell hver lokal scoremotor bruker.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Bærertoken for MCP-serveren, brukes når --auth-token den ikke blir sendt. Foretrukket fremfor flagget fordi det holder tokenet ute av prosesslister og shell-historikk.
A365_EVAL_COPILOT_MODEL	Overstyr GitHub Copilot-modellen. Krever for eksempel claude-haiku-4.5en eksakt modell-ID.
A365_EVAL_CLAUDE_MODEL	Overstyr Claude Code-modellen. Godtar et modellalias (for eksempel haiku) eller en full modell-ID.

develop-mcp list-environments

Vis alle dataverse miljøer som er tilgjengelige for ADMINISTRASJON av MCP-servere.

a365 develop-mcp list-environments [options]

Denne kommandoen viser alle dataverse miljøer der du kan administrere MCP-servere.

list-environments Alternativer

Option	Description
--dry-run	Vis hva som ville blitt gjort uten å kjøre
-v, --verbose	Aktiver detaljert logging
-?, -h, --help	Vis hjelp og bruksinformasjon

develop-mcp list-servers

Vis MCP-servere i et bestemt dataversmiljø.

a365 develop-mcp list-servers [options]

Denne kommandoen lister alle MCP-servere som for øyeblikket er distribuert i det spesifiserte Dataverse-miljøet.

list-servers Alternativer

Option	Description
-e, --environment-id <environment-id>	ID for Dataverse-miljø
--dry-run	Vis hva som ville blitt gjort uten å kjøre
-v, --verbose	Aktiver detaljert logging
-?, -h, --help	Vis hjelp og bruksinformasjon

develop-mcp publish

Publiser en MCP-server til et dataverst miljø.

a365 develop-mcp publish [options]

Bruk denne kommandoen til å publisere en MCP-server til det angitte dataversmiljøet.

Important

Publisering av en MCP-server godkjenner det ikke. Publisering sender bare serveren til leietakeren din og oppretter en ventende godkjenningsforespørsel. Før noen agent kan bruke serveren, må en leietakeradministrator godkjenne den på siden Requested Tools i Administrasjonssenter for Microsoft 365. Inntil administratoren godkjenner forespørselen, forblir serveren utilgjengelig for agenter. Når kommandoen lykkes, skriver CLI-en ut en påminnelse om å be tenant-administratoren godkjenne serveren.

Når du publiserer, oppretter CLI en <server-name>-PublicClients Microsoft Entra appregistrering i leietakeren din. Denne appen har OAuth-tillatelsene som klienthoster (som Visual Studio Code og Microsoft 365 Copilot CLI) bruker for å kalle den publiserte MCP-serveren. Fordi kommandoen oppretter en appregistrering, må kontoen som kjører CLI-en ha tillatelsen Application.ReadWrite.All Microsoft Graph. Å kjøre publish uten den feiler.

Note

Tilby --publisher-name tilpassede (brukeropprettede) MCP-servere. Verdien skrives til den publiserte pakkens utviklermetadata og kreves for disse serverne. Det ignoreres for førsteparts Microsoft-eide servere (for eksempel msdyn_DataverseMCPServer), som alltid publiserer som "Microsoft". Når du utelater det, ber CLI-en om det interaktivt; pass --yes for å publisere uten prompts i CI eller skriptede kontekster.

publish Alternativer

Option	Description
-e, --environment-id <environment-id>	ID for Dataverse-miljø
-s, --server-name <server-name>	MCP-servernavn som skal publiseres
-a, --alias <alias>	Alias for MCP-serveren
-d, --display-name <display-name>	Visningsnavn for MCP-serveren
-p, --publisher-name <publisher-name>	Publisher-navnet skrevet i den publiserte pakkens metadata. Påkrevd for egendefinerte (brukeropprettede) MCP-servere; ignorert til fordel for førsteparts Microsoft-eide servere. Oppfordret interaktivt når det utelates.
-y, --yes	Hopp over den interaktive «Fortsett med publisering?» (y/N)" confirmation. Bruk i CI eller skriptede sammenhenger.
--dry-run	Vis hva som ville blitt gjort uten å kjøre
-v, --verbose	Aktiver detaljert logging
-?, -h, --help	Vis hjelp og bruksinformasjon

Lær hvordan leietakeradministratorer godkjenner MCP-servere

develop-mcp unpublish

Opphev publisering av en MCP-server fra et dataverst miljø.

a365 develop-mcp unpublish [options]

Bruk denne kommandoen til å fjerne en MCP-server fra det angitte dataversmiljøet.

unpublish Alternativer

Option	Description
-e, --environment-id <environment-id>	ID for Dataverse-miljø
-s, --server-name <server-name>	MCP-servernavn for å oppheve publisering
--dry-run	Vis hva som ville blitt gjort uten å kjøre
-?, -h, --help	Vis hjelp og bruksinformasjon

develop-mcp register-external-mcp-server

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

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

Bruk denne kommandoen for å registrere en eksternt hostet (tredjeparts) MCP-server hos din leietaker. Kommandoen oppretter Microsoft Entra-appregistreringene plattformen trenger, kaller Agent 365-plattformen for å legge til MCP-serveren, og konfigurerer omdirigerte URI-er og API-tillatelser på de nye appregistreringene.

Servernavnet må starte med prefikset ext_ og være maksimalt 20 tegn langt, for eksempel ext_MyServer. Verktøynavn må nøyaktig samsvare med navnene som eksponeres av den eksterne MCP-serveren. Mismatchede navn gjør at verktøykall feiler under kjøring.

Du kan oppgi parametere på tre måter:

• Send dem som kommandolinjevalg.
• Legg ved en JSON-fil med --input-file. Kommandolinjevalg overstyrer verdier fra filen. Se register-external-mcp-server-sample.json i CLI-malene for filstrukturen.
• Utelat enhver nødvendig verdi som skal oppfordres interaktivt.

Etter at registreringen er gjennomført, be leietakeradministratoren din godkjenne den nye MCP-serveren før agentene kan bruke den. Hvis du registrerte deg hos ExternalOAuth, legg også til den viste omdirigerings-URI-en i din eksterne IDP-applikasjon.

Important

Hvis registreringen feiler etter at Microsoft Entra-appregistreringene er opprettet, rulles ikke appene automatisk tilbake. Slett dem manuelt i Azure-portalen før du prøver på nytt.

register-external-mcp-server Alternativer

Noen alternativer kreves kun for spesifikke autentiseringstyper, som beskrevet i kolonnen beskrivelse.

Option	Description
-s, --server-name <server-name>	MCP-servernavn. Må starte med ext_ og være maksimalt 20 tegn, for eksempel ext_MyServer
-u, --server-url <server-url>	Fjern MCP-server-URL. Må være en gyldig HTTP- eller HTTPS-URL
-a, --auth-type <auth-type>	Autentiseringstype: EntraOAuth, ExternalOAuth, , APIKey, eller NoAuth
--publisher <publisher>	Publisher-navn (brukt i pakkemetadata)
--description <description>	Serverbeskrivelse (brukt i pakkemetadata)
--tools <tools>	For eksempel en komma-separert liste over verktøynavn eksponert av denne serveren, for eksempel tool1,tool2,tool3
-f, --input-file <input-file>	Vei til en JSON-fil med registreringsparametrene
--remote-scopes <remote-scopes>	Scopes for den eksterne MCP-serveren, for eksempel api://{appId-guid}/{scopeName}. Brukt med EntraOAuth
-t, --tenant-id <tenant-id>	Entra leietaker-ID for app-registreringen. Går til gjeldende az login leietaker som standard
--service-tree-id <service-tree-id>	ServiceTree-ID for registrering av entra-appen. Påkrevd i Microsoft-bedriftsleietakere
-l, --secret-lifetime-months <months>	Levetid i måneder (1-24) for genererte klienthemmeligheter på de opprettede entra-appene. Som standard er det 24 måneder (2 år). Sett en verdi lavere enn appManagementPolicies taket i leietakeren hvis leietakerforsikringen krever en kortere maksgrense
--idp-authorization-url <url>	Ekstern OAuth-autorisasjons-URL. Påkrevd når --auth-type er ExternalOAuth
--idp-token-url <url>	Ekstern OAuth-token-URL. Påkrevd når --auth-type er ExternalOAuth
--idp-scopes <scopes>	Eksterne OAuth-teleskoper. Påkrevd når --auth-type er ExternalOAuth
--idp-client-id <client-id>	Ekstern OAuth klient-ID. Påkrevd når --auth-type er ExternalOAuth
--idp-client-secret <client-secret>	Ekstern OAuth-klienthemmelighet. Påkrevd når --auth-type er ExternalOAuth
--api-key-location <location>	API-nøkkelplassering: Header eller Query. Påkrevd når --auth-type er APIKey
--api-key-name <name>	API-nøkkelparameter eller headernavn, for eksempel X-API-Key eller token. Påkrevd når --auth-type er APIKey
--dry-run	Vis hva som ville blitt gjort uten å kjøre
-v, --verbose	Aktiver detaljert logging
-?, -h, --help	Vis hjelp og bruksinformasjon