Trailhead MCP

¿Qué significa MCP?

El protocolo de contexto de modelo (MCP) estandariza la forma de conectar asistentes de IA, como Slackbot, Claude o Cursor, a herramientas externas y fuentes de datos. Permite que los asistentes de IA accedan a información actualizada de páginas web, bases de datos y servicios en tiempo real.

¿Qué es Trailhead MCP?

Trailhead MCP es un servidor MCP gratuito y abierto que conecta su asistente de IA a todo el material de formación de Trailhead. Cuando haga preguntas a su agente de IA sobre temas relacionados con Salesforce, como "Háblame de la arquitectura de Agentforce" o "¿Para qué sirve Flow?", puede mostrarle el contenido real de Trailhead directamente donde ya esté trabajando. No es necesario abrir nuevas pestañas en el navegador, copiar y pegar la información ni preocuparse por las alucinaciones.

¿A quiénes va dirigido?

Trailhead MCP está diseñado para:

Equipos de capacitación que crean experiencias de aprendizaje con el contenido de Trailhead
Trailblazers que quieren que se encuentre contenido de aprendizaje bajo demanda en sus herramientas de IA
Desarrolladores y administradores de Salesforce que usan Claude, Cursor o VS Code en su flujo de trabajo diario
Creadores de agentes de IA que necesiten basar sus respuestas en contenido de Trailhead de confianza

¿Qué es capaz de hacer?

Trailhead MCP le ofrece dos sencillas herramientas para acceder a su contenido directamente desde su asistente de IA:

fetch_content: Encuentra todo el contenido de una insignia o ruta de aprendizaje al buscar por nombre y devuelve los resultados en formato markdown optimizado para LLM.
content_search: busque materiales de aprendizaje por tema en todo el contenido público de Trailhead. Se encontrarán insignias, rutas de aprendizaje, planes de aprendizaje de Trailhead y superbadges. Puede filtrar por función (por ejemplo, administrador, desarrollador, arquitecto) y nivel de habilidad (básico, intermedio o avanzado). Así ahorrará tiempo buscando en cientos de insignias y rutas de aprendizaje para encontrar lo importante.

Limitaciones de Trailhead MCP

Es importante tener en cuenta que Trailhead MCP no sustituye la experiencia completa e interactiva de Trailhead que puede obtener en trailhead.com con sus rutas de aprendizaje estructuradas y sus características de gamificación. No podrá obtener insignias ni llevar un seguimiento del progreso de su aprendizaje mediante MCP. Tampoco podrá acceder a sus datos privados de estudiante ni a la información de su cuenta en su estado actual.

Clientes admitidos

Slackbot
Agentforce
Claude/Claude Code
Cursor
Cualquier cliente compatible con MCP que use el protocolo HTTP streamable

Punto final de servidor

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

El servidor está siempre activo, no hay nada que alojar ni implementar.

Autenticación y acceso

No se necesita autenticación para acceder al contenido público de Trailhead (estado actual).

Ámbito de contenido

Trailhead MCP ofrece acceso a insignias y rutas de aprendizaje disponibles públicamente. Los planes de aprendizaje de Trailhead y las superbadges estarán disponibles próximamente. El contenido se actualiza a diario para garantizar que disponga de los materiales de aprendizaje más recientes.

Primeros pasos con Slackbot

Antes de empezar

Necesitará acceso a un espacio de trabajo de Slack en el que Trailhead MCP esté disponible. El administrador de su espacio de trabajo de Slack debe activar la aplicación Trailhead MCP.

Agregue Trailhead MCP al espacio de trabajo de Slack

Visite https://api.slack.com/apps y, si su espacio de trabajo es lo suficientemente potente, debe ver el botón "Create New App (Crear nueva aplicación)".
Haga clic en "Create New App (Crear nueva aplicación)" y seleccione " From a Manifest (Desde un archivo de manifiesto)".
Elija su espacio de trabajo y haga clic en "Next (Siguiente)".
En el modal de manifiesto, en "Create app (Crear aplicación)", introduzca el siguiente JSON de manifiesto:

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

