Trailhead MCP

¿Qué es MCP?

MCP (Protocolo de contexto de modelo) estandariza la forma en que los asistentes de IA como Slackbot, Claude o Cursor se conectan a herramientas y fuentes de datos externas. Permite que los asistentes de IA accedan a información actualizada de sitios web, bases de datos y servicios en tiempo real.

¿Qué es Trailhead MCP?

Trailhead MCP es un servidor de MCP gratuito y abierto que conecta tu asistente de IA con todo el material de aprendizaje de Trailhead. Cuando le haces preguntas a tu agente de IA sobre temas de Salesforce, como “¿Puedes hablarme de la arquitectura de Agentforce?” o “¿Para qué sirve el flujo?”, puede encontrar y mostrarte el contenido real de Trailhead, justo donde ya estás trabajando. No es necesario abrir nuevas pestañas del navegador, copiar y pegar información ni preocuparse por las alucinaciones.

¿Para quién es esto?

Trailhead MCP está diseñado para:

Equipos de habilitación que crean experiencias de aprendizaje impulsadas por el contenido de Trailhead
Trailblazers que desean que el contenido de aprendizaje bajo demanda aparezca en sus herramientas de IA
Desarrolladores y administradores de Salesforce que utilizan Claude, Cursor o VS Code en su flujo de trabajo diario.
Desarrolladores de agentes de IA cuyos equipos están creando agentes que necesitan basar sus respuestas en contenido confiable de Trailhead

¿Qué puede hacer?

Trailhead MCP te ofrece dos herramientas sencillas para acceder a su contenido directamente en tu asistente de IA:

fetch_content: recupera el contenido completo de la insignia o de la ruta por nombre, mostrado en formato Markdown optimizado para LLM.
content_search: busca materiales de aprendizaje por tema en todo el contenido público de Trailhead. Aquí se encuentran insignias, rutas, journeys de Trailhead, and superinsignias. Puedes filtrar por función (p. ej., administrador, desarrollador, arquitecto) y nivel de habilidad (básico, intermedio o avanzado). Esto te ahorra tiempo al evitar tener que buscar entre cientos de insignias y rutas para encontrar lo que te interesa.

Restricciones de Trailhead MCP

Es importante tener en cuenta que Trailhead MCP no pretende reemplazar la experiencia interactiva completa de Trailhead que se obtiene en trailhead.com con sus rutas de aprendizaje estructuradas y funciones de gamificación. No podrás obtener insignias ni realizar un seguimiento de tu progreso de aprendizaje a través del MCP, ni tampoco este accede a ninguno de tus datos privados de aprendizaje o información de cuenta en su formato actual.

Clientes atendidos

Slackbot
Agentforce
Claude/Claude Code
Cursor
Cualquier cliente compatible con MCP que utilice Streamable HTTP

Extremo del servidor

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

El servidor siempre está en funcionamiento; no hay nada que alojar ni implementar.

Autenticación y acceso

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

Alcance del contenido

El programa Trailhead MCP proporciona acceso a insignias y rutas disponibles al público, y próximamente estarán disponibles journeys de Trailhead y superinsignias. El contenido se actualiza diariamente para garantizar que dispongas de los materiales de aprendizaje más recientes.

Comienza ahora: Slackbot

Antes de empezar

Necesitarás acceso a un espacio de trabajo de Slack donde esté disponible Trailhead MCP. La aplicación Trailhead MCP debe estar habilitada para tu espacio de trabajo por tu administrador de Slack.

Agrega Trailhead MCP al espacio de trabajo de Slack

Visita https://api.slack.com/apps y, si tienes suficiente poder dentro de tu espacio de trabajo, deberías ver un botón Create New App (Crear nueva aplicación).
Haz clic en Create New App (Crear nueva aplicación) y selecciona From a Manifest (Desde un manifiesto)
Selecciona tu espacio de trabajo y haz clic en Next (Siguiente)
En la ventana modal Create app from Manifest (Crear aplicación desde manifiesto), introduce 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 la ventana modal Review summary & create your app (Revisar resumen y crear tu aplicación), revisa la configuración y, luego, haz clic en Create Enable Trailhead MCP (Crear y habilitar Trailhead MCP) en Slackbot
Inicia cualquier plática con Slackbot (o inicia un nuevo mensaje directo)
Haz clic en el ícono App integrations (Integraciones de aplicaciones) en el redactor de mensajes; actualiza Slack primero si no lo ves (Cmd+Shift+R en Mac, Ctrl+Shift+R en Windows/Linux)
Busca Trailhead MCP y haz clic para agregarlo.
Para obtener mejores resultados: ve a Manage Apps (Administrar aplicaciones) → Trailhead MCP → configura todas las herramientas en "Always allow" (Permitir siempre)

