この記事では、モデル コンテキスト プロトコル (MCP) サーバーでの Microsoft Dataverse の使用に関してよく寄せられる質問への回答を示します。
認証できません。 問題は何ですか?
MCP クライアント構成の Dataverse 環境 URL が正しいことを確認します。 Power Apps に移動し、適切な環境を選択し、設定 (歯車アイコン) >Session の詳細を選択してインスタンスの URL を確認します。
また、使用している MCP クライアントが Power Platform 管理センターで有効になっていることを確認します。 詳細情報: 環境用の Dataverse MCP サーバーの構成と管理
使用できる MCP ツールと実行内容
Dataverse MCP サーバーには、レコードのクエリ、行の作成と更新、テーブル スキーマの記述、テーブルの一覧表示などの一般的なデータ操作用のツールが用意されています。 ツールと説明の完全な一覧については、「 モデル コンテキスト プロトコルを使用して Dataverse に接続する」を参照してください。
MCP サーバーを介してアクセスできるテーブルまたはレコードを制限できますか?
Yes. Dataverse MCP サーバーは、Dataverse セキュリティ ロールと行レベルのセキュリティを尊重します。 ユーザーは、セキュリティ ロールで許可されているテーブルとレコードにのみアクセスできます。 標準の Dataverse セキュリティ構成を超えて、追加の MCP 固有のアクセス制御は必要ありません。
Dataverse MCP サーバーの使用に関連するコストはありますか?
2025 年 12 月 15 日より、Dataverse MCP ツールは、Microsoft Copilot Studio の外部で作成された AI エージェントによってアクセスされると課金されます。 Dynamics 365 Premium ライセンスまたは Microsoft 365 Copilot ユーザー サブスクリプション ライセンス (USL) を対象とする場合、Dynamics 365 データへのアクセスに対して課金されることはありません。 課金料金の詳細については、「 モデル コンテキスト プロトコルを使用して Dataverse に接続する」を参照してください。
Dataverse MCP サーバーを複数の環境で使用できますか?
Yes. 各 Dataverse 環境は、独自の MCP サーバー構成を持つことができます。 クライアントで個別の MCP サーバー エントリを構成し、それぞれ異なる環境 URL を指すことで、複数の環境に接続できます。
ヒント
Microsoft Copilot Studio を使用する場合は、MCP オンボード ウィザードを使用して、複数の環境にわたってエージェントを Dataverse MCP サーバーに接続できます。 ウィザードでは、サーバーの構成と認証のセットアップについて説明します。 詳細情報: エージェントを既存の MCP サーバーに接続する
Dataverse MCP ツールでエラーが返された場合はどうすればよいですか?
ツールからエラーが返された場合は、プロンプトの言い換えと再送信を試みます。 より具体的な言語を使用して、達成する内容を説明します。 エラーが解決しない場合は、試行している操作に適切な Dataverse アクセス許可があることを確認します。
Dataverse MCP サーバーに検索ツールが表示されないのはなぜですか?
検索ツールは、お使いの環境で Dataverse 検索が有効になっている場合にのみ使用できます。 Dataverse 検索が有効になっていない場合、使用可能な MCP ツールの一覧に検索ツールは表示されません。 Dataverse 検索を有効にするには、「 環境の Dataverse 検索を構成する」に移動します。
/api/mcp エンドポイントと /api/mcp_preview エンドポイントにさまざまなツールが表示されるのはなぜですか?
/api/mcp エンドポイントには Dataverse MCP ツールの一般提供セットが用意されていますが、/api/mcp_preview エンドポイントには、一般公開前に評価される追加のプレビュー ツールが含まれています。 プレビュー ツールは、予告なしに変更または削除される場合があります。 プレビュー ツールにアクセスするには、管理者が Power Platform 管理センターでプレビュー機能の設定を有効にする必要があります。 詳細情報: Dataverse MCP サーバーでプレビュー ツールと今後の機能を使用する
ローカル プロキシのデバッグ ログを有効にする方法
ローカル プロキシ (@microsoft/dataverse) で問題が発生した場合は、デバッグ ログを有効にして、トラブルシューティングのために詳細な出力をキャプチャできます。
--log-level引数と--log-file引数を proxy コマンドに追加します。
npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com --log-level Debug --log-file
ログ ファイルはシステム一時ディレクトリに書き込まれます。 既定の場所は、オペレーティング システムによって異なります。
| オペレーティング システム | ログ ファイルの場所 |
|---|---|
| ウィンドウズ | C:\Users\<username>\AppData\Local\Temp\ |
| リナックス | /tmp/ |
| macOS |
$TMPDIR環境変数で指定されるディレクトリ 。通常は/var/folders/.../T/。 ターミナルで echo $TMPDIR を実行して、正確なパスを見つけます。 |
問題の診断に役立つサポート インシデントを開くときに、出力ログ ファイルを Microsoft と共有できます。