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 hjælp og brugsvejledning

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 valg af program:

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

Evaluer en godkendt server med det token, der leveres via en miljøvariabel, og artefakter, der er 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"

Generér kun tjeklisten, og scor den derefter med din egen LLM:

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

Gennemtving et bestemt pointprogram:

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

Lær hvordan du evaluerer MCP-servere

evaluate miljøvariabler

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 hjælp og brugsvejledning

develop-mcp list-servers

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

a365 develop-mcp list-servers [options]

Denne kommando lister alle MCP-servere, der aktuelt er deployeret i det specificerede 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 hjælp og brugsvejledning

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

Important

At udgive en MCP-server godkender det ikke. Publicering indsender kun serveren til din lejer og opretter en ventende godkendelsesanmodning. Før nogen agent kan bruge serveren, skal en lejeradministrator godkende den på siden Requested Tools i Microsoft 365 Administration. Indtil administratoren godkender anmodningen, forbliver serveren utilgængelig for agenter. Når kommandoen lykkes, udskriver CLI en påmindelse om at bede din lejeradministrator om at godkende serveren.

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 hjælp og brugsvejledning

Lær, hvordan lejeradministratorer godkender MCP-servere

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 hjælp og brugsvejledning

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 hjælp og brugsvejledning
  • Last updated on