Trailhead MCP

Was ist MCP?

MCP (Model Context Protocol) legt fest, wie KI-Assistenten wie Slackbot, Claude oder Cursor eine Verbindung zu externen Tools und Datenquellen herstellen. Dadurch können KI-Assistenten in Echtzeit auf aktuelle Informationen von Websites, Datenbanken und Services zugreifen.

Was ist Trailhead MCP?

Trailhead MCP ist ein kostenloser, offener MCP-Server, der Ihren KI-Assistenten mit allen Lerninhalten von Trailhead verbindet. Wenn Sie Ihrem KI-Agenten Fragen zu Salesforce-Themen stellen – wie beispielsweise „Erzähle mir etwas über die Architektur von Agentforce“ oder „Wozu dient Flow?“ – kann er die eigentlichen Trailhead-Inhalte finden und Ihnen anzeigen, und zwar genau dort, wo Sie gerade arbeiten. Sie müssen keine neuen Browser-Registerkarten öffnen, keine Informationen kopieren und einfügen und sich auch keine Gedanken über Halluzinationen machen.

Für wen ist dies gedacht?

Trailhead MCP ist für folgende Zwecke konzipiert:

Enablement-Teams, die auf der Grundlage von Trailhead-Inhalten Lernerfahrungen entwickeln
Trailblazers, die On-Demand-Lerninhalte in ihren KI-Tools angezeigt bekommen möchten
Salesforce-Entwickler:innen und -Administrator:innen, die Claude, Cursor oder VS Code in ihrem täglichen Workflow nutzen
Entwickler:innen von KI-Agents, deren Teams Agents entwickeln, deren Antworten auf vertrauenswürdigen Trailhead-Inhalten für Kontextbildung genutzt werden müssen

Was ist möglich?

Trailhead MCP bietet Ihnen zwei einfache Tools, mit denen Sie direkt in Ihrem KI-Assistenten auf die Inhalte zugreifen können:

fetch_content – Ruft den vollständigen Inhalt eines Badges oder Trails anhand des Namens ab. Die Ausgabe erfolgt im für LLMs optimierten Markdown-Format.
content_search – Suche in allen öffentlich zugänglichen Inhalten von Trailhead nach Lernmaterialien zu bestimmten Themen. Damit werden Badges, Trails, Trailhead Journeys und Superbadges gefunden. Sie können nach Rolle (z. B. Administrator:in, Entwickler:in, Architekt:in) und Kenntnisstand (Grundkenntnisse, mittlere Ebene oder Fortgeschrittene) filtern. So sparen Sie Zeit, da Sie nicht Hunderte von Badges und Trails durchsehen müssen, um das zu finden, was für Sie relevant ist.

Einschränkungen des Trailhead MCP

Bitte beachten Sie, dass Trailhead MCP nicht dazu gedacht ist, die umfassende, interaktive Trailhead-Erfahrung zu ersetzen, die Sie auf trailhead.com mit seinen strukturierten Lernpfaden und Gamification-Funktionen erhalten. Über MCP können Sie weder Badges erwerben noch Ihren Lernfortschritt verfolgen. In seiner derzeitigen Form greift MCP auch nicht auf Ihre privaten Lernerdaten oder Informationen zum Account zu.

Unterstützte Clients

Slackbot
Agentforce
Claude / Claude-Code
Cursor
Jeder MCP-kompatible Client, der Streamable HTTP verwendet

Server-Endpunkt

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

Der Server ist stets in Betrieb – es muss nichts gehostet oder bereitgestellt werden.

Authentifizierung und Zugriff

Keine Authentifizierung erforderlich für den Zugriff auf öffentliche Trailhead-Inhalte (aktueller Stand)

Inhaltlicher Umfang

Trailhead MCP bietet Zugang zu öffentlich verfügbaren Badges und Pfaden; „Trailhead Journeys“ und „Superbadges“ werden in Kürze verfügbar sein. Die Inhalte werden täglich aktualisiert, um sicherzustellen, dass Ihnen stets die aktuellsten Lernmaterialien zur Verfügung stehen.

Erste Schritte: Slackbot

Bevor Sie beginnen

Sie benötigen Zugriff auf einen Slack-Workspace, in dem Trailhead MCP verfügbar ist. Die Trailhead MCP App muss von Ihrem/Ihrer Slack-Administrator:in für Ihren Arbeitsbereich aktiviert werden.