En el modal Review summary & create your app, revise todos los ajustes y haga clic en "Create Enable Trailhead MCP (Crear y activar Trailhead MCP)" en Slackbot.
Abra cualquier conversación con Slackbot (o comience una nueva).
Haga clic en el icono App integrations (Integraciones de aplicaciones) en el redactor de mensajes. Primero, refresque Slack si no lo ve (Cmd+Mayús+R en Mac o Ctrl+Mayús+R en Windows/Linux).
Busca Trailhead MCP y haz clic para añadirlo.
Para obtener los mejores resultados, vaya a Manage Apps (Gestionar aplicaciones) → Trailhead MCP → defina todas las herramientas en Always allow (Permitir siempre).

Verifique que funciona

En la conversación con Slackbot, pruebe:

"Usa Trailhead MCP para encontrar contenido de Salesforce Flow para principiantes".

Consejos para obtener los mejores resultados

Definir las herramientas en "Always allow (Permitir siempre)" evita que Slackbot pida permiso en cada solicitud.
Se debe ser explícito ("Usa Trailhead MCP para...") garantiza que Slackbot apunte a la herramienta adecuada.

Información general: Agentforce

Descripción general

Trailhead MCP se puede usar para entrenar a los agentes de Agentforce con contenido de Trailhead de confianza, lo que permite que los agentes respondan preguntas con material actualizado y que se pueda citar.

Agregue Trailhead MCP

En Setup (Configuración) de su organización, en el recuadro Quick Find (Búsqueda rápida), busque MCP y haga clic en Registered MCP Servers (Servidores MCP registrados).
En la página Registro de Agentforce, haga clic en Nuevo + y, en el menú desplegable, haga clic en Registrar servidor MCP.
On the Create Connection modal
1. Ajuste el nombre del servidor MCP y la descripción para explicar para qué se va a usar esta conexión.
2. Defina la Server URL (URL del servidor) en https://mcp.trailhead.salesforce.com/mcp
3. Defina el Authentication Method (Método de autenticación) en No Authentication
4. Haga clic en Create and Continue (Crear y continuar)
5. En la siguiente sección, Tools (Herramientas), haga clic en el botón Add Tool (Añadir herramienta) para añadir las herramientas que vaya a usar.
6. Haga clic en Allow and Continue (Permitir y continuar)
7. En la siguiente sección, Select policies (Optional) [Seleccionar políticas (opcional)], seleccione las políticas aplicables a su caso de uso.
8. Haga clic en Save (Guardar).

Casos de uso recomendados

Mostrar a los agentes del servicio de asistencia las prácticas recomendadas de Trailhead.
Incorporar a agentes que guíen a los nuevos empleados hacia el contenido de Trailhead correcto.
Habilitar a los agentes para que respondan preguntas sobre productos citando módulos oficiales de Trailhead.

Información general: Claude y Claude Code

Antes de empezar

Necesitará tener instalado Claude Desktop, Claude Code o la CLI de Claude.

Agregue Trailhead MCP

Claude Code/CLI de Claude - Ejecute lo siguiente en su terminal:

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

El indicador de --scope user hace que el servidor esté disponible en todos sus proyectos de Claude Code.

Claude Desktop:

Abra Claude Desktop → Settings (Configuración) → Developer (Desarrollador) → Edit Config (Editar configuración).
Añada lo siguiente a su archivo claude_desktop_config.json:

claude_desktop_config.json

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

Guarde y reinicie Claude Desktop.

Verifique que funciona

Pruebe una de estas solicitudes:

"¿Qué dice Trailhead sobre las prácticas recomendadas de masificación de Apex?"
"Encuentra contenido de Trailhead sobre Agentforce para principiantes".
"Obtén el contenido de la insignia de la Capa de Confianza de Einstein y resúmela".

Debería ver el contenido de Trailhead citado en la respuesta. Si la respuesta de la IA es general y no cita Trailhead, consulte la sección Obtener ayuda.

Consejos para obtener los mejores resultados

Sea explícito: Las solicitudes como "Usa Trailhead MCP para encontrar..." ayudan a Claude a apuntar a la herramienta correcta.
Consulte la sección Guía de solicitudes para más información.

Información general: Cursor

Antes de empezar

Necesitará tener instalado Cursor. Descargar Cursor.

Agregue Trailhead MCP

Haga clic en este enlace para que Cursor añada MCP automáticamente.

Verifique que funciona

Abra una nueva ventana de Composer (⌘+I) y pruebe:

"Buscar en Trailhead prácticas recomendadas para administradores de Flow".

