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 package-mcp-server kommandoene develop-mcp blockfjernes 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 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