Trailhead MCP zum Slack-Workspace hinzufügen

Rufen Sie https://api.slack.com/apps auf; sofern Sie über ausreichende Berechtigungen in Ihrem Arbeitsbereich verfügen, sollte dort die Schaltfläche „Neue App erstellen“ angezeigt werden.
Klicken Sie auf „Create New App“ (Neue App erstellen) und wählen Sie „From a Manifest“ (Aus einem Manifest) aus.
Wählen Sie Ihren Arbeitsbereich aus und klicken Sie anschließend auf „Weiter“
Im Modal „App aus Manifest erstellen“ folgendes Manifest-JSON eingeben:

manifest.json

{
"display_information": {
"name": "Trailhead MCP App",
"description": „Über MCP mit Trailhead interagieren“,
„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"
        }
    }
}

Im Modal Review summary & create your app (Zusammenfassung überprüfen und Ihre App erstellen) alle Einstellungen überprüfen und anschließend auf „Create Enable Trailhead MCP“ in Slackbot klicken
Öffnen Sie eine beliebige Unterhaltung mit Slackbot (oder starten Sie eine neue Direktnachricht)
Klicken Sie im Nachrichteneditor auf das Symbol App-Integrationen – aktualisieren Sie Slack zunächst, falls es nicht angezeigt wird (Cmd+Shift+R auf dem Mac, Strg+Shift+R unter Windows/Linux)
Suchen Sie Trailhead MCP und klicken Sie zum Hinzufügen darauf
So erzielen Sie optimale Ergebnisse: Gehen Sie zu Manage Apps → Trailhead MCP (Apps verwalten → Trailhead MCP) → setzen Sie alle Tools auf „Always allow“ (Immer zulassen)

Funktionstest durchführen

Probieren Sie Folgendes in Ihrer Slackbot-Direktnachricht aus:

„Trailhead MCP verwenden, um Einführungsinhalte zu Salesforce Flow zu finden.“

Tipps für optimale Ergebnisse

Durch die Auswahl von „Always allow“ (Immer zulassen) wird verhindert, dass Slackbot bei jeder Anfrage erneut um Erlaubnis bittet
Wenn Sie dies ausdrücklich angeben – „Trailhead MCP verwenden, um …“ –, wird sichergestellt, dass Slackbot Sie zum richtigen Tool weiterleitet.

Erste Schritte: Agentforce

Übersicht

Mit Trailhead MCP können Agentforce-Agents auf vertrauenswürdige Trailhead-Inhalte zurückgreifen – so sind die Agents in der Lage, Lernfragen anhand von zitierten, aktuellen Quellen zu beantworten.

Trailhead MCP hinzufügen

Suchen Sie in Setup Ihrer Organisation im Feld Quick Find (Schnellsuche) nach MCP und klicken Sie auf Registered MCP Servers (Registrierte MCP-Server)
Klicken Sie auf der Seite Agentforce Registry (Agentforce-Registrierung) auf New + (Neu +) und wählen Sie im Dropdown-Menü die Option Register MCP Server (MCP-Server registrieren) aus.
On the Create Connection modal
1. Geben Sie den MCP Server Name (MCP-Servernamen) und die Description (Beschreibung) ein, um anzugeben, wofür diese Verbindung verwendet werden soll.
2. Legen Sie die Server-URL auf https://mcp.trailhead.salesforce.com/mcp fest.
3. Stellen Sie Authentication Method (Authentifizierungsmethode) auf No Authentication (Keine Authentifizierung) ein
4. Klicken Sie auf Create and Continue (Erstellen und Weiter)
5. Klicken Sie im nächsten Abschnitt Tools auf die Schaltfläche Add Tool (Tool hinzufügen) für eines der Tools, die Sie verwenden möchten
6. Auf Zulassen und fortfahren klicken
7. Wählen Sie im nächsten Abschnitt Select policies (Optional) (Richtlinien auswählen (optional)) alle für Ihren Kundenvorgang zutreffenden Richtlinien aus.
8. Auf Save (Speichern) klicken

Empfohlene Anwendungsfälle

