Kommandoreferens för Agent 365 CLI develop-mcp

Hantera MCP-servrar i Dataverse-miljöer. Kommandot develop-mcp ger alternativ för att publicera, avpublicera, registrera och ge agentbehörigheter för MCP-servrar för användning i Dataverse-miljöer.

Note

, develop-mcp approvedevelop-mcp block, och develop-mcp package-mcp-server kommandona tas bort från Agent 365:s CLI. Hyresgästadministratörer utför nu servergodkännande och blockering i Microsoft admincenter — väntande förfrågningar granskas på sidan Requested Agents. CLI:n producerar inte längre MCP-serverpaket för inlämning till Admin Center; Administratörer ombord och hanterar servrar direkt i administrationscentret.

Minsta roll som krävs: Varierar beroende på underkommando

Syntax

a365 develop-mcp [command] [options]

Options

Option Description
-v, --verbose Aktivera utförlig loggning
-?, -h, --help Visa hjälp- och användningsinformation

develop-mcp evaluate

Utvärdera din MCP-server mot vetenskapliga bästa praxis för att bedöma produktionsberedskap. Detta verktyg ger en omfattande utvärderingsrapport med poäng, förklaringar och åtgärdspunkter. Kommandot upptäcker vilka verktyg en MCP-server exponerar, kör en uppsättning deterministiska och AI-poängsatta semantiska kontroller mot deras scheman, och producerar en HTML-rapport som bedömer schemats kvalitet och listar prioriterade åtgärdspunkter för förbättring.

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

evaluate Alternativ

Option Description
-u, --server-url <server-url> Required. MCP-serverns strömningsbara HTTP-endpoint-URL (slutar vanligtvis på /mcp).
--auth-token <auth-token> Optional. Behövs bara när MCP-servern kräver autentisering. Bärartoken för servern. Föredra miljövariabeln A365_MCP_AUTH_TOKEN ; en token som skickas via kommandoraden är synlig för processlistor och shellhistorik.
-o, --output-dir <output-dir> Katalog för checklistor och rapportfiler. Går som standard till den aktuella katalogen (.).
--eval-engine <eval-engine> Vilken lokal kodningsagent ger poäng för de semantiska kontrollerna: auto (standard; försök GitHub Copilot, sedan Claude Code), github-copilot, claude-code eller none (hoppa över AI-poängsättning och förvänta dig en förpoängad checklista).
-v, --verbose Aktivera utförlig loggning.
-?, -h, --help Visa hjälp- och användningsinformation.

evaluate exempel

Utvärdera en lokal server med automatiskt motorval:

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

Utvärdera en autentiserad server med token som tillhandahålls via en miljövariabel och artefakter som skrivits till en undermapp:

$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"

Generera endast checklistan och poängsätt den sedan med din egen LLM:

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

Framtvinga en specifik bedömningsmotor:

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

Lär dig hur du utvärderar MCP-servrar

evaluate miljövariabler

Använd följande miljövariabler för autentisering och eventuellt kontrollera vilken modell varje lokal poängmotor använder.

Environment variable Purpose
A365_MCP_AUTH_TOKEN Bärartoken för MCP-servern, används när --auth-token den inte passeras. Föredras framför flaggan eftersom den håller token borta från processlistor och shellhistorik.
A365_EVAL_COPILOT_MODEL Åsidosätt GitHub Copilot-modellen. Kräver till exempel claude-haiku-4.5ett exakt modell-ID.
A365_EVAL_CLAUDE_MODEL Åsidosätt Claude Code-modellen. Accepterar ett modellalias (till exempel haiku) eller ett fullständigt modell-ID.

develop-mcp grant-agents-access

Ge en bring-your-own (BYO) MCP-servers tillstånd till agentidentiteter som saknar det.

a365 develop-mcp grant-agents-access --mcp-server-name <NAME> --agent-blueprint-id <GUID> [options]

Minimikrav på behörigheter: Global administratör (eller en annan roll med rätt att skapa tenant-wide OAuth2-behörighetsgivanden)

Använd detta kommando för att hitta och fixa agentidentiteter som inte kan anropa en bring-your-own (BYO) MCP-server eftersom de saknar Tools.ListInvoke.All behörighet för det. Kommandot listar agentinstanserna av den angivna blueprinten som saknar behörigheten, och låter dig sedan välja vilka du vill ge den till.

MCP-servernamnet löses till en Microsoft Entra-applikation där - BYO det läggs till namnet. Exempelvis löses ext_Learn1 till ext_Learn1 - BYO. Själva bidraget är en tenant-wide (AllPrincipals) delegerad OAuth2-behörighetsgivande på applikationens tjänstehuvud, så det gäller för varje nuvarande och framtida agentinstans av blueprinten, inte bara de som listas vid körning.

Du känner vanligtvis inte till blueprint-GUID:n i förväg. Att passera --agent-blueprint-id utan ett värde, eller ett ogiltigt, skriver ut Microsoft förstapartsritningar och ID:n så att du kan hitta det. Att passera --help ger samma lista.

