Yhteyden muodostaminen Dataverseen mallikontekstiprotokollan usein kysytyillä kysymyksissä

Tässä artikkelissa annetaan vastauksia usein kysyttyihin kysymyksiin Microsoft Dataversen käyttämisestä MCP-palvelimen kanssa.

En voi todentaa. Mikä nyt on ongelma?

Varmista, että Dataverse-ympäristön URL-osoite MCP-asiakaskoneessa on oikein. Siirry Power Appsiin, valitse oikea ympäristö ja valitse sitten Asetukset (rataskuvake) >Istunnon tiedot esiintymän URL-osoitteen vahvistamiseksi.

Varmista myös, että käyttämäsi MCP-asiakas on otettu käyttöön Power Platform -hallintakeskuksessa. Lisätietoja: Dataverse MCP -palvelimen määrittäminen ja hallinta ympäristölle

Mitkä MCP-työkalut ovat käytettävissä ja mitä he tekevät?

Dataverse MCP -palvelin tarjoaa työkaluja yleisiin tietotoimintoihin, kuten tietueiden kyselemiseen, rivien luomiseen ja päivittämiseen sekä taulukkorakenteet kuvaamiseen. Katso työkalujen ja kuvausten täydellinen luettelo artikkelista Yhteyden muodostaminen Dataverseen mallikontekstiprotokollan avulla.

Voinko rajoittaa sitä, mitkä taulukot tai tietueet ovat käytettävissä MCP-palvelimen kautta?

Kyllä. Dataverse MCP -palvelin noudattaa Dataverse-käyttöoikeusrooleja ja rivitason suojausta. Käyttäjät voivat käyttää vain taulukoita ja tietueita, jotka heidän käyttöoikeusroolinsa sallii. Muita MCP-kohtaisia käyttöoikeuksien valvontaa ei tarvita dataverse-vakiosuojauksen konfiguroinnin lisäksi.

Liittyykö Dataverse MCP -palvelimen käyttöön liittyviä kustannuksia?

15.12.2025 alkaen Dataverse MCP -työkaluja veloitetaan, kun Microsoft Copilot Studion ulkopuolella luodut tekoälyagentit käyttävät niitä. Jos sinulla on ehdot täyttäviä Dynamics 365 Premium -käyttöoikeuksia tai Microsoft 365 Copilot User Subscription License (USL) -käyttöoikeus, dynamics 365 -tietojen käytössä ei veloiteta. Lisätietoja laskutus hinnoista on kohdassa Yhteyden muodostaminen Dataverseen Model Context Protocolin avulla.

Voinko käyttää Dataverse MCP -palvelinta useissa ympäristöissä?

Kyllä. Kullakin Dataverse-ympäristöllä voi olla oma MCP-palvelimen määrityksensä. Voit muodostaa yhteyden useisiin ympäristöihin määrittämällä asiakkaaseen erilliset MCP-palvelinmerkinnät, joista jokainen osoittaa eri ympäristön URL-osoitteeseen.

Vinkki

Jos käytät Microsoft Copilot Studiota, voit käyttää MCP:n perehdyttämistoimintoa, joka yhdistää agenttisi Dataverse MCP -palvelimiin useissa ympäristöissä. Ohjattu toiminto ohjaa sinua palvelinmääritysten ja todentamisen asetusten läpi. Lisätietoja: Agentin yhdistäminen aiemmin luotuun MCP-palvelimeen

Mitä minun pitäisi tehdä, jos Dataverse MCP -työkalu palauttaa virheen?

Jos työkalu palauttaa virheen, yritä muotoilla kehote uudelleen ja lähettää se uudelleen. Kuvaile, mitä haluat tehdä, käyttämällä tarkempaa kieltä. Jos virhe jatkuu, varmista, että sinulla on asianmukaiset Dataverse-käyttöoikeudet toiminnolle, jota yrität tehdä.

Mitä -, describe_table- ja list_tables -fetchtyökaluille tapahtui?

Dataverse MCP -palvelimen työkalualue päivitetään. Edelliset describe_table-, list_tables- ja fetch -työkalut poistetaan, ja niiden toiminnot tarjoaa muut työkalut:

Poistettu työkalu Korvaaminen
describe_table describe
list_tables describe
fetch describe

Edellinen search Työkalu, joka hakuja Dataverse-tiedoista, search_datanimettiin uudelleen nimellä . Nykyinen search työkalu hakee Dataversen metatiedoista ja auttaa agentteja löytämään sopivia taulukoita ja sovelluksia.

Jos MCP-asiakas ylläpitää sallittuja tai hylkää luetteloita työkalun nimen mukaan, tarkista ja päivitä määrityksesi niin, että uudet työkalun nimet vastaavat suunniteltuja käyttöoikeuksiasi.

Katso työkalujen täydellinen luettelo kohdasta Yhdistä Dataverseen Model Context Protocol -protokollan avulla.

Miksi en näe työkalua search_data Dataverse MCP -palvelimessa?

Työkalu search_data on käytettävissä vain, kun Dataverse-haku on käytössä ympäristössäsi. Jos Dataverse-haku ei ole käytössä, search_data työkalu ei näy käytettävissä olevien MCP-työkalujen luettelossa. Ota Dataverse-haku käyttöön siirtymällä kohtaan Määritä ympäristön Dataverse-haku.

Miksi näen eri työkaluja /api/mcp- ja /api/mcp_preview-päätepisteissä?

Päätepiste /api/mcp tarjoaa yleisesti saatavilla olevan Joukon Dataverse MCP -työkaluja. Päätepiste /api/mcp_preview sisältää lisää esikatselutyökaluja, jotka arvioidaan ennen yleistä käytettävyyttä. Esikatselutyökalut saattavat muuttua tai ne voidaan poistaa ilman erillistä ilmoitusta. Järjestelmänvalvojan on otettava esikatselutoiminnot käyttöön Power Platform -hallintakeskuksessa, jotta hän voi käyttää esiversiotyökaluja. Lisätietoja: Esikatselutyökalujen ja tulevien ominaisuuksien käyttäminen Dataverse MCP -palvelimessa

Miten voin ottaa paikallisen välityspalvelimen virheenkorjauksen käyttöön?

Jos sinulla on ongelmia paikallisen välityspalvelimen kanssa (@microsoft/dataverse), voit ottaa virheenkorjauksen käyttöön ja saada yksityiskohtaiset tiedot vianmääritystä varten. Lisää - --log-level ja --log-file -argumentit välityspalvelinkomentoon:

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

Lokitiedosto kirjoitetaan järjestelmän tilapäishakemistoon. Oletussijainti määräytyy käyttöjärjestelmäsi mukaan:

Käyttöjärjestelmä Lokitiedoston sijainti
Windows C:\Users\<username>\AppData\Local\Temp\
Linux /tmp/
macOS Ympäristömuuttujan $TMPDIR määrittämä hakemisto, yleensä /var/folders/.../T/. Suorita echo $TMPDIR päätteessä löytääksesi tarkan polun.

Voit jakaa tuloslokitiedoston Microsoftille, kun avaat tukitapauksen, joka auttaa ongelman diagnosoimisessa.