Helpdesk-Agents, die auf die Best-Practice-Inhalte von Trailhead zurückgreifen
Onboarding-Agents, die neue Mitarbeiter:innen zu den passenden Trailhead-Inhalten führen
Enablement-Agents, die Produktfragen unter Verweis auf offizielle Trailhead-Module beantworten

Erste Schritte: Claude und Claude-Code

Bevor Sie beginnen

Dazu müssen Claude Desktop, Claude Code oder die Claude-CLI installiert sein.

Trailhead MCP hinzufügen

Claude Code / Claude CLI – führen Sie folgenden Befehl in Ihrem Terminal aus:

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

Das Flag --scope user sorgt dafür, dass der Server für alle Ihre Claude Code-Projekte verfügbar ist.

Claude Desktop:

Öffnen Sie Claude Desktop → Settings → Developer → Edit Config (Einstellungen → Entwickler → Konfiguration bearbeiten)
Fügen Sie Folgendes zu Ihrer Datei claude_desktop_config.json hinzu:

claude_desktop_config.json

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

Speichern Sie die Änderungen und starten Sie Claude Desktop neu

Funktionstest durchführen

Probieren Sie einen der folgenden Prompts aus:

„Was empfiehlt Trailhead hinsichtlich Best Practices für die Apex-Bulk-Verarbeitung?“
„Trailhead-Inhalte zu Agentforce für Anfänger zeigen.“
„Inhalt des Einstein Trust Layer-Badges abrufen und zusammenfassen.“

In der Antwort sollten Trailhead-Inhalte aufgeführt sein. Sollte die KI auf der Grundlage von Knowledge antworten, ohne auf Trailhead Bezug zu nehmen, lesen Sie bitte den Abschnitt „Hilfe“.

Tipps für optimale Ergebnisse

Formulieren Sie präzise: „Trailhead MCP verwenden zum Finden von …“ hilft Claude dabei, das richtige Tool zu finden
Weitere Informationen finden Sie im Abschnitt „Leitfaden für Prompts“

Erste Schritte: Cursor

Bevor Sie beginnen

Sie müssen Cursor installiert haben. Cursor herunterladen.

Trailhead MCP hinzufügen

Klicken Sie auf diesen Link, damit Cursor MCP automatisch hinzufügt.

Funktionstest durchführen

Öffnen Sie ein neues Composer-Fenster (⌘+I) und versuchen Sie Folgendes:

„Trailhead nach Inhalten zu Best Practices für Flow für Administratoren durchsuchen.“

Tipps für optimale Ergebnisse

Weitere Informationen finden Sie im Abschnitt „Leitfaden für Prompts“
Trailhead MCP funktioniert am besten im Agent-Modus im Cursor Composer
Geben Sie Rolle und Ebene an, um gezieltere Ergebnisse zu erhalten (z. B. „Trailhead-Inhalte auf LWC für Entwickler, mittlere Ebene“)

Prompting-Leitfaden: Trailhead MCP optimal nutzen

Trailhead MCP ist ein Such- und Abruf-Tool – die Qualität der Ergebnisse hängt stark davon ab, wie Sie Ihre Anfrage formulieren.
Die beiden Tools und wann sie eingesetzt werden sollten

content_search – Zur Suche verwenden. Das ist ideal, wenn Sie das Thema kennen, aber nicht den genauen Namen des Badges oder Trails. Beispiel: „Trailhead-Inhalte zu Best Practices für Apex-Tests finden.“
fetch_content – Diese Option verwenden, wenn Sie genau wissen, was Sie möchten. Ruft den gesamten Inhalt des Moduls ab. Beispiel: "Inhalt des Trailhead-Badges „Apex-Trigger“ abrufen."

Falls Ihre KI weiterhin content_search verwendet, obwohl Sie den vollständigen Inhalt wünschen, formulieren präzise: "Use fetch_content to retrieve..."

Nach Rolle und Ebene filtern

Beide Tools unterstützen die Filterfunktion – und deren sinnvoller Einsatz verbessert die Ergebnisse.

Rollen: Systemadministrator:in, Entwickler:in, Architekt:in, Marketingexpert:in, Business-Analyst:in, Berater:in
Ebenen: Grundkenntnisse, mittlere Ebene oder Fortgeschrittene

Beispiel: „Trailhead-Inhalte zum Thema Datenmodellierung für erfahrene Architekten.“

Beispiel-Prompts nach Persona

Entwickler:innen

