Trailhead MCP

Qu'est-ce que MCP ?

Un MCP (Protocole de contexte de modèle) standardise la manière dont les assistants IA comme Slackbot, Claude ou Cursor se connectent aux outils et sources de données externes. Il permet aux assistants IA d'accéder en temps réel à des informations actualisées provenant de sites Web, de bases de données et de services.

Qu'est-ce que Trailhead MCP ?

Trailhead MCP est un serveur MCP gratuit et ouvert qui connecte votre assistant IA à l'ensemble des supports d'apprentissage Trailhead. Lorsque vous posez à votre agent IA des questions sur des rubriques Salesforce, par exemple « Parle-moi de l'architecture d'Agentforce » ou « À quoi sert Flow ? », il peut trouver et vous présenter le contenu Trailhead correspondant, là où vous travaillez déjà. Plus besoin d'ouvrir de nouveaux onglets, de copier-coller des informations ou de craindre les hallucinations.

À qui cela s'adresse-t-il ?

Trailhead MCP est conçu pour :

Les équipes d'enablement qui conçoivent des expériences d'apprentissage alimentées par le contenu Trailhead
Pour les Trailblazers qui veulent accéder au contenu d'apprentissage à la demande directement dans leurs outils d'IA
Les développeurs et administrateurs Salesforce qui utilisent Claude, Cursor ou VS Code au quotidien
Les générateurs d'agents IA dont les équipes développent des agents devant contextualiser leurs réponses grâce à du contenu Trailhead fiable

Que peut-il faire ?

Trailhead MCP met à votre disposition deux outils simples pour accéder à son contenu directement dans votre assistant IA :

fetch_content : récupère l'intégralité du contenu d'un badge ou d'un parcours à partir de son nom, renvoyé au format Markdown optimisé pour les LLM.
content_search : recherche des supports d'apprentissage par rubrique dans l'ensemble du contenu public de Trailhead. Cet outil trouve les badges, les parcours, les cheminements Trailhead et les superbadges. Vous pouvez filtrer par rôle (par exemple Administrateur, Développeur, Architecte) et par niveau de compétence (Basique, Intermédiaire ou Avancé). Vous gagnez ainsi le temps que vous auriez passé à parcourir des centaines de badges et de parcours pour trouver ce qui vous intéresse.

Limites de Trailhead MCP

Il est important de noter que Trailhead MCP n'a pas pour but de remplacer l'expérience Trailhead complète et interactive proposée sur trailhead.com, avec ses parcours d'apprentissage structurés et ses fonctionnalités de gamification. Vous ne pourrez pas obtenir de badges ni suivre votre progression via le MCP, qui n'accède pas non plus, dans sa forme actuelle, à vos données privées d'apprenant ou aux informations de votre compte.

Clients pris en charge

Slackbot
Agentforce
Claude / Claude Code
Cursor
Tout client compatible MCP utilisant Streamable HTTP

Point de terminaison du serveur

https://mcp.trailhead.salesforce.com/mcp

Le serveur fonctionne en permanence : il n'y a rien à héberger ni à déployer.

Authentification et accès

Aucune authentification requise pour accéder au contenu Trailhead public (état actuel)

Périmètre du contenu

Trailhead MCP donne accès aux badges et aux parcours accessibles publiquement ; les cheminements Trailhead et les superbadges arriveront prochainement. Le contenu est actualisé quotidiennement pour vous garantir les supports d'apprentissage les plus récents.

Découvrez : Slackbot

Avant de commencer

Vous devez avoir accès à un espace de travail Slack dans lequel Trailhead MCP est disponible. L'application Trailhead MCP doit être activée pour votre espace de travail par votre administrateur Slack.

Ajouter Trailhead MCP à un espace de travail Slack

Rendez-vous sur https://api.slack.com/apps. Si vous disposez de droits suffisants dans votre espace de travail, un bouton Create New App (Créer une nouvelle application) doit s'afficher.
Cliquez sur Create New App (Créer une nouvelle application) et sélectionnez From a Manifest (Depuis un manifeste)
Sélectionnez votre espace de travail, puis cliquez sur Next
Dans la fenêtre Create app from Manifest (Créer une application depuis un manifeste), saisissez le manifeste JSON suivant :

manifest.json

{
"display_information": {
"name": "Trailhead MCP App",
"description": "Interact with Trailhead via MCP",
"background_color": "#1d7c00"
},

"features": {
"bot_user": {

"display_name": "Trailhead MCP App",
"always_online": false
}

},
"oauth_config": {

"scopes": {
"bot": [
"mcp:connect",
"commands"
]
},

        "pkce_enabled": false
    },
    "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false,
        "is_mcp_enabled": true
    },
    "mcp_servers": {
        "Trailhead MCP": {
            "url": "https://mcp.trailhead.salesforce.com",
            "auth_type": "no_auth"
        }
    }
}

