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 nabízí možnosti publikovat, odpublikovat a registrovat MCP servery pro použití v prostředí Dataverse.

Note

Příkazy develop-mcp approve, develop-mcp block, a develop-mcp package-mcp-server jsou odstraněny z CLI Agenta 365. 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

Vyhodnoťte lokální server s automatickým výběrem enginu:

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

Vyhodnoťte autentizovaný server, přičemž token je zadán pomocí proměnné prostředí a artefakty jsou zapsané 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 pak jej ohodnotte vlastním LLM:

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

Vynuťte konkrétní bodovací motor:

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, použitý, když --auth-token není předán. Preferuje to před vlajkou, protože to zabraňuje tokenu v seznamech procesů a historii 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á model alias (například haiku) nebo plné ID modelu.

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 zobrazí všechny servery MCP, které jsou aktuálně nasazené v zadané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.

Když publikujete, CLI vytvoří registraci aplikace <server-name>-PublicClients Microsoft Entra ve vašem tenantu. Tato aplikace drží oprávnění OAuth, která používají klientští hostitelé (například Visual Studio Code a Microsoft 365 Copilot CLI) k volání publikovaného MCP serveru. Protože příkaz vytváří registraci aplikace, musí mít účet, který CLI spravuje, oprávnění Application.ReadWrite.All Microsoft Graph. Běhání publish bez něj selže.

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

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žaduje se, když je --auth-typeExternalOAuth
--idp-token-url <url>	Externí URL tokenu OAuth. Vyžaduje se, když je --auth-typeExternalOAuth
--idp-scopes <scopes>	Externí OAuth mikroskopy. Vyžaduje se, když je --auth-typeExternalOAuth
--idp-client-id <client-id>	Externí OAuth client ID. Vyžaduje se, když je --auth-typeExternalOAuth
--idp-client-secret <client-secret>	Tajemství externího klienta OAuth. Vyžaduje se, když je --auth-typeExternalOAuth
--api-key-location <location>	Umístění API klíče: Header nebo Query. Vyžaduje se, když je --auth-typeAPIKey
--api-key-name <name>	Parametr API klíče nebo název hlavičky, například X-API-Key .token Vyžaduje se, 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í