„Was empfiehlt Trailhead hinsichtlich Best Practices für die Apex-Bulk-Verarbeitung?“
„Alle Trailhead-Inhalte zum Thema LWC suchen und die wichtigsten Konzepte erläutern.“
„Trailhead-Inhalte zu SOQL und SOSL abrufen und die Unterschiede zusammenfassen.“

Admin

„Mit welchen Trailhead-Badge sollte ein:e neue:r Salesforce-Administrator:in beginnen?“
„Trailhead-Inhalte zu Salesforce Flow für Einsteiger finden.“
„Auf Trailhead nach Inhalten zu Berichten und Dashboards suchen.“

Architekt

„Trailhead nach Inhalten zur Salesforce-Datenarchitektur auf der fortgeschrittenen Ebene durchsuchen.“
„Einstein-Trust-Layer-Badge aufrufen und mir eine technische Aufschlüsselung geben.“
„Alle Trailhead-Inhalte zu Integrationsmustern und APIs finden.“

Agent-Generator

„Alle Trailhead-Inhalte zum Thema Agentforce und KI finden.“
„Was sagt Trailhead zum Thema Prompt Engineering für Salesforce?“
„Abrufen der Inhalte unter ‚Erste Schritte mit Agentforce‘ und Zusammenfassen der wichtigsten Konzepte für eine Entwicklerzielgruppe.“

Was ist zu tun, wenn die Ergebnisse nicht stimmen?

Keine Ergebnisse: Probieren Sie alternative Schlüsselwörter aus – „Flow“ vs. „Salesforce Flow“ vs. „Prozessautomatisierung“ kann zu unterschiedlichen Ergebnissen führen
Veraltete Ergebnisse: Die Inhalte werden täglich aktualisiert. Versuchen Sie es am nächsten Tag erneut oder verwenden Sie fetch_content mit dem genauen Namen
KI-Antworten aus dem allgemeinen Wissen: Fügen Sie am Anfang Ihres Prompts „Trailhead MCP verwenden, um …“ ein

Verwendung von Trailhead MCP in Agent-Konfigurationen

Wenn Sie einen Agent entwickeln und möchten, dass dieser für Salesforce-Lernfragen stets Trailhead MCP verwendet, fügen Sie Folgendes zu Ihrem Prompt oder in die Datei copilot-instructions.md ein:

Bei der Beantwortung von Fragen zu Salesforce-Produkten, -Funktionen oder -Best Practices stets die Trailhead-Tools „MCP content_search“ oder „fetch_content“ verwenden, um aktuelle und zuverlässige Trailhead-Inhalte abzurufen. In der Antwort den Badge- oder Trail-Namen angeben.

Datenschutz und Umgang mit Daten

Welche Inhalte werden angeboten

Alle von Trailhead MCP bereitgestellten Inhalte sind öffentlich zugängliche Trailhead-Inhalte – dieselben Inhalte, auf die alle Besucher:innen unter trailhead.com zugreifen können, ohne sich anzumelden. Es sind keine privaten Lerndaten, Informationen zum Account oder personalisierten Inhalte enthalten.

Authentifizierung

Keine Authentifizierung erforderlich

Unsere Datenschutzverpflichtungen

Trailhead MCP wird Ihre Daten weder verkaufen noch an Dritte weitergeben
Trailhead MCP wird Ihre Suchanfragen oder Prompts weder speichern noch erfassen noch aufbewahren
Trailhead MCP wird Ihre Interaktionen nicht zum Trainieren von KI-Modellen verwenden
Trailhead MCP greift weder auf Ihren Trailhead-Account, Ihre Badges oder Ihre Punkte zu, noch werden diese gelesen oder geändert

FAQ

Ja – die Nutzung ist kostenlos, und für den Zugriff auf öffentliche Inhalte ist kein Account erforderlich.

Nein. Alle verfügbaren Trailhead-Inhalte sind ohne Authentifizierung zugänglich.

Sie können über von MCP keine Badges erwerben oder Ihren Fortschritt nachverfolgen. Melden Sie sich bei Trailhead.com an, um auf unsere Gamification-Funktionen und personalisierten Inhalte zuzugreifen.