Dans la fenêtre Review summary & create your app (Analyser le résumé et créer votre application), vérifiez tous les paramètres, puis cliquez sur Create pour activer Trailhead MCP dans Slackbot
Ouvrez une conversation avec Slackbot (ou démarrez un nouveau message direct)
Cliquez sur l'icône App integrations (Applications) sous le champ de message ; actualisez d'abord Slack si elle n'apparaît pas (Cmd+Maj+R sur Mac, Ctrl+Maj+R sur Windows/Linux)
Repérez Trailhead MCP et cliquez pour l'ajouter
Pour de meilleurs résultats : accédez à Manage Apps (Gérer les applications) → Trailhead MCP → réglez tous les outils sur « Always allow » (Toujours autoriser)

Vérifiez que tout fonctionne

Dans votre message direct Slackbot, essayez :

« Utilise Trailhead MCP pour trouver du contenu pour débutants sur Salesforce Flow. »

Conseils pour de meilleurs résultats

Régler les outils sur « Always allow » (Toujours autoriser) évite que Slackbot demande une autorisation à chaque requête
Soyez explicite : « Utilise Trailhead MCP pour... » garantit que Slackbot s'oriente vers le bon outil

Découvrez : Agentforce

Présentation

Trailhead MCP permet de contextualiser les agents Agentforce grâce au contenu Trailhead fiable, afin qu'ils répondent aux questions d'apprentissage à partir de sources à jour et citées.

Ajouter Trailhead MCP

