Trailhead MCP

Cos'è MCP?

Lo standard MCP (Model Context Protocol) definisce le modalità con cui assistenti AI, come Slackbot, Claude o Cursor, si connettono a strumenti esterni e fonti di dati. Consente ad assistenti AI di accedere in tempo reale a informazioni aggiornate provenienti da siti Web, database e servizi.

Cos'è Trailhead MCP?

Trailhead MCP è un server MCP gratuito e open source che connette il tuo assistente AI a tutto il materiale didattico di Trailhead. Quando poni domande al tuo agente AI su argomenti relativi a Salesforce, ad esempio: "Parlami dell'architettura di Agentforce" o "A cosa serve Flow?", l'agente è in grado di trovare e mostrarti contenuti effettivi di Trailhead, proprio nell'ambiente in cui stai già lavorando. Non è necessario aprire nuove schede del browser, copiare e incollare informazioni o preoccuparsi delle allucinazioni.

A chi è rivolto?

Trailhead MCP è progettato per:

Team di abilitazione che sviluppano esperienze di apprendimento basate su contenuti Trailhead
Trailblazer che desiderano che i contenuti per l'apprendimento on-demand vengano proposti nei propri strumenti AI
Sviluppatori e amministratori di Salesforce che utilizzano Claude, Cursor o VS Code nel proprio flusso di lavoro quotidiano
Sviluppatori di agenti AI i cui team stanno realizzando agenti che devono basare le risposte su contenuti affidabili di Trailhead

Cosa può fare?

Trailhead MCP ti offre due semplici strumenti per accedere ai propri contenuti direttamente dal tuo assistente AI:

fetch_content: recupera il contenuto completo di un badge o un percorso in base al nome, restituito in formato Markdown ottimizzato per LLM.
content_search: cerca materiali didattici per argomento tra tutti i contenuti pubblici di Trailhead. Ciò consente di individuare badge, itinerari, percorsi Trailhead e superbadge. Puoi filtrare i risultati in base al ruolo (ad esempio, Amministratore, Sviluppatore, Architetto) e al livello di competenza (Base, Intermedio o Avanzato). Ciò ti consente di non perdere tempo a sfogliare centinaia di badge e itinerari per trovare quelli pertinenti.

Vincoli di Trailhead MCP

È importante sottolineare che Trailhead MCP non è pensato per sostituire l'esperienza completa e interattiva di Trailhead disponibile su trailhead.com con i relativi percorsi di apprendimento strutturati e le relative funzioni di gamification. Non potrai ottenere badge né monitorare i tuoi progressi di apprendimento tramite l'MCP, che, nella sua forma attuale, non accede ai tuoi dati privati di apprendimento né alle informazioni del tuo account.

Client supportati

Slackbot
Agentforce
Claude/Claude Code
Cursor
Tutti i client compatibili con MCP che utilizzano Streamable HTTP

Endpoint del server

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

Il server è sempre in funzione: non c'è nulla da ospitare o da distribuire.

Autenticazione e accesso

Nessuna autenticazione richiesta per accedere a contenuti pubblici di Trailhead (stato corrente)

Ambito dei contenuti

Trailhead MCP offre accesso a badge e itinerari disponibili al pubblico. A breve saranno disponibili anche superbadge e percorsi Trailhead. I contenuti vengono aggiornati quotidianamente per garantirti materiali didattici sempre aggiornati.

Inizia subito: Slackbot

Prima di iniziare

Dovrai avere accesso a uno spazio di lavoro Slack in cui sia disponibile Trailhead MCP. L'app Trailhead MCP deve essere abilitata per il tuo spazio di lavoro dall'amministratore di Slack.

Aggiungi Trailhead MCP allo spazio di lavoro Slack

Visita https://api.slack.com/apps e, se disponi di autorizzazioni sufficienti nel tuo spazio di lavoro, dovresti vedere il pulsante Create New App (Crea nuova app).
Fai clic su Create New App (Crea nuova app), quindi seleziona Da manifest
Scegli il tuo spazio di lavoro, quindi fai clic su Avanti
Nella finestra modale Create app from Manifest (Crea app da manifest), inserisci il seguente file manifest JSON:

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"
        }
    }
}