Consejos para obtener los mejores resultados

Consulte la sección Guía de solicitudes para más información.
Trailhead MCP funciona mejor en el Agent mode (modo Agente) en Cursor Composer.
Especifique la función y el nivel para obtener resultados más específicos (por ejemplo, "Contenido de Trailhead sobre LWC para desarrolladores a nivel intermedio").

Guía de solicitudes: saque el máximo partido de Trailhead MCP

Trailhead MCP es una herramienta de búsqueda. La calidad de lo que encuentre depende en gran medida de lo que pregunte.
Estas son las dos herramientas y cómo usarlas:

content_search: Úselo para buscar. Resulta ideal cuando conoce el tema pero no el nombre exacto de la insignia o la ruta de aprendizaje. Ejemplo: "Busca en Trailhead contenido sobre las prácticas recomendadas de pruebas de Apex".
fetch_content: Úselo cuando sepa exactamente lo que desea. Extrae el contenido del módulo completo. Ejemplo: "Obtén el contenido de la insignia 'Desencadenadores de Apex' de Trailhead".

Si la IA sigue usando content_search cuando lo que desea es el contenido completo, sea explícito: "Usa fetch_content para encontrar..."

Filtrar por función y nivel

En ambas herramientas se pueden establecer filtros y usarlos mejora los resultados significativamente.

Funciones: Administrador, desarrollador, arquitecto, experto en marketing, analista comercial o asesor.
Niveles: Básico, intermedio y avanzado.

Ejemplo: "Encuentra contenido de Trailhead en el modelado de datos para arquitectos a nivel avanzado".

Ejemplos de solicitudes por función

Desarrollador

"¿Qué dice Trailhead sobre las prácticas recomendadas de masificación de Apex?"
"Encuentra en Trailhead todo el contenido relacionado con LWC y explica los conceptos básicos".
"Extrae el contenido de SOQL y SOSL en Trailhead y haz un resumen de las diferencias entre ellos".

Administrador

"¿Con qué insignias de Trailhead debe empezar un administrador de Salesforce?"
"Encuentra contenido de Trailhead sobre Salesforce Flow para principiantes".
"Busca en Trailhead contenido sobre informes y paneles de control".

Arquitecto

"Busca en Trailhead contenido de nivel avanzado sobre la arquitectura de datos de Salesforce".
"Proporcióname un desglose técnico de la insignia de la Capa de Confianza de Einstein".
"Encuentra todo el contenido de Trailhead sobre patrones y API de integración".

Generador de agentes

"Encuentra todo el contenido de Trailhead relacionado con Agentforce y la IA".
"¿Qué dice Trailhead sobre la ingeniería de solicitudes de Salesforce?"
"Obtén el contenido de 'Primeros pasos con Agentforce' y resume los principales aspectos para desarrolladores".

Qué hacer cuando los resultados no están bien

No hay ningún resultado: Prueba otras palabras clave: "Flow", "Salesforce Flow" y "automatización de procesos" devolverán resultados distintos.
Resultados obsoletos: El contenido se actualiza a diario. Vuelva a intentarlo al día siguiente o utilice fetch_content con el nombre exacto.
Respuestas de IA demasiado generales: Añada "Usa Trailhead MCP para..." al principio de la solicitud.

Uso de Trailhead MCP en configuraciones de agentes

Si va a crear un agente y desea que siempre use Trailhead MCP para las preguntas sobre Salesforce, agréguelo a la solicitud del sistema o a copilot-instructions.md:

Al responder preguntas sobre productos, funciones o prácticas recomendadas de Salesforce, use siempre Trailhead MCP content_search o fetch_content tools para obtener contenido actualizado y de confianza de Trailhead. Cite la insignia o nombre de la ruta de aprendizaje en su respuesta.

Gestión de privacidad y datos

¿Qué contenido se ofrece?

Todo el contenido que proporciona Trailhead MCP es contenido de Trailhead disponible públicamente, el mismo al que se puede acceder en trailhead.com sin iniciar sesión. No se incluyen datos privados del alumnado, información sobre cuentas ni contenido personalizado.

Autenticación

No se necesita autenticación.

Nuestro compromiso con los datos

