Dataverse CLI を使用してデータを操作する (プレビュー)

Note

これはプレビュー機能です。
プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。これらの機能は正式リリース前に利用できるため、お客様は早期にアクセスしてフィードバックを提供できます。

Dataverse CLI は、Microsoft Dataverse用のクロスプラットフォームコマンドラインツールです。これを使用して、認証プロファイルの管理、データのクエリと変更、API の検出と呼び出し、リンクされた Finance and Operations (ERP) 環境の操作、AI アシスタントが環境と対話できるモデルコンテキストプロトコル (MCP) サーバーの実行を行います。

CLI は、 @microsoft/dataverse npm パッケージとして配布されます。主な機能は次のとおりです。

Microsoft Power Platform CLI 認証プロファイルと互換性のあるプロファイルベースの認証。
現在の組織を表示し、アクセス可能な環境を一覧表示する環境コマンド (org / env)。
レコードのクエリ、取得、作成、更新、アップサート、削除、カウントを行うデータコマンド。ファイル列にファイルをアップロードする。関連レコードの関連付けまたは関連付けの解除を行います。
Dataverse カスタム API と ERP の呼び出し可能なサービスエンドポイントの検出、記述、および呼び出し、または未加工の認証済み HTTP 要求の送信を行う動的な api コマンド。
skill AI エージェントによって使用される Dataverse スキルをアップロード、ダウンロード、一覧表示、および削除するためのコマンド。
Claude Desktop などの AI クライアント用の MCP サーバー。
--json スクリプティングでサポートされているコマンドに対する出力。

コマンドとそのパラメーターの完全な一覧については、 Dataverse CLI リファレンスを参照してください。

前提条件

CLI をインストールして実行するには、サポートされているプラットフォームにNode.js (npm を含む) がインストールされている必要があります。

MCP サーバーを使用して Dataverse 環境に認証して接続する前に、管理者は次の 3 つのセットアップ手順を完了する必要があります。

管理者の同意を付与します (テナント管理者Azure)。 Azure テナント管理者は、https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=0c412cc3-0dd6-449b-987f-05b053db9457に移動し、サインインし、要求されたアクセス許可を受け入れることで、Dataverse MCP CLI ツールアプリケーションの管理者の同意を付与します。 {your-tenant-id}を実際のAzureテナント ID に置き換えます。
MCP サーバー (Dataverse 管理者) を有効にします。 Dataverse 組織の管理者は、環境の MCP サーバー機能を有効にします。 Dataverse MCP の有効化 (運用) または Dataverse MCP の有効化 (プレビュー) を参照してください。
MCP CLI ツール (Dataverse 管理者) を許可します。 Dataverse 組織の管理者は、MCP クライアントリストの構成に従い、アプリ ID 0c412cc3-0dd6-449b-987f-05b053db9457を使用してアプリケーションを追加することで、許可されたクライアントアプリケーションの一覧に Dataverse MCP CLI ツールを追加します。これは、UI に Dataverse MCP CLI ツール として表示されます。

または、Dataverse 管理者アクセス許可を持つユーザーは、mcp allow コマンドを使用してアプリケーションを追加できます。

Note

MCP サーバーを介して Dataverse 環境を正常に認証して接続するには、3 つの手順をすべて完了する必要があります。

サポートされているプラットフォーム

Dataverse CLI では、次のプラットフォームがサポートされています。

Windows (x64、Arm64)
macOS (x64、Arm64/Apple シリコン)
Linux (x64、Arm64)

Dataverse CLI をインストールする

npm を使用して CLI をグローバルにインストールします。

npm install -g @microsoft/dataverse

または、 npxを使用して CLI をインストールせずに実行します。

npx @microsoft/dataverse <command> [options]

特定のバージョンをインストールするか、最新バージョンに更新するには、 install コマンドを使用します。

dataverse install latest
dataverse install 1.0.0

コマンドを実行すると、CLI によって npm で新しいバージョンが自動的にチェックされます。新しいバージョンが利用可能な場合は、更新できるように通知されます。

Claude Desktop で使用する

Claude Desktop が Dataverse 環境と対話できるように、CLI を MCP サーバーとして実行できます。

これを追加する最も簡単な方法は、Claude CLI を使用することです。

claude mcp add dataverse -t stdio -- npx -y @microsoft/dataverse mcp https://yourorg.crm.dynamics.com

Claude Desktop を手動で構成するには、MCP 構成ファイルを編集します。

ウィンドウズ： %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux： ~/.config/Claude/claude_desktop_config.json