Nella finestra modale Review summary & create your app (Rivedi il riepilogo e crea la tua app), verifica tutte le impostazioni, quindi fai clic su Create Enable Trailhead MCP in Slackbot (Crea e abilita Trailhead MCP in Slackbot)
Apri una conversazione con Slackbot (o avvia un nuovo messaggio diretto)
Fai clic sull'icona App integrations (Integrazioni app) nel composer dei messaggi. Se non la vedi, aggiorna prima Slack (Cmd+Shift+R su Mac o Ctrl+Shift+R su Windows/Linux)
Cerca Trailhead MCP e selezionalo per aggiungerlo
Per risultati ottimali: vai a Manage Apps (Gestisci app) → Trailhead MCP → imposta tutti gli strumenti su "Always allow" (Consenti sempre)

Verifica che funzioni

Nei messaggi diretti con Slackbot, prova:

"Utilizza Trailhead MCP per trovare contenuti per principianti su Salesforce Flow".

Suggerimenti per risultati ottimali

Impostando gli strumenti su "Always allow" (Consenti sempre) si impedisce a Slackbot di chiedere l'autorizzazione a ogni richiesta
Specificare chiaramente: "Usa Trailhead MCP per..." consente a Slackbot di indirizzare la richiesta allo strumento appropriato

Come iniziare: Agentforce

Panoramica

Trailhead MCP può essere utilizzato per fornire ad agenti Agentforce contenuti Trailhead affidabili, consentendo loro di rispondere a domande di apprendimento con materiale aggiornato e corredato di citazioni.

Aggiungi Trailhead MCP

In Setup (Configurazione) per la tua organizzazione, nella casella Quick Find (Ricerca rapida), cerca MCP e fai clic su Registered MCP Servers (Server MCP registrati)
Nella pagina Agentforce Registry (Registro Agentforce), fai clic su New + (Nuovo +) e nel menu a discesa fai clic su Register MCP Server (Registra MCP Server)
On the Create Connection modal
1. Imposta MCP Server Name (Nome server MCP) e Description (Descrizione) per fornire dettagli sull'utilizzo previsto di questa connessione.
2. Imposta Server URL (URL server) su https://mcp.trailhead.salesforce.com/mcp
3. Imposta Authentication Method (Metodo di autenticazione) su No Authentication (Nessuna autenticazione)
4. Fai clic su Create and Continue (Crea e continua)
5. Nella sezione successiva, Tools (Strumenti), fai clic sul pulsante Add Tool (Aggiungi strumento) accanto a uno degli strumenti che intendi utilizzare
6. Fai clic su Allow and Continue (Consenti e continua)
7. Nella sezione successiva Select policies (Optional) (Seleziona policy (opzionale)), seleziona le policy applicabili al tuo caso d'uso.
8. Fai clic su Save (Salva)

Casi d'uso consigliati

Agenti dell'help desk supportati dalle best practice di Trailhead
Agenti di onboarding che indirizzano nuovi dipendenti verso i contenuti Trailhead appropriati
Agenti di abilitazione che rispondono a domande su prodotti facendo riferimento a moduli ufficiali di Trailhead

Come iniziare: Claude e Claude Code

Prima di iniziare

È necessario che sia installato Claude Desktop, Claude Code o la CLI di Claude.

Aggiungi Trailhead MCP

Claude Code/Claude CLI: esegui questo comando nel tuo terminale:

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

Il flag --scope user rende il server disponibile in tutti i tuoi progetti Claude Code.

Claude Desktop:

Apri Claude Desktop → Settings (Impostazioni) → Developer (Sviluppatore) → Edit Config (Modifica configurazione)
Aggiungi quanto segue al tuo file claude_desktop_config.json:

claude_desktop_config.json

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

Salva e riavvia Claude Desktop

Verifica che funzioni

Prova uno di questi prompt:

"Quali indicazioni fornisce Trailhead sulle best practice per la gestione in blocco in Apex?"
"Trova contenuti di Trailhead su Agentforce per principianti".
"Estrai il contenuto del badge Einstein Trust Layer e riassumilo".

Nella risposta dovresti vedere i contenuti Trailhead citati. Se l'AI risponde attingendo alle proprie conoscenze generali senza citare Trailhead, consulta la sezione "Chiedere aiuto".

Suggerimenti per risultati ottimali

Indica esplicitamente: "Usa Trailhead MCP per trovare..." per aiutare Claude a indirizzarti verso lo strumento appropriato
Per ulteriori dettagli, vai alla sezione Guida al prompting

Come iniziare: Cursor

Prima di iniziare

È necessario che Cursor sia installato. Scarica Cursor.

Aggiungi Trailhead MCP

Fai clic su questo link affinché Cursor aggiunga automaticamente l'MCP