Verifica que funcione

En tu mensaje directo de Slackbot, prueba lo siguiente:

“Utiliza Trailhead MCP para encontrar contenido para principiantes sobre el flujo de Salesforce”.

Consejos para obtener los mejores resultados

Configurar las herramientas en “Always allow” (Permitir siempre) evita que Slackbot pida permiso en cada solicitud.
Ser explícito, “Usa Trailhead MCP para…”, garantiza que Slackbot dirija a la herramienta correcta

Comienza ahora: Agentforce

Descripción general

Trailhead MCP se puede utilizar para que los agentes de Agentforce se basen en contenido confiable de Trailhead, lo que les permite responder a preguntas de aprendizaje con material citado y actualizado.

Agrega Trailhead MCP

En Setup (Configuración) de tu organización, en el cuadro Quick Find (Búsqueda rápida), busca MCP y haz clic en Registered MCP Servers (Servidores MCP registrados).
En la página Agentforce Registry (Registro de Agentforce), haz clic en New + (Nuevo +) y, en el menú desplegable, haz clic en Register MCP Server (Registrar servidor del MCP).
On the Create Connection modal
1. Configura los campos MCP Server Name (Nombre del servidor de MCP) y Description (Descripción) para proporcionar detalles sobre para qué se utilizará esta conexión.
2. Establece la Server URL (URL del servidor) en https://mcp.trailhead.salesforce.com/mcp
3. Establece el Authentication Method (Método de autenticación) como No Authentication (Sin autenticación)
4. Haz clic en Create and Continue (Crear y continuar)
5. En la siguiente sección, Tools (Herramientas), haz clic en el botón Add Tool (Agregar herramienta) para cualquiera de las herramientas que vayas a utilizar.
6. Haz clic en Allow and Continue (Permitir y continuar)
7. En la siguiente sección, Select policies (Optional) (Seleccionar políticas [Opcional]), selecciona las políticas aplicables a tu caso de uso.
8. Haz clic en Save (Guardar)

Casos de uso recomendados

Agentes de soporte técnico basados en las prácticas recomendadas de Trailhead
Agentes de incorporación que guían a los nuevos empleados hacia el contenido adecuado de Trailhead.
Agentes de habilitación que responden preguntas sobre los productos citando módulos oficiales de Trailhead

Comienza ahora: Claude y Claude Code

Antes de empezar

Necesitarás tener instalado Claude Desktop, Claude Code o la interfaz de línea de comandos de Claude (Claude CLI).

Agrega Trailhead MCP

Claude Code / Claude CLI — ejecuta esto en tu terminal:

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

La marca --scope user hace que el servidor esté disponible en todos tus proyectos de Claude Code.

Claude Desktop:

Abre Claude Desktop → Settings (Configuración) → Developer (Desarrollador) → Edit Config (Editar configuración)
Agrega lo siguiente a tu archivo claude_desktop_config.json:

claude_desktop_config.json

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

Guarda y reinicia Claude Desktop

Verifica que funcione

Prueba con una de estas solicitudes:

“¿Qué dice Trailhead sobre las prácticas recomendadas de procesamiento masivo de Apex?”
“Encuéntrame contenido de Trailhead sobre Agentforce para principiantes”.
“Extrae el contenido de la insignia de Capa de Confianza de Einstein y resúmelo”.

Deberías ver contenido de Trailhead citado en la respuesta. Si la IA responde basándose en conocimientos generales sin citar Trailhead, consulta la sección Obtener ayuda.

Consejos para obtener los mejores resultados

Sé explícito: “Usa Trailhead MCP para encontrar…” ayuda a Claude a encontrar la herramienta correcta
Consulta la sección Guía de solicitudes para obtener más información

Comienza ahora: Cursor

Antes de empezar

Necesitarás tener Cursor instalado. Descarga Cursor.

Agrega Trailhead MCP

