Sambung ke Dataverse dengan protokol konteks model Soalan Lazim

Artikel ini menyediakan jawapan kepada soalan lazim tentang menggunakan Microsoft Dataverse dengan pelayan protokol konteks model (MCP).

Saya tidak boleh mengesahkan. Apa masalahnya?

Sahkan bahawa URL persekitaran Dataverse dalam konfigurasi klien MCP anda adalah betul. Pergi ke Power Apps, pilih persekitaran yang betul dan kemudian pilih Tetapan (ikon gear) >Butiran sesi untuk mengesahkan URL tika anda.

Sahkan juga bahawa klien MCP yang anda gunakan didayakan dalam pusat pentadbiran Power Platform. Maklumat lanjut: Mengkonfigurasi dan mengurus pelayan Dataverse MCP untuk persekitaran

Alat MCP manakah yang tersedia dan apa yang mereka lakukan?

Pelayan Dataverse MCP menyediakan alat untuk operasi data biasa seperti menanyakan rekod, mencipta dan mengemas kini baris dan menerangkan skema jadual. Untuk senarai penuh alatan dan perihalan, pergi ke Sambung ke Dataverse dengan Protokol Konteks Model.

Bolehkah saya menyekat jadual atau rekod yang boleh diakses melalui pelayan MCP?

Ya. Pelayan MCP Dataverse menghormati peranan keselamatan Dataverse dan keselamatan peringkat baris. Pengguna hanya boleh mengakses jadual dan rekod yang dibenarkan oleh peranan keselamatan mereka. Tiada kawalan akses khusus MCP tambahan diperlukan di luar konfigurasi keselamatan Dataverse standard.

Adakah terdapat kos yang berkaitan dengan penggunaan pelayan MCP Dataverse?

Mulai 15 Disember 2025, alatan MCP Dataverse dicaj apabila diakses oleh ejen AI yang dicipta di luar Microsoft Copilot Studio. Jika anda mempunyai lesen Dynamics 365 Premium yang layak atau Lesen Langganan Pengguna (USL) Microsoft 365 Copilot, anda tidak dicaj untuk mengakses data Dynamics 365. Untuk mendapatkan maklumat tentang kadar pengebilan, pergi ke Sambung ke Dataverse dengan Protokol Konteks Model.

Bolehkah saya menggunakan pelayan Dataverse MCP dengan berbilang persekitaran?

Ya. Setiap persekitaran Dataverse boleh mempunyai konfigurasi pelayan MCP sendiri. Anda boleh menyambung ke berbilang persekitaran dengan mengkonfigurasi entri pelayan MCP yang berasingan dalam klien anda, setiap satu menunjuk ke URL persekitaran yang berbeza.

Tip

Jika anda menggunakan Microsoft Copilot Studio, anda boleh menggunakan bestari onboarding MCP untuk menyambungkan ejen anda ke pelayan Dataverse MCP merentasi berbilang persekitaran. Wizard membimbing anda melalui konfigurasi pelayan dan persediaan pengesahan. Maklumat lanjut: Sambungkan ejen anda ke pelayan MCP sedia ada

Apakah yang perlu saya lakukan jika alat Dataverse MCP mengembalikan ralat?

Jika alat mengembalikan ralat, cuba ungkapkan semula gesaan anda dan serahkannya sekali lagi. Gunakan bahasa yang lebih khusus untuk menerangkan perkara yang anda mahu capai. Jika ralat berterusan, sahkan bahawa anda mempunyai keizinan Dataverse yang sesuai untuk operasi yang anda cuba.

Apa yang berlaku kepada describe_table, list_tables, dan fetch alat?

Permukaan alat pelayan MCP Dataverse dikemas kini. Alat , list_tablesdan fetch sebelumnya describe_tabledialih keluar dan fungsinya disediakan oleh alat lain:

Alat yang dialih keluar	Penggantian
describe_table	describe
list_tables	describe
fetch	describe

Alat sebelumnya search yang mencari data Dataverse telah dinamakan semula kepada search_data. Alat semasa search mencari metadata Dataverse untuk membantu ejen mencari jadual dan apl yang berkaitan.

Jika klien MCP anda mengekalkan membenarkan atau menolak senarai mengikut nama alat, semak dan kemas kini konfigurasi anda supaya nama alat baharu mencerminkan keizinan yang anda maksudkan.

Untuk senarai penuh alatan, pergi ke Sambung ke Dataverse dengan Protokol Konteks Model.

Mengapakah saya tidak melihat alat dalam search_data pelayan MCP Dataverse?

Alat ini search_data hanya tersedia apabila carian Dataverse didayakan untuk persekitaran anda. Jika carian Dataverse tidak dihidupkan, alat ini search_data tidak muncul dalam senarai alatan MCP yang tersedia. Untuk mendayakan carian Dataverse, pergi ke Konfigurasikan carian Dataverse untuk persekitaran anda.

Mengapakah saya melihat alat yang berbeza pada titik akhir /api/mcp dan /api/mcp_preview?

/api/mcp Titik akhir menyediakan set alat MCP Dataverse yang tersedia umum. /api/mcp_preview Titik akhir termasuk alat pratonton tambahan yang dinilai sebelum ketersediaan umum. Alat pratonton mungkin berubah atau dialih keluar tanpa notis. Untuk mengakses alat pratonton, pentadbir mesti mendayakan seting ciri pratonton dalam pusat pentadbiran Power Platform. Maklumat lanjut: Gunakan alat pratonton dan ciri akan datang dalam pelayan MCP Dataverse

Bagaimanakah cara saya mendayakan pengelogan nyahpepijat untuk proksi tempatan?

Jika anda mengalami masalah dengan proksi tempatan (@microsoft/dataverse), anda boleh mendayakan pengelogan nyahpepijat untuk menangkap output terperinci untuk penyelesaian masalah. Tambah --log-level dan --log-file argumen pada arahan proksi:

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

Fail log ditulis ke direktori sementara sistem. Lokasi lalai bergantung pada sistem pengendalian anda:

Sistem pengendalian	Lokasi fail log
Windows	C:\Users\<username>\AppData\Local\Temp\
Linux	/tmp/
macOS	Direktori yang ditentukan oleh $TMPDIR pembolehubah persekitaran, biasanya /var/folders/.../T/. Jalankan echo $TMPDIR di terminal untuk mencari laluan yang tepat.

Anda boleh berkongsi fail log output dengan Microsoft apabila membuka insiden sokongan untuk membantu mendiagnosis isu tersebut.