Agent 365 CLI develop コマンド リファレンス

エージェント開発用の MCP ツール サーバーを管理します。 develop コマンドには、エージェント開発用の MCP (モデル コンテキスト プロトコル) ツール サーバーを管理するためのオプションが用意されています。 使用可能なサーバーの一覧表示、構成済みのサーバーの表示、エージェント構成での MCP サーバーの追加または削除を行うことができます。

最低限必要なロール: なし (ローカル マニフェスト管理)

Syntax

a365 develop [command] [options]

オプション

Option Description
-c--config <config> 構成ファイルのパス。 Default: a365.config.json
-v--verbose 詳細ログを有効にする
-?-h--help ヘルプと使用状況の情報を表示します。

develop list-available

カタログで使用可能なすべての MCP サーバーを一覧表示します (インストールできる内容)。

a365 develop list-available [options]

このコマンドを実行すると、カタログで使用可能なすべての MCP サーバーが表示され、エージェント開発で使用するためにインストールできます。

list-available のオプション

Option Description
--dry-run コマンドを実行せずに実行する内容を表示します。
--skip-auth Skip authentication. テスト専用。 このコマンドは、有効な認証なしで失敗する可能性があります。
-?-h--help ヘルプと使用状況の情報を表示します。

Note

develop list-available a365.config.jsonは必要ありません。 環境変数 A365_ENVIRONMENT から環境を読み取ります(デフォルトは prodです)。

develop list-configured

ローカル ToolingManifest.jsonから現在構成されている MCP サーバーを一覧表示します。

a365 develop list-configured [options]

このコマンドは、ローカル ToolingManifest.json ファイルで現在構成されているすべての MCP サーバーを表示します。

list-configured のオプション

Option Description
--project-path <path> ToolingManifest.jsonを含むエージェントプロジェクトディレクトリへのパス。 DeploymentProjectPathからのa365.config.jsonを上書きします。
--dry-run コマンドを実行せずに実行する内容を表示します。
-?-h--help ヘルプと使用状況の情報を表示します。

develop add-mcp-servers

MCP サーバーを現在のエージェント構成に追加します。

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

このコマンドは、指定した MCP サーバーをプロジェクト フォルダー内の ToolingManifest.json に追加します。 エージェント ブループリントへのアクセス許可は付与されません。

Important

このコマンドは ToolingManifest.json のみ更新し、エージェントブループリントに権限を与えるわけではありません。 権限の適用方法はセットアップのどの段階にいるかによって異なります:

  • 初期セットアップの前に: a365 setup allに進みます。 MCP アクセス許可は、最初のブループリント作成の一部として適用されます。
  • ブループリントが既に存在した後:グローバル管理者は、 a365 setup permissions mcp 個別に実行する必要があります。 管理者は、 deploymentProjectPath が更新された ToolingManifest.jsonを含むプロジェクトフォルダを指していることを確認しなければなりません。

add-mcp-servers 引数

エージェント構成に追加する 1 つ以上の MCP サーバー名を指定します。 複数のサーバー名をスペースで区切って指定できます。

Argument Description
<servers> 追加する MCP サーバーの名前

add-mcp-servers のオプション

これらのオプションを使用して、 add-mcp-servers コマンドの動作をカスタマイズします。

Option Description
--project-path <path> ToolingManifest.jsonを含むエージェントプロジェクトディレクトリへのパス。 DeploymentProjectPathからのa365.config.jsonを上書きします。
--dry-run コマンドを実行せずに実行する内容を表示します。
-?-h--help ヘルプと使用状況の情報を表示します。

develop remove-mcp-servers

現在のエージェント構成から MCP サーバーを削除します。

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

このコマンドは、指定された MCP サーバーを現在のエージェント構成から削除します。

remove-mcp-servers 引数

Argument Description
<servers> 削除する MCP サーバーの名前

remove-mcp-servers のオプション

