Dataverse'iga ühenduse loomine mudeli kontekstiprotokolli KKK

See artikkel annab vastused korduma kippuvatele küsimustele Microsoft Dataverse'i kasutamise kohta mudeli kontekstiprotokolli (MCP) serveriga.

Ma ei saa autentida. Milles on probleem?

Veendu, et Dataverse'i keskkonna URL sinu MCP kliendi konfiguratsioonis on õige. Mine Power Apps'i, vali õige keskkond ja seejärel vali Seaded (hammasratta ikoon) >Sessiooni andmed , et kinnitada oma instantsi URL.

Kontrolli ka, et MCP klient, mida kasutad, oleks Power Platformi halduskeskuses lubatud. Lisateave: Dataverse MCP-serveri konfigureerimine ja haldamine keskkonna jaoks

Millised MCP tööriistad on saadaval ja mida need teevad?

Dataverse'i MCP server pakub tööriistu tavapärasteks andmetoiminguteks, nagu kirjete pärimine, ridade loomine ja uuendamine ning tabeliskeemide kirjeldamine. Täieliku tööriistade ja kirjelduste nimekirja leiate jaotisest Ühendu Dataverse'iga mudeli konteksti protokolliga.

Kas ma saan piirata, millised tabelid või kirjed on MCP serveri kaudu kättesaadavad?

Jah. Dataverse'i MCP server austab Dataverse'i turvarolle ja ridade tasandi turvalisust. Kasutajad pääsevad ligi ainult tabelitele ja kirjetele, mida nende turvaroll lubab. Lisaks standardsele Dataverse'i turvakonfiguratsioonile pole vaja täiendavaid MCP-spetsiifilisi juurdepääsukontrolle.

Kas Dataverse MCP serveri kasutamisel on kulud?

Alates 15. detsembrist 2025 võetakse Dataverse'i MCP tööriistu tasu siis, kui neid kasutavad Microsoft Copilot Studio väliselt loodud tehisintellekti agendid. Kui sul on kvalifitseeruvad Dynamics 365 Premium litsentsid või Microsoft 365 Copilot User Subscription License (USL), siis Dynamics 365 andmete kasutamise eest sa ei tasuta. Arveldusmäärade kohta lisateabe saamiseks mine lehele Connect to Dataverse with Model Context Protocol.

Kas ma saan kasutada Dataverse MCP serverit mitme keskkonnaga?

Jah. Igal Dataverse'i keskkonnal võib olla oma MCP serveri konfiguratsioon. Saad ühendada mitme keskkonnaga, seadistades oma kliendis eraldi MCP serveri kirjeid, millest igaüks osutab erinevale keskkonna URL-ile.

Näpunäide

Kui kasutad Microsoft Copilot Studiot, saad kasutada MCP onboarding wizard'i, et ühendada oma agent Dataverse'i MCP serveritega mitmes keskkonnas. Viisard juhendab sind serveri seadistamise ja autentimise seadistamisel. Lisainfo: Ühenda oma agent olemasoleva MCP serveriga

Mida peaksin tegema, kui Dataverse'i MCP tööriist tagastab vea?

Kui tööriist tagastab vea, proovi oma prompt ümber sõnastada ja see uuesti esitada. Kasuta täpsemat keelt, et kirjeldada, mida soovid saavutada. Kui viga püsib, kontrolli, et sul on vajalikud Dataverse'i õigused selle operatsiooni jaoks, mida proovid.

Mis juhtus describe_table, list_tables, ja fetch tööriistadega?

Dataverse'i MCP serveri tööriistapind on uuendatud. Eelmine describe_table, list_tables, ja fetch tööriistad eemaldatakse ning nende funktsionaalsus tagatakse teiste tööriistadega:

Eemaldatud tööriist	Asendamine
describe_table	describe
list_tables	describe
fetch	describe

Eelmine search tööriist, mis otsis Dataverse'i andmeid, nimetati ümber .search_data Praegune search tööriist otsib Dataverse'i metaandmeid, et aidata agentidel leida asjakohaseid tabeleid ja rakendusi.

Kui teie MCP klient haldab lubamis- või keeldumisnimekirju tööriista nime järgi, vaadake üle ja uuendage oma konfiguratsiooni, et uued tööriistanimed vastaksid teie soovitud õigustele.

Täieliku tööriistade nimekirja leiate jaotisest Ühendu Dataverse'iga mudeli konteksti protokolliga.

Miks ma ei näe search_data tööriista Dataverse MCP serveris?

Tööriist search_data on saadaval ainult siis, kui Dataverse'i otsing on sinu keskkonnas lubatud. Kui Dataverse'i otsing pole sisse lülitatud, search_data ei ilmu tööriist MCP tööriistade nimekirja. Dataverse'i otsingu lubamiseks mine oma keskkonna jaoks Seadista Dataverse'i otsing.

Miks näen erinevaid tööriistu /api/mcp ja /api/mcp_preview lõpp-punktides?

Lõpp-punkt /api/mcp pakub üldist Dataverse'i MCP tööriistade komplekti. Lõpp-punkt /api/mcp_preview sisaldab täiendavaid eelvaatetööriistu, mida hinnatakse enne üldist kättesaadavust. Eelvaatetööriistad võivad muutuda või eemaldada ilma ette teatamata. Eelvaatetööriistadele juurdepääsuks peab administraator Power Platformi halduskeskuses lubama eelvaate funktsioonide seadistuse. Lisainfo: Kasuta eelvaatetööriistu ja tulevasi funktsioone Dataverse MCP serveris

Kuidas ma saan lubada silumise logimise kohaliku proxy jaoks?

Kui sul esineb probleeme kohaliku proksiga (@microsoft/dataverse), saad lubada silumislogimise, et püüda detailset väljundit tõrkeotsinguks. Lisa --log-level ja --log-file argumendid proksikäsule:

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

Logifail kirjutatakse süsteemi ajutisse kataloogi. Vaikimisi asukoht sõltub sinu operatsioonisüsteemist:

Operatsioonisüsteem	Logifaili asukoht
Windows	C:\Users\<username>\AppData\Local\Temp\
Linux	/tmp/
macOS	Kataloog, mida määrab keskkonnamuutuja $TMPDIR , tavaliselt /var/folders/.../T/. Jookse echo $TMPDIR terminalis, et leida täpne tee.

Saad Microsoftiga väljundlogifaili jagada, kui avad tugijuhtumi, et aidata probleemi diagnoosida.