Efter att kommandot rapporterat att agentinstanserna saknar behörigheten, enter all för att bevilja den till varje visad instans, en komma-separerad lista med de visade siffrorna (till exempel 1,3) för att ge den till specifika instanser, eller tryck Enter för att hoppa över beviljandet. Pass --yes för att bevilja till varje listad instans utan uppmaning, till exempel i ett skript.

Om mer än en Entra-applikation delar samma <name> - BYO visningsnamn listar kommandot alla träffar och frågar vilken som ska användas istället för att gissa.

grant-agents-access Alternativ

Option Description
--agent-blueprint-id <agent-blueprint-id> Agent blueprint ID (GUID) för agentinstanserna att kontrollera. Om du utelämnar detta alternativ eller anger ett ogiltigt värde, skriver kommandot ut förstaparts blueprint-namn och ID:n.
-s, --mcp-server-name <mcp-server-name> Required. MCP-servernamn. Entra-applikationen löses som <name> - BYO.
--tenant-id <tenant-id> Azure AD-klient-ID. Standardinställningen är den aktuella Azure CLI-kontexten.
-y, --yes Ge den saknade behörigheten till varje listad agentinstans utan att bli tillfrågad.
--device-code Använd enhetskodsautentisering istället för det interaktiva webbläsarflödet (WAM-mäklaren på Windows). Använd när WAM inte kan visa en inloggningsdialog, såsom en inbäddad eller fjärrterminal. Öppnas https://microsoft.com/devicelogin i din webbläsare.
--dry-run Rapportera vilka agentinstanser som saknar behörighet utan att bevilja den.
-v, --verbose Aktivera utförlig loggning
-?, -h, --help Visa hjälp- och användningsinformation

develop-mcp list-environments

Visa en lista över alla Dataverse-miljöer som är tillgängliga för MCP-serverhantering.

a365 develop-mcp list-environments [options]

Det här kommandot visar alla Dataverse-miljöer där du kan hantera MCP-servrar.

list-environments Alternativ

Option Description
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, -h, --help Visa hjälp- och användningsinformation

develop-mcp list-servers

Lista MCP-servrar i en specifik Dataverse-miljö.

a365 develop-mcp list-servers [options]

Detta kommando listar alla MCP-servrar som för närvarande är distribuerade i den angivna Dataverse-miljön.

list-servers Alternativ

Option Description
-e, --environment-id <environment-id> ID för Dataverse-miljö
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, -h, --help Visa hjälp- och användningsinformation

develop-mcp publish

Publicera en MCP-server till en Dataverse-miljö.

a365 develop-mcp publish [options]

Använd det här kommandot för att publicera en MCP-server till den angivna Dataverse-miljön.

Important

Att publicera en MCP-server godkänner det inte. Publicering skickar bara servern till din hyresgäst och skapar en väntande godkännandeförfrågan. Innan någon agent kan använda servern måste en hyresgästadministratör godkänna den på sidan Efterfrågade verktyg i Administrationscenter för Microsoft 365. Tills administratören godkänner förfrågan förblir servern otillgänglig för agenter. När kommandot lyckas skriver CLI ut en påminnelse om att be din tenant-administratör godkänna servern.

När du publicerar skapar CLI:n en <server-name>-PublicClients Microsoft Entra appregistrering i din tenant. Denna app har OAuth-behörigheter som klientvärdar (såsom Visual Studio Code och Microsoft Copilot CLI) använder för att anropa den publicerade MCP-servern. Eftersom kommandot skapar en appregistrering måste kontot som kör CLI:n ha behörigheten Application.ReadWrite.All Microsoft Graph. Att köra publish utan den misslyckas.

Note

Tillhandahåll --publisher-name anpassade (användarskapade) MCP-servrar. Värdet skrivs till det publicerade paketets utvecklarmetadata och krävs för dessa servrar. Det ignoreras för förstapartsservrar som ägs av Microsoft (till exempel msdyn_DataverseMCPServer), som alltid publicerar som "Microsoft". När du utelämnar det uppmanar CLI interaktivt om det; pass --yes för att publicera utan prompts i CI eller skriptade sammanhang.

publish Alternativ

Option Description
-e, --environment-id <environment-id> ID för Dataverse-miljö
-s, --server-name <server-name> MCP-servernamn som ska publiceras
-a, --alias <alias> Alias för MCP-servern
-d, --display-name <display-name> Visningsnamn för MCP-servern
-p, --publisher-name <publisher-name> Publisher-namnet skrivet till det publicerade paketets metadata. Krävs för anpassade (användarskapade) MCP-servrar; ignorerades till förmån för förstapartsservrar ägda av Microsoft. Prompt interaktivt när den utelämnades.
-y, --yes Hoppa över det interaktiva "Fortsätt med publicering? (y/N)" confirmation. Använd i CI eller skriptade sammanhang.
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, -h, --help Visa hjälp- och användningsinformation