Haz clic en este enlace para que Cursor agregue automáticamente el MCP.

Verifica que funcione

Abre una nueva ventana de Composer (Redactor) (⌘+I) e intenta lo siguiente:

“Busca en Trailhead contenido sobre las prácticas recomendadas de flujo para administradores”.

Consejos para obtener los mejores resultados

Consulta la sección Guía de solicitudes para obtener más información
Trailhead MCP funciona mejor en el modo Agente en Cursor Composer
Especifica la función y el nivel para obtener resultados más específicos (p. ej., “Contenido de Trailhead en LWC para desarrolladores, nivel intermedio”)

Guía de solicitudes: Sácale el máximo partido a Trailhead MCP.

Trailhead MCP es una herramienta de búsqueda y recuperación; la calidad de los resultados depende en gran medida de cómo se realice la consulta.
Las dos herramientas y cuándo utilizarlas

content_search: se utiliza para el descubrimiento. Es útil cuando conoces el tema, pero no la insignia o el nombre exacto de la ruta. Ejemplo: “Encuentra contenido de Trailhead sobre las prácticas recomendadas de prueba de Apex”.
fetch_content: úsalo cuando sepas exactamente lo que quieres. Descarga el contenido completo del módulo. Ejemplo: “Obtén el contenido de la insignia de Trailhead 'Apex Triggers'”.

Si tu IA sigue utilizando content_search cuando quieres el contenido completo, sé explícito: “Utiliza fetch_content para recuperar…”

Filtra por función y nivel

Ambas herramientas permiten filtrar los datos, y su uso adecuado mejora significativamente los resultados.

Funciones: Administrador, Desarrollador, Arquitecto, Experto en Marketing, Analista de Negocios, Consultor
Niveles: Nivel básico, intermedio y avanzado.

Ejemplo: “Encuentra contenido de Trailhead sobre modelado de datos para arquitectos de nivel avanzado”.

Ejemplos de solicitudes por persona

Desarrollador

“¿Qué dice Trailhead sobre las prácticas recomendadas de procesamiento masivo de Apex?”
“Encuentra todo el contenido de Trailhead relacionado con LWC y explica los conceptos clave”.
“Extrae el contenido de SOQL y SOSL Trailhead y resume las diferencias”.

Administrador

“¿Con qué insignias de Trailhead debería empezar un nuevo administrador de Salesforce?”
“Encuentra contenido de Trailhead sobre el flujo de Salesforce para principiantes”.
“Busca en Trailhead contenido sobre informes y paneles”.

Arquitecto

“Busca en Trailhead contenido sobre arquitectura de datos de Salesforce a nivel avanzado”.
“Saca la insignia de Capa de confianza de Einstein y dame un desglose técnico”.
“Encuentra todo el contenido de Trailhead sobre patrones de integración y API”.

Generador de agentes

“Encuentra todo el contenido de Trailhead relacionado con Agentforce e IA”.
“¿Qué dice Trailhead sobre la ingeniería de solicitudes para Salesforce?”
“Consigue el contenido de 'Primeros pasos con Agentforce' y resume los conceptos clave para un público de desarrolladores”.

Qué hacer cuando los resultados parecen incorrectos

Sin resultados: Prueba con palabras clave alternativas: “Flujo”, “flujo de Salesforce” y “automatización de procesos” pueden arrojar resultados diferentes
Resultados obsoletos: El contenido se actualiza diariamente. Inténtalo de nuevo al día siguiente, o usa fetch_content con el nombre exacto.
La IA responde basándose en conocimientos generales: Agrega “Usa Trailhead MCP para…” al inicio de tu solicitud

Uso de Trailhead MCP en configuraciones de agentes

Si estás creando un agente y deseas que siempre utilice Trailhead MCP para las preguntas de aprendizaje de Salesforce, agrega esto a la solicitud del sistema o a copilot-instructions.md:

Al responder preguntas sobre productos, funciones o prácticas recomendadas de Salesforce, utiliza siempre las herramientas content_search o fetch_content de Trailhead MCP para recuperar contenido de Trailhead actualizado y confiable. Cita la insignia o el nombre de la ruta en tu respuesta.

Privacidad y gestión de datos

¿Qué contenido se brinda?