Dans la configuration de votre organisation, dans la zone Quick Find (Recherche rapide), saisissez MCP et cliquez sur Registered MCP Servers (Serveurs MCP enregistrés)
Sur la page Agentforce Registry, cliquez sur New + (Nouveau +) puis, dans la liste déroulante, cliquez sur Register MCP Server (Enregistrer un serveur MCP)
On the Create Connection modal
1. Renseignez les champs MCP Server Name (Nom de serveur MCP) et Description pour préciser l'usage prévu de cette connexion.
2. Définissez Server URL (URL de serveur) sur https://mcp.trailhead.salesforce.com/mcp
3. Définissez Authentication Method (Méthode d'authentification) sur No Authentication (Aucune authentification)
4. Cliquez sur Create and Continue (Créer et continuer)
5. Dans la section suivante, Tools (Outils), cliquez sur le bouton Add Tool (Ajouter un outil) pour chacun des outils que vous utiliserez
6. Cliquez sur Allow and Continue (Autoriser et continuer)
7. Dans la section suivante, Select policies (Optional) (Sélectionner des stratégies [Optionnel]), sélectionnez les stratégies applicables à votre cas d'utilisation.
8. Cliquez sur Save (Enregistrer)

Cas d'utilisation recommandés

Des agents d'assistance contextualisés grâce au contenu de meilleures pratiques Trailhead
Des agents d'intégration qui orientent les nouveaux collaborateurs vers le bon contenu Trailhead
Les agents d'enablement qui répondent aux questions produit en citant les modules Trailhead officiels

Découvrez : Claude et Claude Code

Avant de commencer

Claude Desktop, Claude Code ou Claude CLI doit être installé.

Ajouter Trailhead MCP

Claude Code / Claude CLI ; exécutez ceci dans votre terminal :

claude mcp add trailhead --transport http https://mcp.trailhead.salesforce.com/mcp --scope user

L'option --scope user rend le serveur disponible dans tous vos projets Claude Code.

Claude Desktop :

Ouvrez Claude Desktop → Settings (Paramètres) → Developer (Développeur) → Edit Config (Modifier la configuration)
Ajoutez ce qui suit à votre fichier claude_desktop_config.json :

claude_desktop_config.json

{
  "mcpServers": {
    "trailhead": {
      "type": "http",
      "url": "https://mcp.trailhead.salesforce.com/mcp"
    }
  }
}

Enregistrez, puis redémarrez Claude Desktop

Vérifiez que tout fonctionne

Essayez l'un de ces prompts :

« Que dit Trailhead sur les meilleures pratiques de bulkification Apex ? »
« Trouve-moi du contenu Trailhead sur Agentforce pour les débutants. »
« Récupère le contenu du badge Couche de confiance Einstein et résume-le. »

La réponse doit citer du contenu Trailhead. Si l'IA répond à partir de ses connaissances générales sans citer Trailhead, consultez la section Obtenir une aide.

Conseils pour de meilleurs résultats

Soyez explicite : « Utilise Trailhead MCP pour trouver... » aide Claude à s'orienter vers le bon outil
Consultez la section Guide de prompting pour en savoir plus

Découvrez : Cursor

Avant de commencer

Cursor doit être installé. Télécharger Cursor.

Ajouter Trailhead MCP

Cliquez sur ce lien pour que Cursor ajoute automatiquement le MCP

Vérifiez que tout fonctionne

Ouvrez une nouvelle fenêtre Composer (⌘+I) et essayez les étapes suivantes :

« Recherche dans Trailhead du contenu sur les meilleures pratiques Flow pour les administrateurs. »

Conseils pour de meilleurs résultats

Consultez la section Guide de prompting pour en savoir plus
Trailhead MCP donne les meilleurs résultats en Agent mode (mode Agent) dans Cursor Composer
Précisez le rôle et le niveau pour obtenir des résultats plus ciblés (par exemple « contenu Trailhead sur les LWC pour les développeurs, niveau intermédiaire »)

Guide de prompting : Tirez le meilleur parti de Trailhead MCP

Trailhead MCP est un outil de recherche et de récupération : la qualité des résultats dépend beaucoup de la façon dont vous formulez votre demande.
Les deux outils et quand les utiliser

content_search : à utiliser pour explorer. Idéal lorsque vous connaissez le sujet, mais pas le nom exact du badge ou du parcours. Exemple : « Trouve du contenu Trailhead sur les meilleures pratiques de test Apex. »
fetch_content : à utiliser lorsque vous savez exactement ce que vous voulez. Récupère l'intégralité du contenu du module. Exemple : « Récupère le contenu du badge Trailhead 'Apex Triggers'. »

Si votre IA continue d'utiliser content_search alors que vous voulez le contenu complet, soyez explicite : « Utilise fetch_content pour récupérer... »

Filtrer par rôle et par niveau

Les deux outils prennent en charge le filtrage, et l'utiliser améliore nettement les résultats.

Rôles : Administrateur, Développeur, Architecte, Spécialiste du marketing, Analyste commercial, Consultant
Niveaux : Basique, Intermédiaire, Avancé

Exemple : « Trouve du contenu Trailhead sur la modélisation de données pour les architectes, de niveau avancé. »

Exemples de prompts par persona

Développeur

« Que dit Trailhead sur les meilleures pratiques de bulkification Apex ? »
« Trouve tout le contenu Trailhead lié aux LWC et explique les concepts clés. »
« Récupère le contenu Trailhead sur SOQL et SOSL et résume les différences. »

Administrateur

« Par quels badges Trailhead un nouvel administrateur Salesforce doit-il commencer ? »
« Trouve du contenu Trailhead sur Salesforce Flow pour les débutants. »
« Recherche dans Trailhead du contenu sur les rapports et les tableaux de bord. »

Architecte

« Recherche dans Trailhead du contenu sur l'architecture de données Salesforce de niveau avancé. »
« Récupère le badge Couche de confiance Einstein et donne-moi une analyse technique détaillée. »
« Trouve tout le contenu Trailhead sur les modèles d'intégration et les API. »

Agent Builder

« Trouve tout le contenu Trailhead relatif à Agentforce et à l'IA. »
« Que dit Trailhead sur l'ingénierie des prompts pour Salesforce ? »
« Récupère le contenu 'Découvrir Agentforce' et résume les concepts clés pour un public de développeurs. »

Que faire lorsque les résultats semblent incorrects

Aucun résultat : Essayez d'autres mots-clés : « Flow », « Salesforce Flow » et « process automation » peuvent donner des résultats différents
Résultats obsolètes : Le contenu est actualisé quotidiennement. Réessayez le lendemain ou utilisez fetch_content avec le nom exact
L'IA répond à partir de ses connaissances générales : Ajoutez « Utilise Trailhead MCP pour... » au début de votre prompt

Utiliser Trailhead MCP dans les configurations d'agent

Si vous créez un agent et souhaitez qu'il utilise systématiquement Trailhead MCP pour les questions d'apprentissage Salesforce, ajoutez ceci à votre prompt système ou à votre fichier copilot-instructions.md :

Pour répondre aux questions portant sur les produits, les fonctionnalités ou les meilleures pratiques Salesforce, utilisez systématiquement les outils content_search ou fetch_content de Trailhead MCP afin de récupérer du contenu Trailhead fiable et à jour. Citez le nom du badge ou du parcours dans votre réponse.

Confidentialité et traitement des données

Contenu fourni

Tout le contenu renvoyé par Trailhead MCP est du contenu Trailhead accessible publiquement, c'est-à-dire le même contenu que n'importe quel visiteur peut consulter sur trailhead.com sans se connecter. Aucune donnée privée d'apprenant, information de compte ou contenu personnalisé n'est inclus.

Authentification

Aucune authentification n'est requise

Nos engagements en matière de données

Trailhead MCP ne vend pas vos données et ne les partage pas avec des tiers
Trailhead MCP ne stocke, ne collecte et ne conserve ni vos requêtes ni vos prompts
Trailhead MCP n'utilise pas vos interactions pour entraîner des modèles d'IA
Trailhead MCP n'accède pas à votre compte Trailhead, à vos badges ou à vos points, ne les lit pas et ne les modifie pas

FAQ

Oui : son utilisation est gratuite et aucun compte n'est nécessaire pour accéder au contenu public.

Non. Tout le contenu Trailhead disponible est accessible sans authentification.

Vous ne pouvez pas obtenir de badges ni suivre votre progression via le MCP. Connectez-vous à Trailhead.com pour accéder à nos fonctionnalités de gamification et à nos contenus personnalisés.

Actualisation du contenu : Le service de connaissances est actualisé quotidiennement. Les contenus très récemment publiés peuvent ne pas encore apparaître.
Autres formulations : La recherche repose sur des mots-clés. Les synonymes comptent : essayez « Flow » ou « Salesforce Flow ».
Utilisez fetch_content directement : Si vous connaissez le nom exact du badge ou du parcours, demandez à votre IA de le récupérer par son nom.

Une fois par jour.

Tout le contenu Trailhead est concerné, y compris les badges (modules/unités), les parcours, les cheminements Trailhead et les superbadges.

Non. Trailhead MCP est en lecture seule. Il ne stocke ni les requêtes, ni les prompts, ni aucune donnée utilisateur. Pour en savoir plus, consultez la section Confidentialité et traitement des données.

Tout client compatible MCP utilisant Streamable HTTP devrait fonctionner, notamment : Slackbot, Agentforce, Claude / Claude Code, Cursor et VS Code (avec GitHub Copilot).

Assurez-vous que votre client Cursor est à jour et que l'URL du serveur MCP est correctement saisie dans Settings (Paramètres) → MCP.

Consultez la section Obtenir une aide ci-dessous.

Obtenir une aide

Dépannage en libre-service

Consultez d'abord la FAQ ci-dessus : elle couvre les problèmes les plus courants, notamment le contenu introuvable, les erreurs 405 et les problèmes de configuration propres à chaque client.

Dépannage par client

Claude Code : Vérifiez que votre commande comporte bien --transport http et --scope user
Cursor : Vérifiez que l'URL est correctement saisie dans Settings (Paramètres) → MCP
VS Code : Vérifiez que le fichier JSON de vos paramètres MCP est valide et que VS Code a bien été rechargé
Slackbot : Essayez d'actualiser Slack (Cmd+Maj+R / Ctrl+Maj+R) si l'icône du connecteur MCP n'apparaît pas

Signaler un problème ou envoyer un feedback

Accédez à https://help.salesforce.com/s/cases
Sélectionnez Demander à Agentforce
Envoyez les détails de votre requête via Agentforce

Important : Précisez toujours d'emblée que votre problème concerne Trailhead MCP. Ce canal de support couvre l'ensemble des offres de produits et de contenus Trailhead : mentionner immédiatement « Trailhead MCP » aide l'équipe à orienter et à trier correctement votre requête.

Pour une résolution plus rapide, structurez votre requête selon ce format :

Produit : Client Trailhead MCP : [par exemple Claude Desktop v1.2.3, Cursor 0.45, Slackbot]

Prompt utilisé : [le prompt ou la requête exacte que vous avez exécuté(e)]

Comportement attendu : [ce que vous vous attendiez à obtenir]

Comportement observé : [le message d'erreur ou le résultat inattendu obtenu]

Reproductibilité : [Systématique / Intermittent / Ponctuel]

Notes complémentaires : [tout autre élément pertinent, comme des modifications récentes de la configuration]

Trailhead MCP est-il gratuit ?

Ai-je besoin d'un compte Trailhead ?

Puis-je obtenir des badges ou suivre ma progression via le MCP ?

Je ne parviens pas à trouver un contenu dont je sais qu'il est disponible, pourquoi ?

À quelle fréquence le contenu est-il actualisé ?

Quels types de contenu Trailhead sont disponibles ?

Mes données sont-elles stockées ou envoyées à Salesforce ?

Quels clients sont pris en charge ?

Que faire si j'obtiens une erreur « 405 Method Not Allowed » (405, méthode non autorisée) dans Cursor ?

Le problème vient d'ailleurs. Où obtenir de l'aide ?