Verifica che funzioni

Apri una nuova finestra di Composer (⌘+I) e prova quanto segue:

"Cerca su Trailhead contenuti relativi alle best practice di Flow per amministratori".

Suggerimenti per risultati ottimali

Per ulteriori dettagli, vai alla sezione Guida al prompting
Trailhead MCP funziona al meglio in Modalità agente in Cursor Composer
Specifica il ruolo e il livello per ottenere risultati più mirati (ad es., "Contenuti Trailhead su LWC per sviluppatori, livello intermedio")

Guida al prompting: ottieni il massimo da Trailhead MCP

Trailhead MCP è uno strumento di ricerca e recupero: la qualità dei risultati ottenuti dipende in gran parte da come si formula la richiesta.
I due strumenti e quando utilizzarli

content_search: usa questa funzione per cercare contenuti. Ideale quando conosci l'argomento ma non il nome esatto del badge o del percorso. Esempio: "Cerca contenuti Trailhead su best practice per test Apex".
fetch_content: usa questa funzione quando sai esattamente ciò che desideri cercare. Consente di recuperare l'intero contenuto del modulo. Esempio: "Recupera il contenuto del badge Trailhead Trigger Apex".

Se l'AI continua a utilizzare content_search quando desideri un contenuto completo, specifica chiaramente: "Usa fetch_content per recuperare..."

Filtra per ruolo e livello

Entrambi gli strumenti supportano il filtraggio e il relativo utilizzo migliora sensibilmente i risultati.

Ruoli: Amministratore, Sviluppatore, Architetto, Esperto di marketing, Analista aziendale, Consulente
Livelli: Base, Intermedio, Avanzato

Esempio: "Scopri i contenuti di Trailhead sulla modellazione dei dati per architetti di livello avanzato".

Esempi di prompt per persona

Sviluppatore

"Quali indicazioni fornisce Trailhead sulle best practice per la gestione in blocco in Apex?"
"Trova tutti i contenuti di Trailhead relativi a LWC e spiega i concetti chiave".
"Recupera contenuti di Trailhead su SOQL e SOSL e riassumi le differenze".

Amministratore

"Con quali badge di Trailhead dovrebbe iniziare un nuovo amministratore Salesforce?"
"Trova contenuti di Trailhead su Salesforce Flow per principianti".
"Cerca su Trailhead contenuti relativi a report e dashboard".

Architetto

"Cerca su Trailhead contenuti relativi all'architettura dei dati di Salesforce a livello avanzato".
"Recupera il badge Einstein Trust Layer e forniscimi un'analisi tecnica dettagliata".
"Scopri tutti i contenuti di Trailhead su modelli di integrazione e API".

Agent Builder

"Scopri tutti i contenuti di Trailhead relativi ad Agentforce e all'AI".
"Cosa dice Trailhead riguardo all'ingegneria dei prompt per Salesforce?"
"Recupera il contenuto della Guida introduttiva ad Agentforce e riassumi i concetti chiave per un pubblico di sviluppatori".

Cosa fare quando i risultati non sembrano corretti

Nessun risultato: prova parole chiave alternative, ad esempio "Flow", "Salesforce Flow" e "automazione processo" potrebbero restituire risultati differenti
Risultati non aggiornati: i contenuti vengono aggiornati quotidianamente. Riprova il giorno successivo o utilizza fetch_content con il nome esatto
Risposte AI basate su conoscenze generali: Aggiungi "Usa Trailhead MCP a..." all'inizio del prompt

Uso di Trailhead MCP in configurazioni di agenti

Se stai creando un agente e desideri che utilizzi sempre Trailhead MCP per domande di apprendimento su Salesforce, aggiungi quanto segue al prompt di sistema o al file copilot-instructions.md:

Quando rispondi a domande su prodotti, funzioni o best practice di Salesforce, utilizza sempre gli strumenti content_search o fetch_content di Trailhead MCP per recuperare contenuti Trailhead aggiornati e affidabili. Nella risposta, indica il nome del badge o del percorso.

Privacy e gestione dei dati

Quali contenuti vengono forniti

Tutti i contenuti forniti da Trailhead MCP sono contenuti Trailhead disponibili al pubblico, ovvero gli stessi contenuti a cui qualsiasi visitatore può accedere su trailhead.com senza effettuare l'accesso. Non sono inclusi dati privati di studenti, informazioni di account o contenuti personalizzati.

Autenticazione

Nessuna autenticazione richiesta

I nostri impegni in materia di dati

