Vous êtes ici :
Dépannage et conseils du serveur CRM Analytics MCP
Résolvez les problèmes de connexion et d'autorisation, et utilisez des invites et des pratiques qui aident les clients de l'IA à interroger les données CRM Analytics avec plus de précision.
Éditions requises
| Disponible dans Lightning Experience. |
| Disponible avec CRM Analytics moyennant un coût supplémentaire dans les éditions Enterprise, Performance et Unlimited. |
Problèmes généraux de connectivité
- La connexion au serveur échoue : Vérifiez que le serveur CRM Analytics MCP est activé dans Configuration, sous Serveurs MCP. Vérifiez également que vous avez créé une application cliente externe avec l'URL de rappel correcte. Vérifiez ensuite que vous vous êtes connecté à l'organisation qui contient cette application avant de démarrer le flux OAuth.
- Aucun outil n'est affiché : Vérifiez que votre client MCP utilise l'URL de serveur correcte pour votre type d'organisation et que chaque utilisateur a complété OAuth avec ses propres identifiants Salesforce. Le serveur CRM Analytics MCP ne prend pas en charge les jetons de compte de service.
- Organisation de production : Le serveur CRM Analytics MCP est disponible dans les organisations de production, ainsi que dans les organisations sandbox et tests. Utilisez l'URL du serveur qui correspond à votre type d'organisation :
- Réalisation:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox ou organisation test:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- Réalisation:
Accès aux données et aux outils
Votre session MCP est exécutée en tant que vous. L'authentification utilise vos identifiants Salesforce. Par conséquent, chaque requête respecte la Sécurité au niveau du champ (FLS), la Sécurité au niveau de l'objet (OLS), la Sécurité au niveau de la ligne (RLS) et les règles de partage. Le client IA ne peut jamais afficher des données ou des actifs que vous ne pouvez pas afficher dans CRM Analytics.
- Jeux de données, tableaux de bord ou perspectives manquants : Si le client signale qu'un actif n'est pas disponible ou si un appel
list_renvoie moins d'éléments que vous ne le souhaitez, vous n'êtes probablement pas autorisé à accéder à cet actif. Vérifiez que vous avez accès à l'application ou à l'actif et que votre ensemble d'autorisations accorde l'accès à CRM Analytics. - Limites d'API : Les appels d'outils MCP sont pris en compte dans les limites en API Wave de votre organisation. Vérifiez l'utilisation dans Configuration sous Utilisation de l'API.
Pour plus d'informations, consultez le Guide de dépannage.
Conseils pour de meilleurs résultats
- Décrivez l'objectif, pas l'outil : Dites « Montrez-moi les opportunités en cours par étape » plutôt que « appelez list_datasets ». Le client IA sélectionne les outils.
- Améliorez la précision des requêtes avec des descriptions de champ : L'ajout d'étiquettes et de descriptions de champ à vos métadonnées étendues de jeu de données (XMD) aide le client IA à générer un SAQL plus précis.
- Affiner les requêtes complexes : Les regroupements imbriqués, les jointures de jeux de données multiples ou les fonctions SAQL avancées peuvent nécessiter des invites de suivi pour obtenir le résultat exact.
Exemples d'invites
Utilisez ces invites dans une nouvelle session pour découvrir des actifs, inspecter le schéma et poser des questions à vos données.
| Invite utilisateur | Outil appelé | Objet |
|---|---|---|
| À quelles applications d'analyse ai-je accès ? | list_folders |
Renvoie les dossiers (applications) qui contiennent vos tableaux de bord, jeux de données et perspectives. Utilisez les résultats pour étendre les recherches ultérieures. |
| À quels jeux de données CRM Analytics ai-je accès actuellement ? | list_datasets |
Récupère les noms, les étiquettes et les ID de jeu de données disponibles dans votre contexte de sécurité. |
| Affichez-moi tous les tableaux de bord de mon dossier Application commerciale. | list_dashboards |
Localise des tableaux de bord prédéfinis pour une application ou une unité commerciale spécifique. |
| Répertoriez toutes les explorations enregistrées que je suis autorisé à afficher. | list_lenses |
Répertorie les perspectives enregistrées et les jeux de données qu'elles référencent. |
| Donnez-moi les métadonnées complètes du jeu de données Pipeline exécutif. | get_dataset |
Renvoie les détails du jeu de données, y compris l'ID de version actuel requis pour l'interroger. |
| Quels sont les champs, les dimensions et les mesures exacts dans le jeu de données Opportunité ? | get_xmd |
Fournit des noms d'API de champ, des types de données et des étiquettes pour permettre au client d'élaborer un SAQL syntaxiquement correct. |
| Quels étaient nos 10 principaux comptes par chiffre d'affaires au cours de l'exercice fiscal précédent ? | execute_query |
Inspecte le schéma du jeu de données, génère une requête SAQL et renvoie des résultats structurés. |
| Quel était le pipeline total par région au trimestre dernier? | execute_query |
Effectue le regroupement et le filtrage en utilisant SAQL. |
| Montrez-moi les performances des commerciaux par rapport au quota ce mois-ci. | execute_query |
Exécute une requête et renvoie les métadonnées de lignes et de colonnes sous forme de JSON structuré. |
Commentaires et support bêta
Ce serveur est disponible en version bêta. Vos commentaires déterminent l'expérience globalement disponible (GA).
- Partagez des commentaires avec votre équipe de compte Salesforce, ou soumettez-les dans le groupe Trailblazer Community pour ce programme.
- Consultez les notes de publication de chaque mise à jour pour connaître les problèmes connus et les solutions de contournement.
- Contactez le Support Salesforce pour des problèmes techniques pendant la configuration et référencez le serveur CRM Analytics MCP (bêta).
Cet article a-t-il résolu votre problème ?
Dites-nous ce que nous pouvons améliorer !