Trailhead MCP no venderá ni compartirá sus datos con terceros.
Trailhead MCP no almacenará, recopilará ni retendrá sus consultas o solicitudes.
Trailhead MCP no usará sus interacciones para entrenar modelos de IA.
Trailhead MCP no accederá a su cuenta, insignias ni puntos de Trailhead, ni los leerá o modificará.

Preguntas frecuentes

Sí, es gratuito usarlo y no se requiere una cuenta para acceder a contenido público.

No. Se puede acceder a todo el contenido disponible de Trailhead sin autenticación.

No puede obtener insignias ni llevar un seguimiento de su progreso en el MCP. Inicie sesión en Trailhead.com para acceder a nuestro contenido personalizado y gamificado.

Actualización del contenido: La información se actualiza a diario. Es posible que el contenido publicado muy recientemente no aparezca todavía.
La frase se ha formulado usando otras palabras: La búsqueda es por palabras clave. Es importante usar sinónimos: pruebe "Flow" y compárelo con "Salesforce Flow".
Use fetch_content directamente: Si conoce el nombre exacto de la insignia o la ruta de aprendizaje, pregunte a la IA que busque por nombre.

Una vez al día.

Está disponible todo el contenido de Trailhead, incluyendo las insignias (módulos/unidades), rutas de aprendizaje, planes de aprendizaje de Trailhead y superbadges.

No. Trailhead MCP es una aplicación de solo lectura. No almacena consultas, solicitudes ni ningún otro dato de los usuarios. Consulte la sección Gestión de privacidad y datos para más información.

Cualquier cliente compatible con MCP que use el protocolo HTTP streamable debería funcionar, como estos: Slackbot, Agentforce, Claude/Claude Code, Cursor y VS Code (con GitHub Copilot).

Asegúrese de que su cliente de Cursor está actualizado y que se ha introducido correctamente la URL del servidor MCP en "Settings (Configuración)” → MCP.

Consulte la sección Obtener ayuda a continuación.

Obtener ayuda

Autoservicio de resolución de problemas

Compruebe primero las preguntas frecuentes que aparecen arriba, en ellas aparecen los problemas más comunes, como que no se encuentra contenido, errores 405 y problemas de configuración específicos del cliente.

Resolución de problemas por cliente

Claude Code: Verifique que su comando incluye --transport http y --scope user.
Cursor: Confirme que ha introducido correctamente la URL en "Settings (Configuración)” → MCP
VS Code: Confirme que el archivo JSON con los ajustes de MCP es válido y recargue VS Code.
Slackbot: pruebe a refrescar Slack (Cmd+Mayús+R/Ctrl+Mayús+R) si no se ve el icono del conector de MCP.

Informar de un problema o enviar comentarios

Vaya a https://help.salesforce.com/s/cases.
Seleccione "Ask Agentforce (Preguntarle a Agentforce)"
Envíe los detalles de su caso a través de Agentforce

Importante: Mencione siempre que su problema está relacionado con Trailhead MCP. Esta ruta de asistencia cubre todos los productos y ofertas de contenido de Trailhead, así que al mencionar "Trailhead MCP", el equipo puede localizar y clasificar inmediata y correctamente su caso.

Para solucionar los problemas más rápido, organice su caso en este formato:

Producto: Cliente de Trailhead MCP: [por ejemplo, Claude Desktop v1.2.3, Cursor 0.45, Slackbot]

Solicitud usada: [solicitud o consulta exacta que ha ejecutado]

Comportamiento esperado: [lo que espera que pase]

Comportamiento real: [mensaje de error o resultado inesperado que ha visto]

Capacidad de reproducción: [siempre/intermitente/solo una vez]

Notas adicionales: [cualquier otro dato relevante, por ejemplo, cambios de configuración recientes]

¿Es gratuito Trailhead MCP?

¿Necesito una cuenta de Trailhead?

¿Puedo obtener insignias o llevar un seguimiento de mi progreso en el MCP?

¿Por qué no encuentro contenido que sé que está disponible?

¿Con cuánta frecuencia se actualiza el contenido?

¿Qué tipos de contenido de Trailhead hay disponibles?

¿Mis datos se envían a Salesforce o se almacenan allí?

¿Qué clientes se admiten?

¿Qué hago si Cursor me devuelve un error "405 - Método no permitido"?

Hay algo más que no funciona. ¿Dónde puedo obtener ayuda?