mcpServers セクションにサーバーを追加します。

{
  "mcpServers": {
    "dataverse": {
      "command": "npx",
      "args": ["-y", "@microsoft/dataverse", "mcp", "https://yourorg.crm.dynamics.com"],
      "type": "stdio"
    }
  }
}

詳細な診断をキャプチャするには、args配列に--log-level Debugオプションと--log-file オプションを追加します。プレビュー MCP エンドポイントを使用するには、 --preview オプションを追加します。構成を変更した後、Claude Desktop を再起動します。

サーバーの起動の詳細については、 mcp コマンドを参照してください。

認証

CLI は認証に Microsoft Authentication Library (MSAL) を使用します。認証プロファイルとトークンをローカルにキャッシュします。これらのプロファイルは、Microsoft Power Platform CLI 認証プロファイルで動作します。

auth create コマンドを使用して初めて接続するときにプロファイルを作成します。

dataverse auth create --environment https://myorg.crm.dynamics.com

このコマンドを実行すると、ブラウザーまたはシステム認証ダイアログが開きます。サインインすると、プロファイルが保存されます。 mcpを含む後続のコマンドでは、もう一度メッセージを表示することなく、キャッシュされたトークンを使用します。

複数の環境を操作するには、それぞれに名前付きプロファイルを作成します。 auth select コマンドを使用して切り替えます。

dataverse auth create --environment https://dev.crm.dynamics.com --name dev
dataverse auth create --environment https://prod.crm.dynamics.com --name prod
dataverse auth select --name dev

CI/CD などの無人シナリオの場合は、サービスプリンシパルで認証します。

dataverse auth create --applicationId <appId> --clientSecret <secret> --tenant <tenantId> --environment https://myorg.crm.dynamics.com

ブラウザーがない環境の場合は、 --deviceCode オプションを追加してデバイスコードフローを使用します。証明書、マネージド ID、フェデレーション認証など、すべての認証オプションを表示するには、 dataverse auth create --helpを実行します。プロファイルを確認、一覧表示、および削除するには、 auth who、 auth list、および auth remove コマンドを参照してください。

ヘルプを取得する

すべてのコマンドとサブコマンドは、 --help オプションをサポートしています。使用状況、オプション、例が一覧表示されます。例えば次が挙げられます。

dataverse --help
dataverse auth --help
dataverse auth create --help
dataverse org --help
dataverse mcp --help
dataverse data query --help

サポートされている MCP 操作

MCP サーバーでは、次の操作がサポートされています。

ツール: Dataverse ツールを一覧表示して呼び出します。
プロンプト: プロンプトを一覧表示および取得します。
リソース: Dataverse リソースの一覧表示と読み取り。

環境 URL が https://myorg.operations.dynamics.com などの Finance and Operations (ERP) ホストである場合、 mcp コマンドは ERP MCP サーバーに自動的にルーティングされます。

Troubleshooting

セットアップを検証する

サーバーを起動する前に、 --validate オプションを使用して認証と MCP の構成を検証します。

dataverse mcp https://yourorg.crm.dynamics.com --validate

このオプションは、GA エンドポイントとプレビューエンドポイントをチェックし、認証が機能し、MCP サーバーが有効になっており、MCP CLI ツールが許可されたアプリケーションの一覧にあることを確認します。検証に失敗した場合、完了する前提条件のステップが出力によって識別されます。

ログ記録を有効にする

問題が発生した場合は、ファイルログを有効にして詳細な診断情報をキャプチャします。

dataverse mcp https://yourorg.crm.dynamics.com --log-level Debug --log-file

ログファイルは、システムの一時ディレクトリに書き込まれます。正確な場所は、ログ記録の開始時に表示されます。

一般的な問題

プラットフォームに互換性のあるバイナリが見つかりません

CLI では、Windows (x64、Arm64)、macOS (x64、Arm64)、Linux (x64、Arm64) がサポートされています。他のプラットフォームは、事前構築済みのバイナリではサポートされていません。

認証エラー

Dataverse 環境にアクセスできるかどうかを確認します。
環境の URL が正しいことを確認します。
トークンキャッシュをクリアし、 auth create コマンドを使用して再認証します。

Claude Desktop での MCP 接続の問題

構成 JSON 構文が正しいことを確認します。
環境 URL にアクセス可能であることを確認します。
詳細なエラーメッセージをキャプチャする --log-file オプションを追加します。
構成を変更した後、Claude Desktop を再起動します。

こちらも参照ください

Dataverse CLI リファレンス

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-01