Trailhead MCP non venderà né condividerà i tuoi dati con terze parti
Trailhead MCP non archivierà, raccoglierà né conserverà le tue query o i tuoi prompt
Trailhead MCP non utilizzerà le tue interazioni per addestrare modelli AI
Trailhead MCP non accederà, non leggerà né modificherà il tuo account Trailhead, i tuoi badge o i tuoi punti

Domande frequenti

Sì, l'utilizzo è gratuito e non è necessario creare un account per accedere a contenuti pubblici.

No. Tutti i contenuti disponibili su Trailhead sono accessibili senza autenticazione.

Puoi ottenere badge o monitorare i tuoi progressi tramite MCP. Accedi a Trailhead.com per usufruire dei nostri contenuti personalizzati e delle funzioni di gamification.

Aggiornamento contenuti: il servizio di informazioni viene aggiornato quotidianamente. I contenuti appena pubblicati potrebbero non essere ancora visibili.
Formulazioni alternative: la ricerca è basata su parole chiave. I sinonimi possono fare la differenza. Prova con "Flow" anziché "Salesforce Flow".
Usa fetch_content direttamente: Se conosci il nome esatto del badge o del percorso, chiedi all'AI di recuperarlo in base al nome.

Una volta al giorno.

Sono inclusi tutti i contenuti di Trailhead, compresi badge (moduli/unità), itinerari, percorsi Trailhead e superbadge.

No. Trailhead MCP è in sola lettura. Non archivia query, prompt o dati degli utenti. Per ulteriori dettagli, consulta la sezione Privacy e gestione dei dati.

Sono supportati tutti i client compatibili con MCP che utilizzano Streamable HTTP, inclusi: Slackbot, Agentforce, Claude/Claude Code, Cursor e VS Code (con GitHub Copilot).

Assicurati che il client Cursor sia aggiornato e che l'URL del server MCP sia inserito correttamente in Impostazioni → MCP.

Consulta la sezione Chiedere aiuto riportata di seguito.

Chiedere aiuto

Risoluzione dei problemi self-service

Consulta innanzitutto le domande frequenti sopra riportate: trattano i problemi più comuni, tra cui contenuti non trovati, errori 405 e problemi di configurazione specifici del client.

Risoluzione dei problemi per client

Claude Code: Verifica che il tuo comando includa --transport http e --scope user
Cursor: Verifica che l'URL sia stato inserito correttamente in Settings → MCP (Impostazioni → MCP)
VS Code: verifica che il file JSON delle impostazioni MCP sia valido e che VS Code sia stato ricaricato
Slackbot: prova ad aggiornare Slack (Cmd+Shift+R/Ctrl+Shift+R) se l'icona del connettore MCP non è visibile

Segnala un problema o invia un feedback

Vai a https://help.salesforce.com/s/cases
Seleziona Ask Agentforce (Chiedi ad Agentforce)
Invia i dettagli del tuo caso tramite Agentforce

Importante: specifica sempre fin dall'inizio che il tuo problema riguarda Trailhead MCP. Questo percorso di assistenza copre tutti i prodotti e contenuti offerti da Trailhead, quindi specificare "Trailhead MCP" aiuta immediatamente il team a indirizzare e classificare correttamente il tuo caso.

Per ottenere una risoluzione più rapida, struttura il tuo caso utilizzando il seguente formato:

Prodotto: Client Trailhead MCP: [ad es. Claude Desktop v1.2.3, Cursor 0.45, Slackbot]

Prompt utilizzato: [prompt esatto o query eseguita]

Comportamento previsto: [ciò che ti aspettavi che si verificasse]

Comportamento effettivo: [il messaggio di errore o il risultato imprevisto visualizzato]

Riproducibilità: [Sempre/Intermittente/Una tantum]

Note aggiuntive: [altri dati rilevanti, ad es. recenti modifiche alla configurazione]

Trailhead MCP è gratuito?

Devo avere un account Trailhead?

Posso ottenere badge o monitorare i miei progressi tramite MCP?

Perché non riesco a trovare contenuti che so essere disponibili?

Con che frequenza vengono aggiornati i contenuti?

Quali tipi di contenuti sono disponibili su Trailhead?

I miei dati vengono archiviati o inviati a Salesforce?

Quali client sono supportati?

Cosa fare se viene visualizzato l'errore "405 Method Not Allowed" (405 Metodo non consentito) in Cursor?

C'è qualcos'altro che non funziona. Dove posso chiedere aiuto?