Sie befinden sich hier:
Referenz des CRM Analytics-MCP-Server-Tools
Schreibgeschützte Tools, mit denen MCP-kompatible AI-Clients Anwendungen entdecken, Schemas untersuchen, SAQL-Abfragen ausführen und Dashboard- und Linsenmetadaten lesen 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. |
Nachdem Sie eine Verbindung hergestellt haben, rufen Sie diese Tools nicht mehr selbst auf. Stellen Sie Ihrem MCP-kompatiblen AI-Client wie ChatGPT, Claude oder Cursor eine Frage in natürlicher Sprache. Der Client wählt die Tools für die Aufgabe aus.
Wenn Sie beispielsweise fragen: "Was waren unsere 10 wichtigsten Accounts im letzten Geschäftsjahr nach Umsatz?", untersucht der AI-Client das Datenset-Schema, generiert die Salesforce Analytics-Abfragesprache (SAQL) und gibt strukturierte Ergebnisse mit execute_query zurück.
Ein typischer Abfrage-Workflow ist die list_datasets von get_dataset (currentVersionId erfassen) zu get_xmd (genaue Feldnamen) zu execute_query.
In der Spalte "Beschreibung/Eingaben" werden erforderliche Parameter notiert. Andere Parameter sind optional.
Organisations- und Discovery-Tools
Externe MCP-kompatible AI-Clients verwenden diese Tools, um Ordner (Anwendungen) zu finden, die Dashboards, Datensets und Linsen enthalten, und um Metadaten für vollständige Ordner zu laden.
| Toolname | Beschreibung / Eingaben | Rückgaben | Verwenden von When |
|---|---|---|---|
list_folders |
Gibt Ordner (Anwendungen) zurück, auf die der verbundene Benutzer zugreifen kann. Eingaben: |
Ordnerobjekte mit ID, Bezeichnung, Beschreibung, Vorlagenquelle und Berechtigungen. | Sie benötigen Ordner-IDs, um spätere Listenaufrufe einzugrenzen, oder Sie möchten ein Inventar der Anwendungen. |
get_folder |
Gibt vollständige Metadaten für einen Ordner (Anwendung) zurück. Eingaben: |
Ein Ordnerobjekt mit Bezeichnung, Beschreibung, Vorlagenquelle und Berechtigungen. | Sie benötigen vollständige Metadaten für eine bestimmte Anwendung. |
Daten- und Schematools
Externe MCP-kompatible AI-Clients verwenden diese Tools, um Datensets aufzulisten und die Feldnamen, Datentypen und Bezeichnungen abzurufen, die zum Generieren von gültigem SAQL erforderlich sind.
| Toolname | Beschreibung / Eingaben | Rückgaben | Verwenden von When |
|---|---|---|---|
list_datasets |
Gibt Datensets in einer Anwendung oder in der gesamten Organisation zurück. Eingaben: |
Datenset-Objekte mit Namen, Typen und Datum der letzten Änderung. | Sie benötigen Datenset-Namen und -IDs, bevor Sie ein Schema untersuchen oder eine Abfrage ausführen. |
get_dataset |
Gibt vollständige Metadaten für ein Datenset zurück, einschließlich Informationen zur aktuellen Version. Eingaben: |
Datenset-Metadaten, einschließlich Feldnamen, Datentypen, Dimensions- und Maßeinheitsbezeichnungen und der aktuellen Versions-ID. | Sie benötigen currentVersionId, bevor Sie get_xmd oder execute_query anrufen. |
get_xmd |
Gibt erweiterte Metadaten für eine Datenset-Version zurück, einschließlich genauer API-Feldnamen, Datentypen, Bezeichnungen und Formatierungen. Eingaben: |
Erweiterte Metadaten für die Datenset-Version, einschließlich Feld-API-Namen, Datentypen, Bezeichnungen und Anzeigeformatierung. | Sie benötigen genaue Feld-API-Namen, damit der Client syntaktisch korrekte SAQL erstellen kann. |
Abfrage- und Analysetools
Externe MCP-kompatible AI-Clients verwenden dieses Tool, um SAQL für ein CRM Analytics-Datenset auszuführen und strukturierte Ergebnisse zurückzugeben. Der Client generiert SAQL aus Ihrer Anforderung in natürlicher Sprache.
| Toolname | Beschreibung / Eingaben | Rückgaben | Verwenden von When |
|---|---|---|---|
execute_query |
Führt eine SAQL-Abfrage für ein CRM Analytics-Datenset aus. Eingaben: |
Strukturierte JSON-Abfrageergebnisse mit Zeilen, Spaltenmetadaten und Details zur Abfrageausführung. | Sie möchten gruppierte, gefilterte oder geordnete Antworten aus einem Datenset. Verwenden Sie dieses Tool nicht für die Metadatenerkennung. |
Dashboard, Visualisierung und Erkundungstools
Externe MCP-kompatible AI-Clients verwenden diese Tools, um Dashboards und gespeicherte Erkundungen (Linsen) zu finden und Widget-, Schritt-, Filter- und Abfragedefinitionen abzurufen.
| Toolname | Beschreibung / Eingaben | Rückgaben | Verwenden von When |
|---|---|---|---|
list_dashboards |
Gibt CRM Analytics-Dashboards in einer Anwendung oder in der gesamten Organisation zurück. Eingaben: |
Dashboard-Objekte mit Namen, IDs, Typen und Anwendungskontext. | Sie benötigen Dashboard-Kennzeichner oder möchten vorgefertigte Dashboards nach einer Anwendung durchsuchen. |
get_dashboard |
Gibt vollständige Metadaten für ein Dashboard zurück, einschließlich Widgets, Schritten und Filtern. Eingaben: |
Vollständige Dashboard-Metadaten, einschließlich Widgets, Schritten, Filterkonfigurationen und Layoutdetails. | Sie benötigen die vollständige Definition eines bestimmten Dashboards. |
list_lenses |
Gibt gespeicherte Erkundungen (Linsen) zurück, auf die der verbundene Benutzer zugreifen kann. Eingaben: |
Linsenobjekte mit Namen, IDs und den Datensets, auf die sie verweisen. | Sie benötigen ein Inventar der gespeicherten Erkundungen und der von ihnen verwendeten Datensets. |
get_lens |
Gibt vollständige Metadaten für eine Linse zurück, einschließlich der Abfragedefinition und des Datensetverweises. Eingaben: |
Vollständige Linsenmetadaten, einschließlich Abfragedefinition, Visualisierungskonfiguration und Datensetverweis. | Sie benötigen die Abfrage- und Visualisierungsdetails einer bestimmten Linse. |
