MCP Dataverse

Microsoft Dataverse 用の最も包括的な MCP サーバーです。

79 個のツール · 4 個のリソース · 10 個のガイド付きワークフロー · 3 つの認証モード

npm npm downloads Node 20+ TypeScript License: MIT

なぜ MCP Dataverse なのか？

AI エージェントはスキーマをハルシネーション（幻覚）したり、列名を推測したりして、壊れた OData クエリを構築することがあります。このサーバーは、Model Context Protocol を通じて、Dataverse 環境（スキーマ、レコード、メタデータ、ソリューション）へのリアルタイムアクセスを提供します。

3 つの認証モード — デバイスコード（ローカル）、クライアント資格情報（CI/CD）、マネージド ID（Azure ホスト）
あらゆる MCP クライアントで動作 — VS Code、Claude、Cursor、Windsurf、Gemini、Codex CLI
アトミックなツール — 各ツールは単一の機能を適切に実行し、AI が適切なツールを選択します
構造化された出力 — すべてのレスポンスが {summary, data, suggestions} を返します
ガードレール — 破壊的な操作には明示的な確認が必要です
暗号化されたトークン — AES-256-GCM でキャッシュされた資格情報は、ログに記録されることはありません

インストール

npx mcp-dataverse install

対話型ウィザードが環境を構成し、VS Code にサーバーを登録し、2 分以内に Microsoft アカウントを認証します。

Node.js 20+ が必要です。その他のクライアント（Claude、Cursor、Windsurf など）については、マルチクライアントセットアップを参照してください。

認証

サーバーの実行場所に基づいて、3 つのモードから選択します：

モード	使用タイミング
デバイスコード (デフォルト)	ローカル開発 — 対話型 Microsoft ログイン、トークンはディスクにキャッシュ
クライアント資格情報	無人実行: CI/CD、Docker、Azure サービス — `authMethod: "client-credentials"` + アプリ登録
マネージド ID	Azure ホスト (App Service, Container Apps) — シークレット不要、`authMethod: "managed-identity"`

デバイスコードのクイックスタート: 最初のツール呼び出し時に認証がトリガーされます。

View → Output → MCP を開くと、サインインコードが表示されます
https://microsoft.com/devicelogin にアクセスし、コードを入力して職場アカウントでサインインします
トークンは暗号化されてキャッシュされるため、次回以降の起動は自動的に行われます

クライアント資格情報およびマネージド ID の設定については、認証ドキュメントを参照してください。

機能

カテゴリ	数	説明
メタデータ	9	テーブル、スキーマ、リレーションシップ、オプションセット、エンティティキー
クエリ	3	OData、FetchXML、ページネーション付き取得
CRUD	6	取得、作成、更新、削除、アップサート、割り当て
リレーション	4	関連付け、一括関連付け、関連付け解除、関連付けクエリ
アクションと関数	6	バインド/アンバインドされた Dataverse アクションおよび関数
バッチ	1	最大 1000 件の操作をアトミックに実行
ソリューション	2	カスタマイズの公開、サイトマップの作成
検索	1	全文関連性検索
ユーザーとチーム	4	ユーザー、ロール、チーム、ロール割り当て
RBAC	7	ロール権限: 一覧表示、割り当て、削除、追加、置換、取得、チーム
ファイル	2	ファイルおよび画像列のアップロード/ダウンロード
監査とトレース	3	監査ログ、プラグイントレースログ、ワークフロートレースログ
注釈	2	メモおよびファイル添付
カスタマイズ	4	カスタムアクション、プラグイン、環境変数、接続参照
属性	4	列の作成、更新、削除; ルックアップ列の型
スキーマ (書き込み)	2	カスタムテーブルとリレーションシップの作成
レコードアクセス	4	レコード共有の確認、付与、取り消し; レコードのマージ
支援	2	ツールルーター、ツールタグ
+ その他	…	デルタ同期、なりすまし、ビュー、ビジネスユニット、重複検出

→ 完全な機能リファレンス

HTTP トランスポート

マルチクライアント使用のために HTTP サーバーとして実行します：

MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js

VS Code / Copilot で接続するには以下を使用します：

{
  "servers": {
    "dataverse": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer mysecret"
      }
    }
  }
}

トラブルシューティング

症状	修正方法
サインインプロンプトが表示されない	View → Output → MCP を開くと、デバイスコードがそこに表示されます
`No MSAL accounts found`	`npx mcp-dataverse-auth` を実行してからサーバーを再起動してください
`Authentication timed out`	MCP サーバーを再起動してください — 新しいコードが自動的に生成されます
エージェントモードでサーバーが表示されない	`npx mcp-dataverse install` または `npx mcp-dataverse doctor` を実行してください
HTTP エラー	`npx mcp-dataverse doctor` を実行して設定と接続を診断してください

パフォーマンスのヒント

MCP Dataverse は包括的になるように設計されていますが、ほとんどの AI モデルはコンテキスト内のツールが少ないほど最適に動作します。エージェントの集中力と応答性を維持するために、クライアントのツールピッカー（VS Code チャットパネルなど）で不要なツールの選択を解除してください。

ロードマップ

バージョン	機能	ステータス
v0.4	HTTP トランスポート + 属性管理 + スキーマ整合性	✅ リリース済み
v0.5	エンタープライズ認証 (クライアント資格情報、マネージド ID、Entra JWT)	✅ リリース済み
v0.6	MCP プロンプト (5 テンプレート) + MCP リソース (4)	✅ リリース済み
v0.7	スキーマ書き込み (テーブル/リレーション作成) + レコードアクセス (共有、マージ)	✅ リリース済み (v0.7.5)

→ 完全なロードマップ

MCP Dataverse

MCP Dataverse

なぜ MCP Dataverse なのか？

インストール

認証

機能

HTTP トランスポート

トラブルシューティング

パフォーマンスのヒント

ロードマップ

ライセンス

Resources

Latest Blog Posts

MCP directory API