Referenční informace k příkazům rozhraní příkazového řádku develop-mcp agenta 365

Správa serverů MCP v prostředích Dataverse Příkaz develop-mcp poskytuje možnosti publikovat, odpublikovat, registrovat a udělovat agentům MCP serverům pro použití v prostředí Dataverse.

Note

CLI Agenta 365 již neobsahuje příkazy develop-mcp approve, develop-mcp block, a develop-mcp package-mcp-server . Administrátoři tenantů nyní provádějí schvalování a blokování serveru v Microsoft admin center — čekající požadavky jsou přezkoumávány na stránce Requested Agents. CLI již nevytváří MCP serverové balíčky pro odesílání do Admin Center; Administrátoři přímo připojují a spravují servery v administrátorském centru.

Minimální požadovaná role: Liší se podle podpříkazu

Syntax

a365 develop-mcp [command] [options]

Možnosti

Option	Description
-v, --verbose	Povolte podrobné protokolování
-?, -h, --help	Zobrazení informací o nápovědě a využití

develop-mcp evaluate

Zhodnoťte svůj MCP server podle vědeckých osvědčených postupů pro posouzení připravenosti na produkci. Tento nástroj generuje komplexní hodnotící zprávu se skóre, vysvětlením a akčními položkami. Příkaz objeví nástroje, které MCP server zpřístupní, spustí sadu deterministických a AI hodnotených sémantických kontrol proti jejich schématům a vytvoří HTML zprávu, která hodnotí kvalitu schématu a uvádí prioritní úkoly ke zlepšení.

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

evaluate možnosti

Option	Description
-u, --server-url <server-url>	Required. Streamovatelná HTTP endpoint URL MCP serveru (obvykle končí na /mcp).
--auth-token <auth-token>	Optional. Potřeba je to jen tehdy, když MCP server vyžaduje autentizaci. Nosicí token pro server. Preferujte A365_MCP_AUTH_TOKEN proměnnou prostředí; token předaný v příkazovém řádku je viditelný pro záznamy procesů a historii shellu.
-o, --output-dir <output-dir>	Adresář pro kontrolní seznam a soubory zpráv. Výchozí je aktuální adresář (.).
--eval-engine <eval-engine>	Který místní programátor hodnotí sémantické kontroly: auto (výchozí; zkuste GitHub Copilot, pak Claude kód), github-copilot, claude-code nebo none (přeskočte AI hodnocení a očekávejte předem ohodnotený kontrolní seznam).
-v, --verbose	Povolte podrobné protokolování.
-?, -h, --help	Zobrazení informací o nápovědě a využití

příklady evaluate

Vyhodnocení místního serveru s automatickým výběrem modulu:

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

Vyhodnoťte ověřený server s tokenem dodaným prostřednictvím proměnné prostředí a artefakty zapsanými do podsložky:

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

Vygenerujte pouze kontrolní seznam a poté jej ohodnoťte vlastním LLM:

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

Vynutit konkrétní bodovací modul:

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

Naučte se, jak hodnotit MCP servery

evaluate proměnné prostředí

Použijte následující proměnné prostředí pro autentizaci a volitelně kontrolujte, který model každý lokální bodovací engine používá.

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Nositelný token pro MCP server, který se používá, když neprojdete --auth-token. Použijte tuto proměnnou místo příznaku, protože tím token nevstupuje do záznamů procesů a historie shellu.
A365_EVAL_COPILOT_MODEL	Přepisujte model GitHub Copilot. Vyžaduje přesné ID modelu, například claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL	Přepisujte model Claudeova kódu. Přijímá alias modelu (například haiku) nebo plné ID modelu.

develop-mcp grant-agents-access

Udělte oprávnění MCP serveru s možností přinést vlastní (BYO) identitám agentů, kterým chybí.

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

Minimální požadovaná oprávnění: Globální správce (nebo jiná role s právy k vytváření celonájemních OAuth2 oprávnění)

Použijte tento příkaz k nalezení a opravě identit agentů, které nemohou volat bring-your-own (BYO) MCP server, protože jim chybí Tools.ListInvoke.All oprávnění. Příkaz vyjmenuje instance agentů daného blueprintu, kterým chybí oprávnění, a pak vám umožní vybrat, kterým ho udělíte.

