Usted está aquí:
Referencia de la herramienta CRM Analytics MCP Server
Herramientas de solo lectura que permiten a los clientes de IA que cumplen con MCP descubrir aplicaciones, inspeccionar esquemas, ejecutar consultas SAQL y leer metadatos de lentes y paneles.
Ediciones necesarias
| Disponible en Lightning Experience. |
| Disponible con CRM Analytics, que está disponible por un coste adicional en Enterprise Edition, Performance Edition y Unlimited Edition. |
Después de conectarse, no llama estas herramientas usted mismo. Formule a su cliente de IA que cumpla con MCP, como ChatGPT, Claude o Cursor, una pregunta en lenguaje natural. El cliente selecciona las herramientas para la tarea.
Por ejemplo, cuando pregunta: "¿Cuáles fueron nuestras 10 cuentas principales por ingresos el año fiscal pasado?", el cliente de IA inspecciona el esquema del conjunto de datos, genera Salesforce Analytics Query Language (SAQL) y devuelve resultados estructurados con execute_query.
Un flujo de trabajo de consulta habitual es list_datasets a get_dataset (capturar currentVersionId) a get_xmd (nombres de campo exactos) a execute_query.
La columna Descripción / Entradas señala parámetros requeridos. Otros parámetros son opcionales.
Herramientas de organización y descubrimiento
Los clientes de IA que cumplen con MCP externos utilizan estas herramientas para encontrar carpetas (aplicaciones) que contienen paneles, conjuntos de datos y lentes, y para cargar metadatos de carpetas completos.
| Nombre de herramienta | Descripción / Entradas | Devoluciones | Utilizar cuándo |
|---|---|---|---|
list_folders |
Devuelve carpetas (aplicaciones) a las que puede acceder el usuario conectado. Entradas: |
Objetos de carpeta con Id., etiqueta, descripción, origen de plantilla y permisos. | Necesita Id. de carpeta para delimitar llamadas de lista posteriores o desea un inventario de aplicaciones. |
get_folder |
Devuelve metadatos completos para una carpeta (aplicación). Entradas: |
Un objeto de carpeta con etiqueta, descripción, origen de plantilla y permisos. | Necesita metadatos completos para una aplicación específica. |
Herramientas de datos y esquemas
Los clientes de IA que cumplen con MCP externos utilizan estas herramientas para enumerar conjuntos de datos y recuperar los nombres de campo, tipos de datos y etiquetas requeridos para generar SAQL válido.
| Nombre de herramienta | Descripción / Entradas | Devoluciones | Utilizar cuándo |
|---|---|---|---|
list_datasets |
Devuelve conjuntos de datos en una aplicación o en toda la organización. Entradas: |
Objetos de conjunto de datos con nombres, tipos y fechas de última modificación. | Necesita nombres e Id. de conjuntos de datos antes de inspeccionar un esquema o ejecutar una consulta. |
get_dataset |
Devuelve metadatos completos para un conjunto de datos, incluyendo información de versión actual. Entradas: |
Metadatos del conjunto de datos incluyendo nombres de campo, tipos de datos, etiquetas de dimensión y medición e Id. de versión actual. | Necesita currentVersionId antes de llamar a get_xmd o execute_query. |
get_xmd |
Devuelve metadatos ampliados (XMD) para una versión de conjunto de datos, incluyendo nombres de API de campo exactos, tipos de datos, etiquetas y formato. Entradas: |
Metadatos ampliados para la versión del conjunto de datos, incluyendo nombres de API de campo, tipos de datos, etiquetas y formato de visualización. | Necesita nombres de API de campo precisos para que el cliente pueda crear SAQL sintácticamente correcto. |
Herramientas de consulta y análisis
Los clientes de IA que cumplen con MCP externos utilizan esta herramienta para ejecutar SAQL en un conjunto de datos de CRM Analytics y devolver resultados estructurados. El cliente genera SAQL desde su solicitud de lenguaje natural.
| Nombre de herramienta | Descripción / Entradas | Devoluciones | Utilizar cuándo |
|---|---|---|---|
execute_query |
Ejecuta una consulta SAQL en un conjunto de datos de CRM Analytics. Entradas: |
Resultados de consultas JSON estructuradas con filas, metadatos de columnas y detalles de ejecución de consultas. | Desea respuestas agrupadas, filtradas o clasificadas desde un conjunto de datos. No utilice esta herramienta para el descubrimiento de metadatos. |
Herramientas de panel, visualización y exploración
Los clientes de IA que cumplen con MCP externos utilizan estas herramientas para encontrar paneles y exploraciones guardadas (lentes) y para recuperar definiciones de widget, paso, filtro y consulta.
| Nombre de herramienta | Descripción / Entradas | Devoluciones | Utilizar cuándo |
|---|---|---|---|
list_dashboards |
Devuelve paneles de CRM Analytics en una aplicación o en toda la organización. Entradas: |
Objetos de panel con nombres, Id., tipos y contexto de aplicación. | Necesita identificadores de panel o desea examinar paneles preintegrados para una aplicación. |
get_dashboard |
Devuelve metadatos completos para un panel, incluyendo widgets, pasos y filtros. Entradas: |
Metadatos de panel completos incluyendo widgets, pasos, configuraciones de filtro y detalles de formato. | Necesita la definición completa de un panel específico. |
list_lenses |
Devuelve exploraciones guardadas (lentes) a las que puede acceder el usuario conectado. Entradas: |
Objetos de lente con nombres, Id. y los conjuntos de datos a los que hacen referencia. | Necesita un inventario de exploraciones guardadas y los conjuntos de datos que utilizan. |
get_lens |
Devuelve metadatos completos para una lente, incluyendo la definición de la consulta y la referencia del conjunto de datos. Entradas: |
Metadatos de lente completos incluyendo la definición de la consulta, la configuración de visualización y la referencia del conjunto de datos. | Necesita los detalles de consulta y visualización de una lente específica. |
