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 informasjon om hjelp og bruk

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 informasjon om hjelp og bruk

develop-mcp list-servers

Vis MCP-servere i et bestemt dataversmiljø.

a365 develop-mcp list-servers [options]

Denne kommandoen viser alle MCP-servere som for øyeblikket er distribuert i det angitte 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 informasjon om hjelp og bruk

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.

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 informasjon om hjelp og bruk

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 informasjon om hjelp og bruk

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 informasjon om hjelp og bruk
  • Last updated on