Du er her:
Feilsøking og tips for CRM Analytics MCP Server
Løs tilkoblings- og tillatelsesproblemer, og bruk ledetekster og fremgangsmåter som hjelper AI-klienter med å spørre CRM Analytics-data mer nøyaktig.
Nødvendige utgaver
| Tilgjengelig i Lightning Experience |
| Tilgjengelig med CRM Analytics, som er tilgjengelig for en ekstra kostnad i Enterprise, Performance og Unlimited Edition. |
Generelle tilkoblingsproblemer
- Servertilkobling mislykkes: Kontroller at CRM Analytics-MCP-serveren er aktivert under MCP-servere under Oppsett. Kontroller også at du har opprettet en ekstern klientapp med riktig URL-adresse for tilbakekall. Kontroller deretter at du har logget deg på organisasjonen som inneholder denne appen, før du startet OAuth-flyten.
- Ingen verktøy vises: Kontroller at MCP-klienten bruker den riktige server-URL-adressen for organisasjonstypen, og at hver bruker har fullført OAuth med sin egen Salesforce-legitimasjon. CRM Analytics MCP-server støtter ikke tjenestekontotokener.
- Produksjonsorganisasjon: CRM Analytics MCP-server er tilgjengelig i produksjonsorganisasjoner i tillegg til Sandbox- og midlertidige organisasjoner. Bruk URL-adressen til serveren som samsvarer med organisasjonstypen din:
- Produksjon:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox- eller midlertidig organisasjon:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- Produksjon:
Tilgang til data og verktøy
MCP-økten kjører som deg. Fordi godkjenning bruker Salesforce-legitimasjonen din, respekterer hver forespørsel feltnivåsikkerhet (FLS), objektnivåsikkerhet (OLS), radnivåsikkerhet (RLS) og delingsregler. AI-klienten kan aldri se data eller aktiva som du ikke kan se i CRM Analytics.
- Datasett, kontrollpaneler eller linser mangler: Hvis klienten rapporterer at et aktivum ikke er tilgjengelig, eller en
list_returnerer færre elementer enn forventet, mangler du sannsynligvis tillatelse til det aktivumet. Kontroller at du har tilgang til appen eller aktivumet og at tillatelsessettet gir CRM Analytics-tilgang. - API-grenser: MCP-verktøykall teller mot organisasjonens Wave API-grenser. Kontroller bruk under API-bruk i Oppsett.
Se feilsøkingsveiledningen for å få mer informasjon.
Tips for bedre resultater
- Beskriv målet, ikke verktøyet: La oss si "Vis meg åpne salgsmuligheter etter fase" i stedet for "kall list_datasets". AI-klienten velger verktøyene.
- Forbedre spørringsnøyaktigheten med feltbeskrivelser: Å legge til feltetiketter og -beskrivelser i de utvidede metadataene (XMD) i datasettet hjelper AI-klienten med å generere mer nøyaktig SAQL.
- Forbedre komplekse spørringer: Nestede grupperinger, flersettskoblinger eller avanserte SAQL-funksjoner kan kreve oppfølgingsmeldinger for å få det eksakte resultatet.
Eksempel på ledetekster
Bruk disse meldingene i en ny økt til å oppdage aktiva, inspisere skjemaer og stille spørsmål om dataene dine.
| Brukermelding | Verktøy kalt opp | Formål |
|---|---|---|
| Hvilke analyseprogrammer har jeg tilgang til? | list_folders |
Returnerer mappene (appene) som inneholder kontrollpanelene, datasettene og linsene. Bruk resultatet til å omfatte senere søk. |
| Hvilke CRM Analytics-datasett har jeg tilgang til akkurat nå? | list_datasets |
Henter datasettnavn, -etiketter og -IDer som er tilgjengelig i sikkerhetskonteksten. |
| Vis meg alle kontrollpanelene i salgsprogrammappen min. | list_dashboards |
Finner forhåndsbygde kontrollpaneler for en bestemt app eller forretningsenhet. |
| Vise en liste over alle lagrede utforskinger jeg har tillatelse til å vise. | list_lenses |
Samler inn en oversikt over lagrede linser og datasettene de refererer til. |
| Gi meg alle metadataene for Executive Pipeline-datasettet. | get_dataset |
Returnerer datasettdetaljer, inkludert den gjeldende versjons-IDen som er nødvendig for å spørre den. |
| Hva er de eksakte feltene, dimensjonene og målingene i Salgsmulighet-datasettet? | get_xmd |
Gir felt-API-navn, datatyper og etiketter slik at klienten kan bygge syntaksmessig riktig SAQL. |
| Hva var de 10 beste kontoene etter omsetning forrige regnskapsår? | execute_query |
Inspiserer datasettskjemaet, genererer en SAQL-spørring og returnerer strukturerte resultater. |
| Hva var totalt under arbeid etter region forrige kvartal? | execute_query |
Utfører gruppering og filtrering med SAQL. |
| Vis meg representantenes resultater kontra kvote denne måneden. | execute_query |
Kjører en spørring og returnerer rad- og kolonnemetadata som strukturert JSON. |
Beta-tilbakemelding og støtte
Denne serveren er tilgjengelig som en betautgivelse. Tilbakemeldingene dine former den generelt tilgjengelige (GA)-opplevelsen.
- Del tilbakemeldinger med Salesforce-kontoteamet ditt, eller send dem i Trailblazer Community-gruppen for dette programmet.
- Sjekk utgivelsesmerknadene for hver oppdatering for kjente problemer og løsninger.
- Kontakt Salesforces kundestøtte for tekniske problemer under oppsettet, og referer til CRM Analytics MCP-server (beta).
Hjalp denne artikkelen med å løse problemet ditt?
La oss få vite det slik at vi kan forbedre!