Todo el contenido mostrado por Trailhead MCP es contenido de Trailhead disponible públicamente, el mismo contenido al que cualquier visitante puede acceder en trailhead.com sin iniciar sesión. No se incluyen datos privados del alumno, información de la cuenta ni contenido personalizado.

Autenticación

No se requiere autenticación

Nuestros compromisos con los datos

Trailhead MCP no venderá ni compartirá tus datos con terceros.
Trailhead MCP no almacenará, recopilará ni conservará tus solicitudes ni indicaciones.
Trailhead MCP no utilizará tus interacciones para entrenar modelos de IA
Trailhead MCP no accederá, leerá ni modificará tu cuenta de Trailhead, insignias ni puntos

Preguntas más frecuentes

Sí, su uso es gratuito y no se requiere cuenta para acceder al contenido público.

No. Todo el contenido disponible de Trailhead es accesible sin autenticación.

No puedes ganar insignias ni hacer un seguimiento de tu progreso a través del MCP. Inicia sesión en Trailhead.com para acceder a nuestra gamificación y contenido personalizado.

Actualización de contenido: El servicio de información se actualiza diariamente. Es posible que el contenido publicado muy recientemente aún no aparezca.
Frases alternativas: La búsqueda se basa en palabras clave. Los sinónimos importan: prueba “Flujo” en lugar de “Flujo de Salesforce”.
Utiliza fetch_content directamente: Si conoces el nombre exacto de la insignia o de la ruta, pídele a tu IA que lo recupere por su nombre.

Una vez al día.

Todo el contenido de Trailhead está incluido, incluidas las insignias (módulos/unidades), las rutas, los Trailhead Journeys y las superinsignias.

No. Trailhead MCP es de solo lectura. No almacena consultas, solicitudes ni ningún dato del usuario. Consulta la sección de Privacidad y gestión de datos para obtener más detalles.

Cualquier cliente compatible con MCP que utilice Streamable HTTP debería funcionar, incluso: Slackbot, Agentforce, Claude/Claude Code, Cursor y VS Code (con GitHub Copilot).

Asegúrate de que tu cliente Cursor esté actualizado y de que la URL del servidor de MCP se haya ingresado correctamente en Configuración → MCP.

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

Obtén ayuda

Resolución de problemas de autoservicio

Consulta primero las preguntas frecuentes que aparecen más arriba; allí se tratan los problemas más comunes, como el contenido no encontrado, los errores 405 y los problemas de configuración específicos del cliente.

Resolución de problemas por cliente

Claude Code: Verifica que tu comando incluya --transport http y --scope user
Cursor: Confirma que la URL se haya introducido correctamente en Settings (Configuración) → MCP
VS Code: Confirma que tu archivo JSON de configuración de MCP sea válido y que VS Code se haya recargado
Slackbot: Intenta actualizar Slack (Cmd+Mayús+R / Ctrl+Mayús+R) si el ícono del conector MCP no está visible

Informa de un problema o envía comentarios

Navega a https://help.salesforce.com/s/cases
Selecciona Ask Agentforce (Pregúntale a Agentforce)
Envía los detalles de tu caso a través de Agentforce

Importante: Indica siempre desde el principio que tu problema está relacionado con Trailhead MCP. Esta ruta de soporte cubre todas las ofertas de productos y contenido de Trailhead, por lo que mencionar “Trailhead MCP” ayuda inmediatamente al equipo a enrutar y priorizar su caso de forma correcta.

Para una resolución más rápida, estructura tu caso utilizando este formato:

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

Solicitud utilizada: [la solicitud o consulta exacta que ejecutaste]

Comportamiento esperado: [lo que esperabas que sucediera]

Comportamiento real: [el mensaje de error o el resultado inesperado que viste]

Reproducibilidad: [Siempre / Intermitente / Una sola vez]

Notas adicionales: [cualquier otra cosa relevante, por ejemplo, cambios recientes en la configuración]

¿Es gratuito Trailhead MCP?

¿Necesito una cuenta de Trailhead?

¿Puedo ganar insignias o hacer un seguimiento de mi progreso a través del MCP?

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

¿Con qué frecuencia se actualiza el contenido?

¿Qué tipos de contenido están disponibles en Trailhead?

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

¿A qué clientes se presta apoyo?

¿Qué debo hacer si recibo un error "405 Method Not Allowed" (405 Método no permitido) en Cursor?

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