Název MCP serveru se vyřeší do aplikace Microsoft Entra, kde - BYO je připojen k názvu. Například ext_Learn1 se vyřeší jako ext_Learn1 - BYO. Samotné udělení je celonájemcověAllPrincipals delegované () oprávnění OAuth2 na hlavní službu dané aplikace, takže se vztahuje na každou současnou i budoucí instanci agenta blueprintu, nejen na ty, které jsou uvedeny za běhu.

Obecně neznáte GUID plánu předem. Procházení --agent-blueprint-id bez hodnoty nebo neplatné vytiskne Microsoft blueprinty a ID, abyste je mohli najít. Passing --help znamená stejný seznam.

Po nahlášení, že instance agenta chybí oprávnění, zadejte all pro udělení oprávnění všem zobrazeným instancím, zadejte seznam čísel oddělených čárkami (například ), 1,3abyste ho přidělili konkrétním instancím, nebo stiskněte Enter pro přeskočení udělení. Předejte --yes na grant do každé uvedené instance bez vyzání, například ve skriptu.

Pokud více aplikací Entra sdílí stejné <name> - BYO zobrazované jméno, příkaz vyjmenuje všechny shody a místo hádání se ptá, kterou použít.

Příkaz nepoužívá klientskou aplikaci nakonfigurovanou v a365.config.json. Místo toho se přihlásí jako aplikace Microsoft Graph Command Line Tools (14d82eec-204b-4c2f-b7e8-296a70dab67e) a požádá o následující delegované rozsahy Microsoft Graph:

• Application.Read.All
• AgentIdentity.Read.All
• DelegatedPermissionGrant.ReadWrite.All

Poprvé, když spustíte příkaz v tenantu, uvidíte administrátorskou výzvu k souhlasu pro tyto scope. Globální administrátor nebo správce privilegované role musí tyto rozsahy udělit podnikové aplikaci Microsoft Graph Command Line Tools. Po schválení je u každého běhu potřeba pouze jedno přihlášení. Pokud příkaz nemůže získat token, chybová zpráva jmenuje aplikaci a rozsahy, které příkaz požadoval.

grant-agents-access možnosti

Option	Description
--agent-blueprint-id <agent-blueprint-id>	ID plánu agenta (GUID) pro instance agentů ke kontrole. Pokud tuto možnost vynecháte nebo zadáte neplatnou hodnotu, příkaz vytiskne názvy a ID blueprintů první strany.
-s, --mcp-server-name <mcp-server-name>	Required. Název MCP serveru. Aplikace Entra se rozuzlí jako .<name> - BYO
--tenant-id <tenant-id>	ID klienta Azure AD. Výchozí nastavení je aktuální Azure CLI kontext.
-y, --yes	Uděl chybějící oprávnění všem instancím uvedených agentů bez vyzvání.
--device-code	Použijte autentizaci kódem zařízení místo interaktivního toku prohlížeče (WAM broker na Windows). Použijte je, když WAM nemůže zobrazit přihlašovací dialog, například vestavěný nebo vzdálený terminál. Otevře se ve https://microsoft.com/devicelogin vašem prohlížeči.
--dry-run	Nahlaste, které instance agentů chybí oprávnění bez jeho udělení.
-v, --verbose	Povolte podrobné protokolování
-?, -h, --help	Zobrazení informací o nápovědě a využití

develop-mcp list-environments

Vypíše všechna prostředí Dataverse dostupná pro správu serveru MCP.

a365 develop-mcp list-environments [options]

Tento příkaz zobrazí všechna prostředí Dataverse, kde můžete spravovat servery MCP.

list-environments možnosti

Option	Description
--dry-run	Zobrazení toho, co by se udělalo bez provedení
-v, --verbose	Povolte podrobné protokolování
-?, -h, --help	Zobrazení informací o nápovědě a využití

develop-mcp list-servers

Vypište servery MCP v konkrétním prostředí Dataverse.

a365 develop-mcp list-servers [options]

Tento příkaz uvádí všechny MCP servery, které jsou aktuálně nasazeny ve specifikovaném prostředí Dataverse.

list-servers možnosti

Option	Description
-e, --environment-id <environment-id>	ID prostředí Dataverse
--dry-run	Zobrazení toho, co by se udělalo bez provedení
-v, --verbose	Povolte podrobné protokolování
-?, -h, --help	Zobrazení informací o nápovědě a využití

develop-mcp publish

Publikujte server MCP do prostředí Dataverse.

a365 develop-mcp publish [options]

Pomocí tohoto příkazu publikujte server MCP do zadaného prostředí Dataverse.

Important

