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, schvalovat, blokovat, balit a registrovat MCP servery pro použití v prostředí Dataverse.

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

Syntax

a365 develop-mcp [command] [options]

Možnosti

Option Description
-v, --verbose Povolení podrobného 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 Povolení podrobného 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 Povolení podrobného 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.

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
--dry-run Zobrazení toho, co by se udělalo bez provedení
-?, , -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 approve

Schválit server MCP.

a365 develop-mcp approve [options]

Tento příkaz schválí server MCP pro použití v prostředí.

approve možnosti

Option Description
-s, --server-name <server-name> Název serveru MCP ke schválení
--dry-run Zobrazení toho, co by se udělalo bez provedení
-?, , -h--help Zobrazení informací o nápovědě a využití

develop-mcp block

Zablokuje server MCP.

a365 develop-mcp block [options]

Pomocí tohoto příkazu zablokujte použití serveru MCP ve vašem prostředí.

block možnosti

Option Description
-s, --server-name <server-name> Název serveru MCP, který se má blokovat
--dry-run Zobrazení toho, co by se udělalo bez provedení
-?, , -h--help Zobrazení informací o nápovědě a využití

develop-mcp package-mcp-server

Vygenerujte balíček serveru MCP pro odeslání v centru pro správu Microsoft.

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

Pomocí tohoto příkazu vytvořte balíček nasazení pro server MCP, který můžete odeslat do Centra pro správu Microsoftu.

package-mcp-server možnosti

Option Description
--server-name <server-name> Název serveru MCP (POVINNÉ)
--developer-name <developer-name> Zobrazovaný název vydavatele nebo vývojáře (POVINNÉ)
--icon-url <icon-url> Veřejná adresa URL ikony PNG pro server MCP (POVINNÉ)
--output-path <output-path> Cílový adresář pro vygenerovaný balíček ZIP (POVINNÉ)
--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
--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 Povolení podrobného protokolování
-?, , -h--help Zobrazení informací o nápovědě a využití