Kommandoreferanse for Agent 365 CLI develop-mcp

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

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.

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
--dry-run Vis hva som ville blitt gjort uten å kjøre
-?, -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 approve

Godkjenn en MCP-server.

a365 develop-mcp approve [options]

Denne kommandoen godkjenner en MCP-server for bruk i miljøet.

approve Alternativer

Option Description
-s, --server-name <server-name> MCP-servernavn som skal godkjennes
--dry-run Vis hva som ville blitt gjort uten å kjøre
-?, -h, --help Vis informasjon om hjelp og bruk

develop-mcp block

Blokker en MCP-server.

a365 develop-mcp block [options]

Bruk denne kommandoen til å blokkere en MCP-server fra å bli brukt i miljøet.

block Alternativer

Option Description
-s, --server-name <server-name> MCP-servernavn som skal blokkeres
--dry-run Vis hva som ville blitt gjort uten å kjøre
-?, -h, --help Vis informasjon om hjelp og bruk

develop-mcp package-mcp-server

Generer MCP-serverpakke for innsending på administrasjonssenteret for Microsoft.

a365 develop-mcp package-mcp-server [options]

Bruk denne kommandoen til å opprette en distribusjonspakke for en MCP-server som du kan sende til administrasjonssenteret for Microsoft.

package-mcp-server Alternativer

Option Description
--server-name <server-name> MCP-servernavn (OBLIGATORISK)
--developer-name <developer-name> Visningsnavn for Publisher eller utviklere (OBLIGATORISK)
--icon-url <icon-url> Offentlig URL-adresse til et PNG-ikon for MCP-serveren (OBLIGATORISK)
--output-path <output-path> Målkatalog for den genererte ZIP-pakken (OBLIGATORISK)
--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
--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