Publikování MCP serveru to neschvaluje. Publikování pouze odešle server vašemu tenantovi a vytvoří čekající žádost o schválení. Než může jakýkoli agent server používat, musí jej správce tenantu schválit na stránce Požadované nástroje v Centrum pro správu Microsoftu 365. Dokud administrátor žádost neschválí, zůstává server pro agenty nedostupný. Když příkaz uspěje, CLI vytiskne připomínku, aby správce tenantu schválil server.

Když publikujete, CLI vytvoří následující registrace aplikací Microsoft Entra ve vašem tenantu:

App registration	Purpose	When created
<server-name>-PublicClients	Drží oprávnění OAuth, která používají hostitelé klientů (například Visual Studio Code a Microsoft Copilot CLI) k volání publikovaného MCP serveru.	CLI vytváří tuto aplikaci pro každý server.
<server-name>-A365Proxy	Funguje jako důvěrná klientská aplikace s klientským tajemstvím. CLI přeposílá přihlašovací údaje aplikace platformě, která je použije k vytvoření konektoru Power Platform pro server.	CLI vytváří tuto aplikaci pouze pro vlastní (mimo Dataverse) MCP servery. Servery First-party Dataverse, jako msdyn_DataverseMCPServernapříklad , tuto aplikaci přeskočí, protože platforma jim poskytuje vlastní aplikaci.

Protože příkaz vytváří registrace aplikací, musí mít účet, který CLI provozuje, oprávnění Application.ReadWrite.All Microsoft Graph. Bez tohoto povolení selže. publish Pokud publikování selže, CLI smaže registrace aplikací, které vytvořil. Pokud server stáhnete z publikace, tyto registrace aplikací ručně smažte.

V nájemcích, které omezují životnost klientského tajemství politikou appManagementPolicies , použijte --secret-lifetime-months nastavení životnosti v rámci limitu pro klientské <server-name>-A365Proxy tajemství.

Note

Umožnit --publisher-name vlastní (uživatelem vytvořené) MCP servery. Hodnota je zapsána do metadat vývojářů publikovaného balíčku a je vyžadována pro tyto servery. U serverů vlastněných Microsoft první stranou (například msdyn_DataverseMCPServer), které vždy publikují jako "Microsoft), je to ignorováno. Když ho vynecháte, CLI ho interaktivně vyzve; Procházet --yes k publikaci bez promptů v CI nebo skriptovaných kontextech.

publish možnosti

Option	Description
-e, --environment-id <environment-id>	ID prostředí Dataverse
-s, --server-name <server-name>	Název serveru MCP k publikování
-a, --alias <alias>	Alias pro server MCP
-d, --display-name <display-name>	Zobrazovaný název serveru MCP
-p, --publisher-name <publisher-name>	Jméno Publisher je zapsáno do metadat publikovaného balíčku. Vyžadováno pro vlastní (uživatelem vytvořené) MCP servery; ignorováno u serverů vlastněných Microsoft první strany. Interaktivně vyzněno, když je vynecháno.
--service-tree-id <service-tree-id>	ServiceTree ID pro registrace aplikací Microsoft Entra, které publish vytvářejí. Vyžadováno v Microsoft firemních nájemcích.
-l, --secret-lifetime-months <months>	Životnost v měsících (1–24) pro klientské tajemství v <server-name>-A365Proxy aplikaci Microsoft Entra. Pokud je vynechán, Microsoft Entra ID uplatňuje svou výchozí životnost přibližně 2 roky. Pokud pojistka vašeho nájemce appManagementPolicies vyžaduje kratší maximální limit, nastavte hodnotu v rámci tohoto limitu.
-y, --yes	Přeskočte interaktivní "Pokračujte s publikací? (y/N)" confirmation. Použití v CI nebo skriptovaných kontextech.
--dry-run	Zobrazení toho, co by se udělalo bez provedení
-v, --verbose	Povolte podrobné protokolování
-?, -h, --help	Zobrazení informací o nápovědě a využití

Kontrola a schvalování žádostí MCP

develop-mcp unpublish

Zrušte publikování serveru MCP z prostředí Dataverse.

a365 develop-mcp unpublish [options]

Tento příkaz použijte k odebrání serveru MCP ze zadaného prostředí Dataverse.

unpublish možnosti

Option	Description
-e, --environment-id <environment-id>	ID prostředí Dataverse
-s, --server-name <server-name>	Název serveru MCP pro zrušení publikování
--dry-run	Zobrazení toho, co by se udělalo bez provedení
-?, -h, --help	Zobrazení informací o nápovědě a využití

