使用模型內容通訊協定連線到 Dataverse 常見問題集

本文提供有關將 Microsoft Dataverse 與模型內容通訊協定 (MCP) 伺服器搭配使用的常見問題解答。

我無法驗證。 問題是什麼?

請確認 MCP 用戶端設定中的 Dataverse 環境 URL 是否正確。 到 Power Apps,選擇正確的環境,然後選擇 設定 (齒輪圖示) >會話詳情 以確認你的實例網址。

另外,請確認你使用的 MCP 用戶端在 Power Platform 管理中心是否已啟用。 其他資訊: 設定和管理環境的 Dataverse MCP 伺服器

有哪些 MCP 工具可用?它們能做什麼?

Dataverse MCP 伺服器提供常見資料操作的工具,例如查詢記錄、建立與更新資料列,以及描述資料表結構。 欲查看完整工具與說明清單,請前往 「使用 Model Context 協定連接 Dataverse」。

我可以限制哪些資料表或紀錄可以透過 MCP 伺服器存取嗎?

是。 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 with Model Context Protocol」。

我可以在多個環境下使用 Dataverse MCP 伺服器嗎?

是。 每個 Dataverse 環境都可以有自己的 MCP 伺服器配置。 你可以透過在客戶端設定不同的 MCP 伺服器條目,每個指向不同的環境 URL,連接到多個環境。

提示

如果你使用 Microsoft Copilot Studio,可以使用 MCP 入門精靈,將你的代理程式連接到跨多個環境的 Dataverse MCP 伺服器。 精靈會引導你完成伺服器設定和認證設定。 更多資訊:將您的 代理連接到現有的 MCP 伺服器

如果 Dataverse 的 MCP 工具回傳錯誤,我該怎麼辦?

如果工具回傳錯誤,試著重新表述你的提示並重新提交。 用更具體的語言來描述你想達成的目標。 如果錯誤仍然存在,請確認您是否具備執行該操作所需的 Dataverse 權限。

describe_table、list_tables 和 fetch 工具怎麼了?

Dataverse MCP 伺服器工具表面已更新。 前述describe_tablelist_tables、、fetch及工具被移除,其功能由其他工具提供:

已移除的工具 Replacement
describe_table describe
list_tables describe
fetch describe

先前 search 用於搜尋 Dataverse 資料的工具已改名為 search_data。 目前 search 的工具會搜尋 Dataverse 的元資料,幫助客服人員找到相關的資料表和應用程式。

如果你的 MCP 客戶端依工具名稱維持允許或拒絕清單,請檢視並更新你的設定,讓新工具名稱反映你預期的權限。

欲了解完整工具清單,請前往 「使用 Model Context Protocol 連接 Dataverse」。

為什麼我在 Dataverse MCP 伺服器上看不到這個 search_data 工具?

search_data此工具僅在啟用 Dataverse 搜尋後才可用。 如果 Dataverse 搜尋未開啟,該 search_data 工具就不會出現在可用的 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 參數加入至代理指令中:

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

日誌檔案會寫入系統暫存目錄。 預設位置取決於你的作業系統:

作業系統 日誌檔案位置
Windows C:\Users\<username>\AppData\Local\Temp\
Linux /tmp/
macOS 由環境變數指定的 $TMPDIR 目錄,通常是 /var/folders/.../T/。 在終端機中執行 echo $TMPDIR 以找到精確的路徑。

你可以在開啟支援事件時,將輸出日誌檔案分享給 Microsoft,幫助診斷問題。