Usted estĆ” aquĆ:
SoluciĆ³n de problemas y sugerencias de CRM Analytics MCP Server
Resuelva problemas de conexiĆ³n y permisos, y utilice solicitudes y prĆ”cticas que ayudan a los clientes de IA a consultar datos de CRM Analytics con mayor precisiĆ³n.
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. |
Problemas generales de conectividad
- La conexiĆ³n del servidor falla: Confirme que el servidor MCP de CRM Analytics estĆ” activado en ConfiguraciĆ³n bajo Servidores MCP. Confirme tambiĆ©n que creĆ³ una aplicaciĆ³n cliente externa con la URL de devoluciĆ³n de llamada correcta. A continuaciĆ³n confirme que iniciĆ³ sesiĆ³n en la organizaciĆ³n que contiene esa aplicaciĆ³n antes de iniciar el flujo de OAuth.
- No aparece ninguna herramienta: Confirme que su cliente de MCP utiliza la URL de servidor correcta para su tipo de organizaciĆ³n y que cada usuario completĆ³ OAuth con sus propias credenciales de Salesforce. El servidor MCP de CRM Analytics no admite tokens de cuenta de servicio.
- OrganizaciĆ³n de producciĆ³n: El servidor MCP de CRM Analytics estĆ” disponible en organizaciones de producciĆ³n, asĆ como organizaciones sandbox y borrador. Utilice la URL del servidor que coincida con su tipo de organizaciĆ³n:
- ProducciĆ³n:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox u organizaciĆ³n borrador:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- ProducciĆ³n:
Acceso a datos y herramientas
Su sesiĆ³n de MCP se ejecuta como usted. Como la autenticaciĆ³n utiliza sus credenciales de Salesforce, cada solicitud respeta la seguridad a nivel de campo (FLS), la seguridad a nivel de objeto (OLS), la seguridad a nivel de filas (RLS) y las reglas de colaboraciĆ³n. El cliente de IA nunca puede ver datos o activos que no puede ver en CRM Analytics.
- Conjuntos de datos, paneles o lentes que faltan: Si el cliente informa de que un activo no estĆ” disponible o una llamada de
list_devuelve menos elementos de los que espera, es probable que carezca de permiso para ese activo. Confirme que tiene acceso a la aplicaciĆ³n o el activo y que su conjunto de permisos otorga acceso a CRM Analytics. - LĆmites de API: Las llamadas de herramientas de MCP cuentan en los lĆmites de API de Wave de su organizaciĆ³n. Compruebe el uso en ConfiguraciĆ³n bajo Uso de API.
Consulte la GuĆa de soluciĆ³n de problemas para obtener mĆ”s informaciĆ³n.
Sugerencias para mejores resultados
- Describa el objetivo, no la herramienta: Diga "Mostrarme oportunidades abiertas por etapa" en vez de "llamar a list_datasets". El cliente de IA selecciona las herramientas.
- Mejore la precisiĆ³n de las consultas con descripciones de campo: Agregar etiquetas de campo y descripciones a sus metadatos ampliados de conjunto de datos (XMD) ayuda al cliente de IA a generar SAQL mĆ”s preciso.
- Refinar consultas complejas: Las agrupaciones anidadas, las uniones de conjuntos de datos mĆŗltiples o las funciones SAQL avanzadas pueden requerir solicitudes de seguimiento para obtener el resultado exacto.
Solicitudes de ejemplo
Utilice estas solicitudes en una nueva sesiĆ³n para descubrir activos, inspeccionar esquemas y formular preguntas sobre sus datos.
| Solicitud de usuario | Herramienta llamada | Objetivo |
|---|---|---|
| ĀæA quĆ© aplicaciones de anĆ”lisis tengo acceso? | list_folders |
Devuelve las carpetas (aplicaciones) que albergan sus paneles, conjuntos de datos y lentes. Utilice los resultados para delimitar bĆŗsquedas posteriores. |
| ĀæA quĆ© conjuntos de datos de CRM Analytics tengo acceso en este momento? | list_datasets |
Recupera nombres, etiquetas e Id. de conjuntos de datos disponibles en su contexto de seguridad. |
| MuĆ©streme todos los paneles en mi carpeta AplicaciĆ³n de ventas. | list_dashboards |
Localiza paneles preintegrados para una aplicaciĆ³n o unidad comercial especĆfica. |
| Enumere todas las exploraciones guardadas que tengo permiso para ver. | list_lenses |
Recopila un inventario de lentes guardadas y los conjuntos de datos a los que hacen referencia. |
| Deme los metadatos completos para el conjunto de datos Oportunidades en curso ejecutivas. | get_dataset |
Devuelve detalles del conjunto de datos, incluyendo el Id. de versiĆ³n actual necesario para consultarlo. |
| ĀæCuĆ”les son los campos, dimensiones y mediciones exactos en el conjunto de datos Oportunidad? | get_xmd |
Proporciona nombres de API de campo, tipos de datos y etiquetas de modo que el cliente pueda crear SAQL sintƔcticamente correcto. |
| ĀæCuĆ”les fueron nuestras 10 cuentas principales por ingresos el aƱo fiscal pasado? | execute_query |
Inspecciona el esquema del conjunto de datos, genera una consulta SAQL y devuelve resultados estructurados. |
| ĀæCuĆ”l fue el total de oportunidades en curso por regiĆ³n el trimestre pasado? | execute_query |
Realiza la agrupaciĆ³n y el filtrado utilizando SAQL. |
| MuƩstreme el rendimiento de los representantes frente a la cuota este mes. | execute_query |
Ejecuta una consulta y devuelve metadatos de filas y columnas como JSON estructurado. |
Comentarios y asistencia beta
Este servidor estĆ” disponible como una versiĆ³n beta. Sus comentarios dan forma a la experiencia disponible de forma general (GA).
- Comparta comentarios con su equipo de cuentas de Salesforce o envĆelos al grupo Trailblazer Community para este programa.
- Consulte las notas de versiĆ³n de cada actualizaciĆ³n para problemas y soluciones conocidos.
- PĆ³ngase en contacto con el Servicio de asistencia de Salesforce para problemas tĆ©cnicos durante la configuraciĆ³n y haga referencia al servidor MCP de CRM Analytics (Beta).
ĀæResolviĆ³ este artĆculo su problema?
Ā”HĆ”ganos saber cĆ³mo podemos mejorar!