develop-mcp register-external-mcp-server

Zaregistrujte externí MCP server pomocí Entra, externího OAuth, API klíče nebo bez autentizace.

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

Použijte tento příkaz k registraci externě hostovaného (třetí strany) MCP serveru u vašeho tenanta. Příkaz vytváří registrace aplikací Microsoft Entra, které platforma potřebuje, volá platformu Agent 365 pro přidání MCP serveru a konfiguruje URI přesměrování a oprávnění API u nových registrací aplikací.

Název serveru musí začínat předponou ext_ a mít maximálně 20 znaků, například ext_MyServer. Názvy nástrojů musí přesně odpovídat názvy, které zpřístupnil vzdálený MCP server. Nesouladné názvy způsobují, že volání nástrojů selhávají za běhu.

Parametry můžete poskytnout třemi způsoby:

• Předejte je jako možnosti v příkazovém řádku.
• Poskytnout JSON soubor s --input-file. Příkazové řádky přepisují hodnoty ze souboru. Podívejte se register-external-mcp-server-sample.json do šablon CLI pro strukturu souboru.
• Vynechte jakoukoli požadovanou hodnotu, která by měla být interaktivně vyvolána.

Po úspěšné registraci požádejte správce nájemce, aby schválil nový MCP server dříve, než jej agenti mohou použít. Pokud jste se zaregistrovali s ExternalOAuth, přidejte také zobrazený přesměrovací URI do své externí IDP aplikace.

Important

Pokud registrace selže po vytvoření registrací v aplikaci Microsoft Entra, aplikace se automaticky nevrátí zpět. Před dalším pokusem je ručně smažte v Azure portálu.

register-external-mcp-server možnosti

Některé možnosti jsou vyžadovány pouze pro konkrétní typy autentizace, jak je popsáno v popisném sloupci.

Option	Description
-s, --server-name <server-name>	Název MCP serveru. Musí začínat a ext_ mít maximálně 20 znaků, například ext_MyServer
-u, --server-url <server-url>	URL vzdáleného MCP serveru. Musí to být platná HTTP nebo HTTPS URL
-a, --auth-type <auth-type>	Typ autentizace: EntraOAuth, ExternalOAuth, APIKey, nebo NoAuth
--publisher <publisher>	Název Publisher (použito v metadatech balíčku)
--description <description>	Popis serveru (používá se v metadatech balíčku)
--tools <tools>	Například seznam jmen nástrojů oddělených čárkami tool1,tool2,tool3
-f, --input-file <input-file>	Cesta k souboru JSON s registračními parametry
--remote-scopes <remote-scopes>	Rozsahy pro vzdálený MCP server, například api://{appId-guid}/{scopeName}. Používá se s EntraOAuth.
-t, --tenant-id <tenant-id>	Entra tenant ID pro registraci aplikace. Výchozí nastavení na současného az login nájemce
--service-tree-id <service-tree-id>	ServiceTree ID pro registraci aplikace Entra. Povinné v Microsoft firemních nájemcích
-l, --secret-lifetime-months <months>	Životnost v měsících (1–24) pro generovaná klientská tajemství v vytvořených aplikacích Entra. Výchozí doba je 24 měsíců (2 roky). Nastavte hodnotu nižší než je appManagementPolicies maximální limit u vašeho nájemce, pokud vaše pojistka vyžaduje kratší maximální limit
--idp-authorization-url <url>	Externí autorizační URL OAuth. Vyžadováno, když je --auth-typeExternalOAuth
--idp-token-url <url>	Externí URL tokenu OAuth. Vyžadováno, když je --auth-typeExternalOAuth
--idp-scopes <scopes>	Externí OAuth mikroskopy. Vyžadováno, když je --auth-typeExternalOAuth
--idp-client-id <client-id>	Externí OAuth client ID. Vyžadováno, když je --auth-typeExternalOAuth
--idp-client-secret <client-secret>	Tajemství externího klienta OAuth. Vyžadováno, když je --auth-typeExternalOAuth
--api-key-location <location>	Umístění API klíče: Header nebo Query. Vyžadováno, když je --auth-typeAPIKey
--api-key-name <name>	Parametr API klíče nebo název hlavičky, například X-API-Key .token Vyžadováno, když je --auth-typeAPIKey
--dry-run	Zobrazení toho, co by se udělalo bez provedení
-v, --verbose	Povolte podrobné protokolování
-?, -h, --help	Zobrazení informací o nápovědě a využití