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

Dataverse 環境で MCP サーバーを管理します。 develop-mcpコマンドは、Dataverse環境で使用するためにMCPサーバーの公開、公開解除、承認、ブロック、パッケージ化、登録のオプションを提供します。

必要な最小限のロール: サブコマンドによって異なります

Syntax

a365 develop-mcp [command] [options]

オプション

Option Description
-v、--verbose 詳細ログを有効にする
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp list-environments

MCP サーバー管理に使用できるすべての Dataverse 環境を一覧表示します。

a365 develop-mcp list-environments [options]

このコマンドは、MCP サーバーを管理できるすべての Dataverse 環境を表示します。

list-environments のオプション

Option Description
--dry-run 実行せずに何が行われるかを表示する
-v、--verbose 詳細ログを有効にする
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp list-servers

特定の Dataverse 環境内の MCP サーバーを一覧表示します。

a365 develop-mcp list-servers [options]

このコマンドは、指定された Dataverse 環境に現在デプロイされているすべての MCP サーバーを表示します。

list-servers のオプション

Option Description
-e、--environment-id <environment-id> Dataverse 環境 ID
--dry-run 実行せずに何が行われるかを表示する
-v、--verbose 詳細ログを有効にする
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp publish

MCP サーバーを Dataverse 環境に発行します。

a365 develop-mcp publish [options]

このコマンドを使用して、指定した Dataverse 環境に MCP サーバーを発行します。

publish のオプション

Option Description
-e、--environment-id <environment-id> Dataverse 環境 ID
-s、--server-name <server-name> 発行する MCP サーバー名
-a、--alias <alias> MCP サーバーのエイリアス
-d、--display-name <display-name> MCP サーバーの表示名
--dry-run 実行せずに何が行われるかを表示する
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp unpublish

Dataverse 環境から MCP サーバーを発行解除します。

a365 develop-mcp unpublish [options]

このコマンドを使用して、指定された Dataverse 環境から MCP サーバーを削除します。

unpublish のオプション

Option Description
-e、--environment-id <environment-id> Dataverse 環境 ID
-s、--server-name <server-name> 発行を解除する MCP サーバー名
--dry-run 実行せずに何が行われるかを表示する
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp approve

MCP サーバーを承認します。

a365 develop-mcp approve [options]

このコマンドは、環境で使用する MCP サーバーを承認します。

approve のオプション

Option Description
-s、--server-name <server-name> 承認する MCP サーバー名
--dry-run 実行せずに何が行われるかを表示する
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp block

MCP サーバーをブロックします。

a365 develop-mcp block [options]

このコマンドを使用して、MCP サーバーが環境内で使用されないようにします。

block のオプション

Option Description
-s、--server-name <server-name> ブロックする MCP サーバー名
--dry-run 実行せずに何が行われるかを表示する
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp package-mcp-server

管理センターで送信する MCP サーバー パッケージMicrosoft生成します。

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

このコマンドを使用して、Microsoft 管理センターに送信できる MCP サーバーの展開パッケージを作成します。

package-mcp-server のオプション

Option Description
--server-name <server-name> MCP サーバー名 (必須)
--developer-name <developer-name> 発行元または開発者の表示名 (必須)
--icon-url <icon-url> MCP サーバーの PNG アイコンへのパブリック URL (必須)
--output-path <output-path> 生成された ZIP パッケージのターゲット ディレクトリ (必須)
--dry-run 実行せずに何が行われるかを表示する
-?、 -h、 --help ヘルプと使用状況の情報を表示する

develop-mcp register-external-mcp-server

Entra、外部OAuth、APIキー、または認証なしで外部MCPサーバーを登録してください。

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

このコマンドを使って、外部ホスト(サードパーティ)のMCPサーバーをテナントに登録してください。 このコマンドは、プラットフォームが必要とするMicrosoft Entraアプリ登録を作成し、Agent 365プラットフォームを呼び出してMCPサーバーを追加し、新しいアプリ登録に対してURIやAPI権限のリダイレクトを設定します。

サーバー名は ext_ の接頭辞で始まり、最大20文字(例えば ext_MyServer)まででなければなりません。 ツール名はリモートMCPサーバーから公開された名前と正確に一致しなければなりません。 名前が一致しないと、実行時にツール呼び出しが失敗します。

パラメータは以下の3つの方法で提供できます:

  • コマンドラインのオプションとして渡してください。
  • --input-file付きのJSONファイルを提供します。 コマンドラインのオプションはファイルの値を上書きします。 ファイル構造についてはCLIテンプレートの中 register-external-mcp-server-sample.json を参照してください。
  • インタラクティブに求められる値は省略してください。

登録が成功したら、エージェントが使用できるようにする前に、テナント管理者に新しいMCPサーバーの承認を求めてください。 ExternalOAuthに登録している場合は、表示されたリダイレクトURIを外部IDPアプリケーションに追加してください。

Important

Microsoft Entraアプリ登録が作成された後に登録が失敗した場合、アプリは自動的にロールバックされません。 再試す前にAzureポータルで手動で削除してください。

register-external-mcp-server のオプション

一部のオプションは、説明欄に記載されているように、特定の認証タイプにのみ必要です。

Option Description
-s、--server-name <server-name> MCPサーバー名。 例えば、 ext_ 文字で始まり、最大20文字以内にしなければならない ext_MyServer
-u、--server-url <server-url> リモートMCPサーバーのURLです。 有効なHTTPまたはHTTPSのURLでなければなりません
-a、--auth-type <auth-type> 認証タイプ: EntraOAuth、 ExternalOAuth、 APIKey、または NoAuth
--publisher <publisher> Publisher名(パッケージメタデータで使用)
--description <description> サーバー記述(パッケージメタデータで使用)
--tools <tools> 例えば、このサーバーが公開したツール名のカンマ区切りリストなど tool1,tool2,tool3
-f、--input-file <input-file> 登録パラメータを含むJSONファイルへのパス
--remote-scopes <remote-scopes> 例えば、リモートMCPサーバーのスコープ、 api://{appId-guid}/{scopeName}。 EntraOAuth と共に使用します。
-t、--tenant-id <tenant-id> アプリ登録用のEntraテナントIDです。 現在の az login テナントへのデフォルト
--service-tree-id <service-tree-id> Entraアプリの登録用にServiceTree IDを使ってください。 Microsoftのコーポレートテナントで必須
--idp-authorization-url <url> 外部OAuth認証URL。 --auth-type が ExternalOAuth されている場合は必須
--idp-token-url <url> 外部OAuthトークンURL。 --auth-type が ExternalOAuth されている場合は必須
--idp-scopes <scopes> 外部OAuthスコープ。 --auth-type が ExternalOAuth されている場合は必須
--idp-client-id <client-id> 外部OAuthクライアントID。 --auth-type が ExternalOAuth されている場合は必須
--idp-client-secret <client-secret> 外部OAuthクライアントの秘密。 --auth-type が ExternalOAuth されている場合は必須
--api-key-location <location> APIキーの位置: Header または Query。 --auth-type が APIKey されている場合は必須
--api-key-name <name> APIキーパラメータやヘッダー名、例えば X-API-Key や token。 --auth-type が APIKey されている場合は必須
--dry-run 実行せずに何が行われるかを表示する
-v、--verbose 詳細ログを有効にする
-?、 -h、 --help ヘルプと使用状況の情報を表示する
  • Last updated on