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

Správa serverů nástrojů MCP pro vývoj agentů Příkaz develop poskytuje možnosti správy serverů nástrojů MCP (Model Context Protocol) pro vývoj agentů. Můžete zobrazit seznam dostupných serverů, zobrazit nakonfigurované servery a přidat nebo odebrat servery MCP z konfigurace agenta.

Minimální požadovaná role: Žádná (místní správa manifestu)

Syntax

a365 develop [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 list-available

Zobrazí seznam všech serverů MCP dostupných v katalogu (co můžete nainstalovat).

a365 develop list-available [options]

Tento příkaz zobrazí všechny servery MCP, které jsou dostupné v katalogu, a můžete je nainstalovat pro použití s vývojem agenta.

list-available možnosti

Option Description
--dry-run Zobrazit, co by příkaz udělal, aniž by ho spouštěl.
--skip-auth Skip authentication. Pouze pro testování. Příkaz pravděpodobně selže bez platného ověřování.
-?, , -h--help Zobrazení informací o nápovědě a využití

Note

develop list-available nevyžaduje a365.config.json. Čte prostředí z A365_ENVIRONMENT proměnné prostředí (výchozí ).prod

develop list-configured

Seznam aktuálně nakonfigurovaných serverů MCP z místního ToolingManifest.jsonserveru .

a365 develop list-configured [options]

Tento příkaz zobrazí všechny servery MCP, které jste aktuálně nakonfigurovali v místním souboru ToolingManifest.json.

list-configured možnosti

Option Description
--project-path <path> Cesta k adresáři ToolingManifest.jsonagentů obsahujících . Přepisuje DeploymentProjectPath z a365.config.json.
--dry-run Zobrazit, co by příkaz udělal, aniž by ho spouštěl.
-?, , -h--help Zobrazení informací o nápovědě a využití

develop add-mcp-servers

Přidejte servery MCP do aktuální konfigurace agenta.

a365 develop add-mcp-servers [<servers>...] [options]

Tento příkaz přidá zadané servery MCP do ToolingManifest.json složky projektu. Neuděluje oprávnění podrobnému plánu agenta.

Important

Tento příkaz se pouze aktualizuje ToolingManifest.json – neuděluje oprávnění agentnímu blueprintu. Jak aplikujete oprávnění, závisí na tom, kde se nacházíte v procesu nastavení:

  • Před počátečním nastavením: Pokračujte a365 setup all. Oprávnění MCP se použijí jako součást počátečního vytvoření podrobného plánu.
  • Jakmile již podrobný plán existuje: Globální správce musí běžet a365 setup permissions mcp samostatně. Administrátor musí ověřit, že odkazuje deploymentProjectPath na složku projektu obsahující aktualizované ToolingManifest.json.

add-mcp-servers argumenty

Zadejte jeden nebo více názvů serverů MCP, které chcete přidat do konfigurace agenta. Můžete zadat více názvů serverů oddělených mezerami.

Argument Description
<servers> Názvy serverů MCP, které se mají přidat

add-mcp-servers možnosti

Pomocí těchto možností můžete přizpůsobit chování add-mcp-servers příkazu.

Option Description
--project-path <path> Cesta k adresáři ToolingManifest.jsonagentů obsahujících . Přepisuje DeploymentProjectPath z a365.config.json.
--dry-run Zobrazit, co by příkaz udělal, aniž by ho spouštěl.
-?, , -h--help Zobrazení informací o nápovědě a využití

develop remove-mcp-servers

Odeberte servery MCP z aktuální konfigurace agenta.

a365 develop remove-mcp-servers [<servers>...] [options]

Tento příkaz odebere zadané servery MCP z aktuální konfigurace agenta.

remove-mcp-servers argumenty

Argument Description
<servers> Názvy serverů MCP, které se mají odebrat

remove-mcp-servers možnosti

Option Description
--project-path <path> Cesta k adresáři ToolingManifest.jsonagentů obsahujících . Přepisuje DeploymentProjectPath z a365.config.json.
--dry-run Zobrazit, co by příkaz udělal, aniž by ho spouštěl.
-?, , -h--help Zobrazení informací o nápovědě a využití

develop add-permissions

Přidejte oprávnění rozhraní API serveru MCP k Microsoft Entra aplikacím pro vývojové scénáře, ve kterých potřebujete nakonfigurovat vlastní aplikace pro přístup k serverům MCP.

a365 develop add-permissions [options]

add-permissions možnosti

Pomocí těchto možností můžete do registrace aplikace přidat požadovaná oprávnění a obory rozhraní API a využít hodnoty z manifestu nástrojů.

Option Description
-m, --manifest <manifest> Cesta k ToolingManifest.json (výchozí: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> ID aplikace (klienta) pro přidání oprávnění (výchozí: clientAppId z konfigurace)
--scopes <scopes> Konkrétní obory, které se mají přidat (oddělené mezerami) (výchozí: Všechny obory od ToolingManifest.json)
--dry-run Zobrazení toho, co by příkaz udělal bez provedení změn
-v, --verbose Zobrazit podrobný výstup
-?, , -h--help Zobrazení informací o nápovědě a využití

Important

Aplikace určená --app-id nebo clientAppId musí mít v Microsoft Entra oprávnění Application.ReadWrite.All. Tento příkaz je určený pro vlastní klientské aplikace. Pokud chcete nakonfigurovat oprávnění pro podrobné plány agenta, použijte a365 setup permissions mcp místo toho.

develop get-token

Načtěte nosné tokeny pro testování serverů MCP během vývoje pomocí interaktivního ověřování prohlížeče.

a365 develop get-token [options]

get-token možnosti

Pomocí těchto možností můžete požádat o přístupový token, řídit obory, chování aktualizace a zvolit výstupní formát.

Option Description
--app-id <app-id> ID aplikace (klienta) pro ověřování (výchozí nastavení: clientAppId z konfigurace)
-m, --manifest <manifest> Cesta k ToolingManifest.json (výchozí: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Konkrétní obory pro vyžádání (oddělené mezerami) (výchozí hodnota: Čtení z ToolingManifest.json)
-o, --output <output> Výstupní formát: table, jsonnebo raw (výchozí: table)
--force-refresh Vynucení obejití mezipaměti obnovení tokenu
--resource <resource> Klíčové slovo prostředku pro získání tokenu pro: mcp (výchozí) nebo powerplatform
--resource-id <resource-id> ID vlastní aplikace prostředků (GUID) pro prostředky, které nejsou pokryté klíčovými --resource slovy
-v, --verbose Zobrazit podrobný výstup včetně úplného tokenu
-?, , -h--help Zobrazení informací o nápovědě a využití

get-token možnosti prostředků

Pomocí možností --resource a --resource-id získejte tokeny pro různé prostředky Azure:

  • --resource: Použití klíčového slova k výběru předdefinovaného prostředku:
    • mcp (výchozí): Nástroje agenta 365 pro servery MCP
    • powerplatform: Power Platform API
  • --resource-id: Zadejte ID vlastní aplikace prostředků (GUID) pro prostředky, které nejsou pokryty klíčovými slovy.

Important

Nemůžeš použít --resource a --resource-id dohromady. Pokud použijete některou z možností, zahrňte --scopes. Pouze výchozí tok MCP podporuje rozlišení rozsahu založeného na manifestu.

develop start-mock-tooling-server

Spusťte napodobení serveru nástrojů pro účely testování a vývoje.

a365 develop start-mock-tooling-server [options]

Tento příkaz spustí napodobení serveru nástrojů pro účely testování a vývoje. Pomocí tohoto serveru můžete simulovat interakce serveru MCP, aniž byste museli provádět skutečné implementace serveru.

start-mock-tooling-server možnosti

Pomocí těchto možností můžete přizpůsobit chování start-mock-tooling-server příkazu.

Option Description Default
-p, --port <port> Číslo portu pro napodobený server 5309
-v, --verbose Povolení podrobného protokolování false
-?, -h, --help Zobrazení informací o nápovědě a využití -
-bg Spuštění serveru na novém terminálu -