Sie befinden sich hier:
Fehlerbehebung und Tipps für CRM Analytics MCP Server
Lösen Sie Verbindungs- und Berechtigungsprobleme und verwenden Sie Aufforderungen und Vorgehensweisen, mit denen AI-Clients CRM Analytics-Daten genauer abfragen können.
Erforderliche Editionen
| Verfügbar in Lightning Experience. |
| Verfügbar in CRM Analytics, das gegen Aufpreis in der Enterprise, Performance und Unlimited Edition erhältlich ist. |
Allgemeine Verbindungsprobleme
- Serververbindung schlägt fehl: Überprüfen Sie, ob der CRM Analytics-MCP-Server unter "Setup" unter "MCP-Server" aktiviert ist. Bestätigen Sie außerdem, dass Sie eine externe Client-Anwendung mit dem richtigen Rückmeldungs-URL erstellt haben. Bestätigen Sie dann, dass Sie sich bei der Organisation angemeldet haben, die diese Anwendung enthält, bevor Sie den OAuth-Flow gestartet haben.
- Es werden keine Tools angezeigt: Stellen Sie sicher, dass Ihr MCP-Client den richtigen Server-URL für Ihren Organisationstyp verwendet und dass jeder Benutzer OAuth mit seinen eigenen Salesforce-Anmeldeinformationen abgeschlossen hat. Der CRM Analytics-MCP-Server unterstützt keine Service-Account-Token.
- Produktionsorganisation: Der CRM Analytics-MCP-Server ist in Produktionsorganisationen sowie Sandbox- und Testorganisationen verfügbar. Verwenden Sie den Server-URL, der Ihrem Organisationstyp entspricht:
- Produktion:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox- oder Testorganisation:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- Produktion:
Daten- und Toolzugriff
Ihre MCP-Sitzung wird wie Sie ausgeführt. Da die Authentifizierung Ihre Salesforce-Anmeldeinformationen verwendet, werden bei jeder Anforderung die Feldebenensicherheit, die Objektebenensicherheit, die Zeilenebenensicherheit und Freigaberegeln berücksichtigt. Der AI-Client kann niemals Daten oder Vermögenswerte anzeigen, die Sie in CRM Analytics nicht sehen können.
- Fehlende Datensets, Dashboards oder Linsen: Wenn der Client meldet, dass ein Vermögenswert nicht verfügbar ist, oder ein
list_weniger Elemente zurückgibt als erwartet, fehlt Ihnen wahrscheinlich die Berechtigung für diesen Vermögenswert. Stellen Sie sicher, dass Sie über Zugriff auf die Anwendung oder den Vermögenswert verfügen und dass Ihr Berechtigungssatz CRM Analytics-Zugriff gewährt. - API-Obergrenzen: Aufrufe von MCP-Tools werden auf die Wave-API-Obergrenzen Ihrer Organisation angerechnet. Überprüfen Sie die Nutzung unter "Setup" unter "API-Nutzung".
Weitere Informationen finden Sie im Troubleshooting Guide.
Tipps für bessere Ergebnisse
- Beschreiben Sie das Ziel und nicht das Tool: Sagen Sie "Offene Opportunities nach Phase anzeigen" anstelle von "call list_datasets". Der AI-Client wählt die Tools aus.
- Verbessern der Abfragegenauigkeit mit Feldbeschreibungen: Durch das Hinzufügen von Feldbezeichnungen und Beschreibungen zu Ihren erweiterten Datenset-Metadaten (XMD) kann der AI-Client genauere SAQL generieren.
- Komplexe Abfragen eingrenzen: Für verschachtelte Gruppierungen, Verknüpfungen mit mehreren Datensets oder erweiterte SAQL-Funktionen können Folgeaufforderungen erforderlich sein, um das genaue Ergebnis zu erhalten.
Beispielaufforderungen
Verwenden Sie diese Eingabeaufforderungen in einer neuen Sitzung, um Vermögenswerte zu entdecken, das Schema zu untersuchen und Fragen zu Ihren Daten zu stellen.
| Benutzeraufforderung | Tool Called (Aufgerufenes Tool) | Zweck |
|---|---|---|
| Auf welche Analyseanwendungen kann ich zugreifen? | list_folders |
Gibt die Ordner (Anwendungen) zurück, die Ihre Dashboards, Datensets und Linsen enthalten. Verwenden Sie die Ergebnisse, um spätere Suchen einzugrenzen. |
| Auf welche CRM Analytics-Datensets kann ich jetzt zugreifen? | list_datasets |
Ruft Datensetnamen, Bezeichnungen und IDs ab, die in Ihrem Sicherheitskontext verfügbar sind. |
| Zeigen Sie mir alle Dashboards in meinem Ordner "Vertriebsanwendung" an. | list_dashboards |
Findet vorgefertigte Dashboards für eine bestimmte Anwendung oder Geschäftseinheit. |
| Listen Sie alle gespeicherten Erkundungen auf, die ich anzeigen darf. | list_lenses |
Erfasst ein Inventar der gespeicherten Linsen und der Datensets, auf die sie verweisen. |
| Geben Sie mir die vollständigen Metadaten für das Datenset "Executive Pipeline" (Führungspipeline). | get_dataset |
Gibt Datenset-Details zurück, einschließlich der aktuellen Versions-ID, die für die Abfrage erforderlich ist. |
| Welche genauen Felder, Dimensionen und Maßeinheiten befinden sich im Opportunity-Datenset? | get_xmd |
Stellt API-Feldnamen, Datentypen und Bezeichnungen bereit, damit der Client syntaktisch korrekte SAQL erstellen kann. |
| Was waren unsere Top 10 Accounts nach Umsatz im letzten Geschäftsjahr? | execute_query |
Untersucht das Datenset-Schema, generiert eine SAQL-Abfrage und gibt strukturierte Ergebnisse zurück. |
| Wie hoch war die Gesamtpipeline nach Region im letzten Quartal? | execute_query |
Führt die Gruppierung und Filterung mithilfe von SAQL durch. |
| Zeigen Sie mir die Mitarbeiterleistung im Vergleich zur Quote in diesem Monat an. | execute_query |
Führt eine Abfrage aus und gibt Zeilen- und Spaltenmetadaten als strukturierte JSON zurück. |
Beta-Feedback und -Support
Dieser Server ist als Beta-Version verfügbar. Ihr Feedback prägt die allgemein verfügbare Erfahrung.
- Geben Sie Feedback an Ihr Salesforce-Accountteam weiter oder senden Sie es in die Trailblazer Community-Gruppe für dieses Programm.
- Überprüfen Sie die Versionshinweise für jede Aktualisierung auf bekannte Probleme und Behelfslösungen.
- Wenden Sie sich bei technischen Problemen während der Einrichtung an den Salesforce-Support und verweisen Sie auf den CRM Analytics MCP-Server (Beta).
Konnten Sie Ihr Problem mithilfe dieses Artikels lösen?
Geben Sie uns Feedback, damit wir uns verbessern können.