Lär dig hur hyresgästadministratörer godkänner MCP-servrar

develop-mcp unpublish

Avpublicera en MCP-server från en Dataverse-miljö.

a365 develop-mcp unpublish [options]

Använd det här kommandot för att ta bort en MCP-server från den angivna Dataverse-miljön.

unpublish Alternativ

Option Description
-e, --environment-id <environment-id> ID för Dataverse-miljö
-s, --server-name <server-name> MCP-servernamn för avpublicera
--dry-run Visa vad som skulle göras utan att köra
-?, -h, --help Visa hjälp- och användningsinformation

develop-mcp register-external-mcp-server

Registrera en extern MCP-server med Entra, extern OAuth, API-nyckel eller ingen autentisering.

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

Använd detta kommando för att registrera en externt hostad (tredjeparts) MCP-server hos din tenant. Kommandot skapar de Microsoft Entra-appregistreringar som plattformen behöver, anropar Agent 365-plattformen för att lägga till MCP-servern och konfigurerar omdirigerings-URI:er och API-behörigheter på de nya appregistreringarna.

Servernamnet måste börja med prefixet ext_ och vara högst 20 tecken långt, till exempel ext_MyServer. Verktygsnamn måste exakt matcha de namn som exponeras av den fjärrstyrda MCP-servern. Ommatchade namn gör att verktygsinkallelser misslyckas vid körning.

Du kan ange parametrar på tre sätt:

  • Skicka dem som kommandoradsalternativ.
  • Tillhandahåll en JSON-fil med --input-file. Kommandoradsalternativ åsidosätter värden från filen. Se register-external-mcp-server-sample.json i CLI-mallarna för filstrukturen.
  • Utelämna alla nödvändiga värden som ska promptas interaktivt.

När registreringen lyckas, be din tenant-administratör att godkänna den nya MCP-servern innan agenterna kan använda den. Om du registrerade dig med ExternalOAuth, lägg också till den visade omdirigerings-URI:n i din externa IDP-applikation.

Important

Om registreringen misslyckas efter att Microsoft Entra-appregistreringarna har skapats, rullas inte apparna automatiskt tillbaka. Ta bort dem manuellt i Azure-portalen innan du försöker igen.

register-external-mcp-server Alternativ

Vissa alternativ krävs endast för specifika autentiseringstyper, som beskrivs i beskrivningskolumnen.

Option Description
-s, --server-name <server-name> MCP-servernamn. Måste börja med ext_ och vara högst 20 tecken, till exempel ext_MyServer
-u, --server-url <server-url> Fjärr-MCP-server-URL. Måste vara en giltig HTTP- eller HTTPS-URL
-a, --auth-type <auth-type> Autentiseringstyp: EntraOAuth, ExternalOAuth, , APIKey, eller NoAuth
--publisher <publisher> Publisher-namn (används i paketmetadata)
--description <description> Serverbeskrivning (används i paketmetadata)
--tools <tools> Till exempel en komma-separerad lista över verktygsnamn som exponeras av denna server. tool1,tool2,tool3
-f, --input-file <input-file> Väg till en JSON-fil med registreringsparametrarna
--remote-scopes <remote-scopes> Scopes för den fjärrstyrda MCP-servern, till exempel api://{appId-guid}/{scopeName}. Används med EntraOAuth
-t, --tenant-id <tenant-id> Entra tenant ID för appregistreringen. Defaults till den nuvarande az login hyresgästen
--service-tree-id <service-tree-id> ServiceTree-ID för entra-appens registrering. Obligatoriskt i Microsoft företagshyresgäster
-l, --secret-lifetime-months <months> Livstid i månader (1-24) för genererade klienthemligheter i de skapade entra-apparna. Som standard är det 24 månader (2 år). Sätt ett värde som är lägre än appManagementPolicies taket i din hyresgäst om din hyresgästförsäkring kräver en kortare maxgräns
--idp-authorization-url <url> Extern OAuth-auktoriserings-URL. Krävs när --auth-type är ExternalOAuth
--idp-token-url <url> Extern OAuth-token-URL. Krävs när --auth-type är ExternalOAuth
--idp-scopes <scopes> Externa OAuth-scopes. Krävs när --auth-type är ExternalOAuth
--idp-client-id <client-id> Extern OAuth-klient-ID. Krävs när --auth-type är ExternalOAuth
--idp-client-secret <client-secret> Extern OAuth-klienthemlighet. Krävs när --auth-type är ExternalOAuth
--api-key-location <location> API-nyckelplats: Header eller Query. Krävs när --auth-type är APIKey
--api-key-name <name> API-nyckelparameter eller headernamn, till exempel X-API-Key eller token. Krävs när --auth-type är APIKey
--dry-run Visa vad som skulle göras utan att köra
-v, --verbose Aktivera utförlig loggning
-?, -h, --help Visa hjälp- och användningsinformation
  • Uppdaterades senast