Agent 365 CLI
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 |
ヘルプと使用状況の情報を表示する |