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

Dataverse 環境で MCP サーバーを管理します。 develop-mcpコマンドは、Dataverse環境で使用するためにMCPサーバーの公開、アンパブリッシュ、登録のオプションを提供します。

Note

develop-mcp approve、develop-mcp block、develop-mcp package-mcp-serverコマンドはエージェント365 CLIから削除されます。 テナント管理者は現在、Microsoft管理センターでサーバー承認とブロックを行います。保留中のリクエストはRequested Agentsページで確認されます。 CLIはもはや管理者センター提出用の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 サーバーを発行します。

公開すると、CLIはテナント内で<server-name>-PublicClients Microsoft Entraアプリの登録を作成します。 このアプリは、クライアントホスト(Visual Studio CodeやMicrosoft 365 Copilot CLIなど)が公開MCPサーバーを呼び出す際に使用するOAuth権限を保持しています。 コマンドがアプリ登録を作成するため、CLIを実行するアカウントはApplication.ReadWrite.All Microsoft Graph権限を保持している必要があります。 publishなしで動かすと失敗します。

Note

カスタム(ユーザー作成)MCPサーバー用の --publisher-name を提供します。 この値は公開されたパッケージの開発者メタデータに書き込まれ、これらのサーバーには必要です。 ファーストパーティのMicrosoft所有サーバー(例:msdyn_DataverseMCPServer)は無視され、常に「Microsoft」として公開されます。 省略すると、CLIはインタラクティブにプロインプトします。CIやスクリプト化された文脈でプロンプトなしで公開するための --yes パス。

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 サーバーの表示名
-p、--publisher-name <publisher-name> Publisher nameは公開されたパッケージのメタデータに書き込まれます。 カスタム(ユーザー作成)MCPサーバーに必要;ファーストパーティのMicrosoft所有サーバーは無視されています。 省略されたときにインタラクティブに促されます。
-y、--yes インタラクティブな「出版を進めますか?」はスキップしてください。 (y/N)" confirmation. CIやスクリプト化された文脈での使用。
--dry-run 実行せずに何が行われるかを表示する
-v、--verbose 詳細なログを有効にする
-?、-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 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のコーポレートテナントで必須
-l、--secret-lifetime-months <months> 作成されたEntraアプリで生成されたクライアントシークレットの寿命は月単位(1〜24)です。 デフォルトは24ヶ月(2年)となります。 もしテナントの保険で最低限額が制限されている場合は、入居者の appManagementPolicies 上限より低い額を設定しましょう
--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