Option Description
--project-path <path> ToolingManifest.jsonを含むエージェントプロジェクトディレクトリへのパス。 DeploymentProjectPathからのa365.config.jsonを上書きします。
--dry-run コマンドを実行せずに実行する内容を表示します。
-?-h--help ヘルプと使用状況の情報を表示します。

develop add-permissions

MCP サーバーにアクセスするようにカスタム アプリケーションを構成する必要がある開発シナリオで、MCP サーバー API のアクセス許可をMicrosoft Entraアプリケーションに追加します。

a365 develop add-permissions [options]

add-permissions のオプション

これらのオプションを使用して、必要な API のアクセス許可とスコープをアプリの登録に追加し、ツール マニフェストの値を利用します。

Option Description
-c--config <config> 構成ファイルのパス (既定値: a365.config.json)
-m--manifest <manifest> ToolingManifest.jsonへのパス (既定値: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> アクセス許可を追加するアプリケーション (クライアント) ID (既定値: 構成からの clientAppId )
--scopes <scopes> 追加する特定のスコープ (スペース区切り) (既定値: ToolingManifest.jsonのすべてのスコープ)
--dry-run 変更を加えずにコマンドの実行内容を表示する
-v--verbose 詳細な出力を表示する
-?-h--help ヘルプと使用状況の情報を表示します。

Important

--app-id または clientAppId で指定されたアプリケーションには、Microsoft Entraで Application.ReadWrite.All アクセス許可が必要です。 このコマンドは、カスタム クライアント アプリケーション用です。 エージェント ブループリントのアクセス許可を構成するには、代わりに a365 setup permissions mcp を使用します。

develop get-token

対話型ブラウザー認証を使用して、開発中に MCP サーバーをテストするためのベアラー トークンを取得します。

a365 develop get-token [options]

get-token のオプション

これらのオプションを使用して、アクセス トークンを要求し、スコープを制御し、動作を更新し、出力形式を選択します。

Option Description
-c--config <config> 構成ファイルのパス (既定値: a365.config.json)
--app-id <app-id> 認証用のアプリケーション (クライアント) ID (既定値: 構成からの clientAppId )
-m--manifest <manifest> ToolingManifest.jsonへのパス (既定値: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> 要求する特定のスコープ (スペース区切り) (既定値: ToolingManifest.jsonから読み取ります)
-o--output <output> 出力形式: tablejson、または raw (既定値: table)
--force-refresh キャッシュをバイパスするトークン更新を強制する
--resource <resource> トークンを取得するリソース キーワード: mcp (既定) または powerplatform
--resource-id <resource-id> --resource キーワードでカバーされていないリソースのカスタム リソース アプリケーション ID (GUID)
-v--verbose 完全なトークンを含む詳細な出力を表示する
-?-h--help ヘルプと使用状況の情報を表示します。

get-token リソース オプション

--resource オプションと --resource-id オプションを使用して、さまざまなAzure リソースのトークンを取得します。

  • --resource: キーワードを使用して、定義済みのリソースを選択します。
    • mcp (既定値): エージェント 365 Tools for MCP サーバー
    • powerplatform: Power Platform API
  • --resource-id: キーワードでカバーされていないリソースのカスタム リソース アプリケーション ID (GUID) を入力します

Important

--resource--resource-idを同時に使うことはできません。 いずれかのオプションを使用する場合は、 --scopesを含めます。 マニフェストベースのスコープ解決は、既定の MCP フローでのみサポートされます。

develop start-mock-tooling-server

テストと開発の目的でモック ツール サーバーを起動します。

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

このコマンドは、テストと開発の目的でモック ツール サーバーを起動します。 このサーバーを使用すると、実際のサーバー実装を必要とせずに、MCP サーバーの対話をシミュレートできます。

start-mock-tooling-server のオプション

これらのオプションを使用して、 start-mock-tooling-server コマンドの動作をカスタマイズします。

Option Description Default
-p, --port <port> モックサーバーのポート番号 5309
-v, --verbose 詳細ログを有効にする false
-?, -h, --help ヘルプと使用状況の情報を表示する -
-bg サーバーを新しい端末で起動してください -