Du är här:
Felsökning och tips för CRM Analytics MCP-server
Lös anslutnings- och behörighetsproblem och använd uppmaningar och metoder som hjälper AI-klienter fråga CRM Analytics-data mer korrekt.
Versioner som krävs
| Finns i Lightning Experience. |
| Tillgängligt med CRM Analytics som finns mot en tilläggskostnad i versionerna Enterprise, Performance och Unlimited. |
Allmänna anslutningsproblem
- Serveranslutning misslyckas: Bekräfta att CRM Analytics MCP-server är på i Inställningar under MCP-servrar. Bekräfta även att du har skapat en extern klientapp med rätt callback-URL. Bekräfta sedan att du loggade in i organisationen som innehåller appen innan du startade OAuth-flödet.
- Inga verktyg visas: Bekräfta att din MCP-klient använder rätt server-URL för din organisationstyp och att varje användare har slutfört OAuth med sina egna Salesforce-inloggningsuppgifter. CRM Analytics MCP-server har inte stöd för servicekontotokens.
- Produktionsorganisation: CRM Analytics MCP-server är tillgänglig i produktionsorganisationer samt sandbox- och skissorganisationer. Använd den server-URL som matchar din organisationstyp:
- Produktion:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox- eller skissorganisation:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- Produktion:
Data- och verktygsåtkomst
Din MCP-session körs som du. Eftersom autentisering använder dina Salesforce-inloggningsuppgifter respekterar varje begäran fältnivåsäkerhet (FLS), objektnivåsäkerhet (OLS), radnivåsäkerhet (RLS) och delningsregler. AI-klienten kan aldrig se data eller tillgångar som du inte kan se i CRM Analytics.
- Datauppsättningar, instrumentpaneler eller linser som saknas: Om klienten rapporterar att en tillgång inte är tillgänglig, eller om ett
list_returnerar färre objekt än du förväntar dig, saknar du troligen behörighet till tillgången. Bekräfta att du har åtkomst till appen eller tillgången och att din behörighetsuppsättning beviljar CRM Analytics-åtkomst. - API-gränser: MCP-verktygsanrop räknas mot din organisations Wave API-gränser. Kontrollera användning i Inställningar under API-användning.
Mer information finns i Felsökningsguiden.
Tips för bättre resultat
- Beskriv målet, inte verktyget: Säg "Visa mig öppna säljprojekt efter fas" istället för "ring list_datauppsättningar". AI-klienten väljer verktygen.
- Förbättra sökfrågeprecisionen med fältbeskrivningar: Att lägga till fältetiketter och beskrivningar i din datauppsättnings utökade metadata (XMD) hjälper AI-klienten att skapa mer korrekt SAQL.
- Förfina komplexa sökfrågor: Kapslade grupperingar, sammanslagningar av flera datauppsättningar eller avancerade SAQL-funktioner kan kräva uppföljningsuppmaningar för att få det exakta resultatet.
Exempel på uppmaningar
Använd dessa uppmaningar i en ny session för att upptäcka tillgångar, inspektera scheman och ställa frågor om dina data.
| Användaruppmaning | Verktyg anropat | Syfte |
|---|---|---|
| Vilka Analytics-appar har jag åtkomst till? | list_folders |
Returnerar de mappar (appar) som innehåller dina instrumentpaneler, datauppsättningar och linser. Använd resultaten för att utöka senare sökningar. |
| Vilka CRM Analytics-datauppsättningar har jag åtkomst till just nu? | list_datasets |
Hämtar namn, etiketter och ID:n för datauppsättningar som är tillgängliga i ditt säkerhetssammanhang. |
| Visa mig alla instrumentpaneler i min mapp Säljprogram. | list_dashboards |
Hittar färdigbyggda instrumentpaneler för en specifik app eller affärsenhet. |
| Lista alla sparade utforskningar jag har behörighet att se. | list_lenses |
Samlar in ett lager av sparade linser och de datauppsättningar de refererar till. |
| Ge mig fullständiga metadata för datauppsättningen Chefspipeline. | get_dataset |
Returnerar datauppsättningsdetaljer, inklusive det aktuella versions-ID som behövs för att fråga den. |
| Vilka är de exakta fälten, dimensionerna och måtten i datauppsättningen Säljprojekt? | get_xmd |
Ger fältens API-namn, datatyper och etiketter så att klienten kan bygga syntaktiskt korrekt SAQL. |
| Vilka var våra 10 bästa konton efter intäkter förra räkenskapsåret? | execute_query |
Inspekterar datauppsättningsschemat, skapar en SAQL-fråga och returnerar strukturerade resultat. |
| Vad var den totala pipelinen efter region förra kvartalet? | execute_query |
Utför gruppering och filtrering med SAQL. |
| Visa mig säljares resultat jämfört med säljmål denna månad. | execute_query |
Kör en sökfråga och returnerar rader och kolumnmetadata som strukturerad JSON. |
Feedback och support för beta
Denna server är tillgänglig som en betautgåva. Din feedback formar den allmänt tillgängliga (GA) upplevelsen.
- Dela feedback med ditt Salesforce-kontoteam eller skicka in den i Trailblazer Community-gruppen för detta program.
- Kontrollera versionsinformationen för varje uppdatering för kända problem och lösningar.
- Kontakta Salesforces support för tekniska problem under konfigurationen och referera till CRM Analytics MCP-server (beta).
Löste denna artikel ditt problem?
Berätta för oss vad vi kan förbättra!