Inhaltsaktualisierung: Der Knowledge-Service wird täglich aktualisiert. Ganz aktuell veröffentlichte Inhalte werden möglicherweise noch nicht angezeigt.
Alternative Formulierungen: Die Suche erfolgt anhand von Stichwörtern. Synonyme spielen eine Rolle – Versuchen Sie „Flow“ vs. Salesforce Flow
Use fetch_content directly: Wenn Sie den genauen Namen des Badges oder Trails kennen, lassen Sie Ihre KI diesen anhand des Namens abrufen.

Einmal täglich.

Alle Trailhead-Inhalte sind im Umfang enthalten, einschließlich Badges (Module/Einheiten), Trails, Trailhead Journeys und Superbadges.

Nein. Trailhead MCP ist schreibgeschützt. Es werden weder Suchanfragen noch Prompts noch sonstige Benutzerdaten gespeichert. Weitere Informationen finden Sie im Abschnitt „Datenschutz und Datenverarbeitung“.

Jeder MCP-kompatible Client, der Streamable HTTP verwendet, sollte funktionieren, darunter: Slackbot, Agentforce, Claude / Claude Code, Cursor und VS Code (mit GitHub Copilot).

Stellen Sie sicher, dass Ihr Cursor-Client auf dem neuesten Stand ist und die URL des MCP-Servers unter „Settings → MCP“ (Einstellungen → MCP) korrekt eingegeben ist.

Weitere Informationen finden Sie im Abschnitt „Hilfe“ weiter unten.

Hilfe erhalten

Fehlerbehebung in Eigenregie

Lesen Sie bitte zunächst die oben stehenden FAQ – dort werden die häufigsten Probleme behandelt, darunter nicht gefundene Inhalte, 405-Fehler und kundenspezifische Einrichtungsprobleme.

Fehlerbehebung für einzelne Clients

Claude Code: Stellen Sie sicher, dass Ihr Befehl die Optionen „--transport http“ und „--scope user“ enthält
Cursor: Überprüfen Sie, ob die URL unter „Settings → MCP“ (Einstellungen → MCP) korrekt eingegeben wurde.
VS Code: Überprüfen Sie, ob Ihre MCP-Einstellungen im JSON-Format gültig sind und ob VS Code neu geladen wurde
Slackbot: Aktualisieren Sie Slack (Cmd+Shift+R / Strg+Shift+R), falls das MCP-Connector-Symbol nicht angezeigt wird

Ein Problem melden oder Feedback geben

Gehen Sie zu https://help.salesforce.com/s/cases
„Ask Agentforce“ auswählen
Angaben zum Fall über Agentforce übermitteln

Wichtig: Geben Sie stets gleich zu Beginn an, dass sich Ihr Problem auf Trailhead MCP bezieht. Dieser Support-Trail umfasst alle Trailhead-Produkte und -Inhalte. Durch die Angabe von „Trailhead MCP“ kann das Team Ihren Fall daher sofort korrekt weiterleiten und priorisieren.

Um eine möglichst schnelle Lösung zu erzielen, strukturieren Sie Ihren Fall nach folgendem Muster:

Produkt: Trailhead MCP Client: [z. B. Claude Desktop v1.2.3, Cursor 0.45, Slackbot]

Verwendeter Prompt: [der genaue Prompt oder die genaue Abfrage, die Sie ausgeführt haben]

Erwartetes Verhalten: [Was Sie erwartet hatten]

Tatsächliches Verhalten: [die Fehlermeldung oder das unerwartete Ergebnis, das Sie festgestellt haben]

Reproduzierbarkeit: [Immer / Gelegentlich / Einmalig]

Weitere Anmerkungen: [sonstige relevante Angaben, z. B. kürzlich vorgenommene Änderungen an der Konfiguration]

Ist Trailhead MCP kostenlos?

Benötige ich einen Trailhead-Account?

Kann ich über MCP Badges verdienen oder meine Fortschritte verfolgen?

Warum kann ich Inhalte nicht finden, von denen ich weiß, dass sie verfügbar sind?

Wie oft werden die Inhalte aktualisiert?

Welche Arten von Trailhead-Inhalten stehen zur Verfügung?

Werden meine Daten gespeichert oder an Salesforce übermittelt?

Welche Clients werden unterstützt?

Was soll ich tun, wenn in Cursor der Fehler „405 Method Not Allowed“ angezeigt wird?

Etwas anderes funktioniert nicht. Wo erhalte ich Hilfe?