Skip to main content
A Trailblazer Community no Slack está agora em beta aberto. Participe e interaja em tempo real. Junte-se a nós no Slack

MCP do Trailhead

O que é MCP?

O MCP (Model Context Protocol) padroniza como assistentes de IA, como Slackbot, Claude ou Cursor, se conectam a ferramentas e fontes de dados externas. Ele permite que os assistentes de IA acessem informações atualizadas de sites, bancos de dados e serviços em tempo real.

O que é o MCP do Trailhead?

O MCP do Trailhead é um servidor MCP aberto e gratuito que conecta seu assistente de IA a todo o material de treinamento da Trailhead. Quando você faz ao agente de IA perguntas sobre tópicos do Salesforce, como "Fale sobre a arquitetura do Agentforce" ou "Como o Flow pode me ajudar?", ele pode encontrar e mostrar o conteúdo verdadeiro do Trailhead, onde você estiver trabalhando. Não é preciso abrir novas guias de navegador, copiar e colar informações ou se preocupar com alucinações.

Quem é o público-alvo?

O MCP do Trailhead foi projetado para:

  • Equipes de capacitação que estão criando experiências de aprendizagem com conteúdo do Trailhead.
  • Trailblazers que querem conteúdo de aprendizado sob demanda exibido em suas ferramentas de IA
  • Desenvolvedores e Administradores do Salesforce que usam Claude, Cursor ou VS Code no fluxo de trabalho diário.
  • Criadores de agente de IA cujas equipes estão desenvolvendo agentes que precisam basear respostas em conteúdo confiável do Trailhead.
O que ele pode fazer?

O MCP do Trailhead oferece a você duas ferramentas simples para acessar conteúdo diretamente no seu assistente de IA:

  • fetch_content – recupera o conteúdo completo do emblema ou da trilha por nome, apresentado no formato Markdown otimizado para LLMs.
  • content_search – procura por materiais de treinamento por tópico em todo o conteúdo público do Trailhead. Esse comando encontra emblemas, trilhas, jornadas do Trailhead e superbadges. Você pode filtrar por papel, por exemplo, Administrator (Administrador), Developer (Desenvolvedor), Architect (Arquiteto) e nível de habilidade, Foundational (Básico), Intermediate (Intermediário) ou Advanced (Avançado). Com isso, você economiza tempo navegando por centenas de emblemas e trilhas para encontrar o que é relevante.
Restrições do MCP do Trailhead

É importante observar que o MCP do Trailhead não necessariamente substitui a experiência completa interativa que você tem no trailhead.com, com as trilhas de aprendizado estruturadas e os recursos de gamificação. Não é possível conquistar emblemas ou acompanhar seu progresso de aprendizado através do MCP, e ele não acessa seus dados privados de aluno ou informações de conta no formato atual.

Clientes com suporte
  • Slackbot
  • Agentforce
  • Claude/Claude Code
  • Cursor
  • Qualquer cliente compatível com MCP que usa Streamable HTTP
Endpoint do servidor

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

O servidor está sempre ativo; não há nada para hospedar ou implementar.

Autenticação e acesso

Nenhuma autenticação é necessária para acessar conteúdo público do Trailhead (estado atual).

Escopo do conteúdo

O MCP do Trailhead fornece acesso a emblemas e trilhas publicamente disponíveis, com jornadas do Trailhead e superbadges em breve. O conteúdo é atualizado diariamente para garantir que você tenha os materiais de aprendizagem mais atuais.

Primeiros passos: Slackbot

Antes de começar

Você precisará de acesso a uma área de trabalho do Slack onde o MCP do Trailhead esteja disponível. O aplicativo do MCP do Trailhead deve ser ativado para sua área de trabalho pelo seu administrador do Slack.

Adicionar o MCP do Trailhead à área de trabalho do Slack
  1. Acesse https://api.slack.com/apps; se você tiver permissões suficientes na sua área de trabalho, deverá ver um botão Create New App (Criar novo aplicativo).
  2. Clique em Create New App (Criar novo aplicativo) e selecione From a Manifest (De um manifesto).
  3. Escolha sua área de trabalho e clique em Next (Avançar).
  4. No modal Create app from Manifest (Criar aplicativo a partir do manifesto), insira o seguinte JSON de manifesto:
  • No modal Review summary & create your app (Revisar resumo e criar seu aplicativo), revise todas as configurações e clique em Create Enable Trailhead MCP (Criar MCP do Trailhead compatível) no Slackbot.
  • Abra qualquer conversa com o Slackbot (ou inicie uma nova DM).
  • Clique no ícone App integrations (Integrações de aplicativos) no compositor de mensagem; atualize o Slack se você não o encontrar (Cmd+Shift+R no Mac, Ctrl+Shift+R no Windows/Linux)
  • Encontre o Trailhead MCP (MCP do Trailhead) e clique para adicioná-lo.
  • Para ter os melhores resultados, acesse Manage Apps (Gerenciar aplicativos) → Trailhead MCP (MCP do Trailhead) → defina todas as ferramentas como "Always allow" ("Sempre permitir").
Verifique se está funcionando

No seu Slackbot DM, tente:

  • "Use o MCP do Trailhead para encontrar conteúdo de iniciante no Salesforce Flow."
Dicas para melhores resultados
  • Definir as ferramentas como "Always allow" (Sempre permitir) evita que o Slackbot peça permissão em cada solicitação.
  • Fornecer instruções específicas ("Use o MCP do Trailhead para...") garante que o Slackbot direcione para a ferramenta certa.

Primeiros passos: Agentforce

Visão geral

O MCP do Trailhead pode ser usado para basear agentes do Agentforce em conteúdo confiável do Trailhead, permitindo que os agentes respondam perguntas de aprendizagem com material atualizado e confiável.

Adicionar MCP do Trailhead
  1. Na Setup (Configuração) da sua organização, na caixa Quick Find (Localização rápida), procure pelo MCP e clique em Registered MCP Servers (Servidores MCP registrados).
  2. Na página Agentforce Registry (Registro do Agentforce), clique em New + (Novo +). No menu suspenso, clique em Register MCP Server (Registrar Servidor MCP).
  3. On the Create Connection modal
    1. Defina o MCP Server Name (Nome do servidor MCP) e a Description (Descrição) para fornecer detalhes sobre como essa conexão será usada.
    2. Defina o URL do servidor como https://mcp.trailhead.salesforce.com/mcp.
    3. Defina o Authentication Method (Método de autenticação) como No Authentication (Sem autenticação).
    4. Clique em Create and Continue (Criar e continuar).
    5. Na próxima seção, Tools (Ferramentas), clique no botão Add Tool (Adicionar ferramenta) para qualquer ferramenta que você vai utilizar.
    6. Clique em Allow and Continue (Permitir e continuar).
    7. Na próxima seção, em Select policies (Optional) (Selecionar políticas [opcional]), selecione quaisquer políticas aplicáveis para seu caso de uso.
    8. Clique em Save (Salvar).
Casos de uso recomendados
  • Agentes de help desk baseados em conteúdo de práticas recomendadas do Trailhead.
  • Agentes de integração que orientam novos funcionários ao conteúdo do Trailhead certo.
  • Agentes de capacitação que respondem perguntas sobre o produto citando módulos oficiais do Trailhead.

Primeiros passos: Claude e Claude Code

Antes de começar

Você precisa ter o Claude Desktop, Claude Code ou Claude CLI instalado.

Adicionar MCP do Trailhead

Claude Code/Claude CLI – execute no seu terminal:

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

O sinalizador --scope user torna o servidor disponível em todos os seus projetos do Claude Code.

Claude Desktop:
  • Abra o Claude Desktop → Settings (Configurações) → Developer (Desenvolvedor) → Edit Config (Editar configurações).
  • Adicione o seguinte ao seu claude_desktop_config.json:
  • Salve e reinicie o Claude Desktop.
Verifique se está funcionando

Tente um destes prompts:

  • "O que o Trailhead diz sobre práticas recomendadas de processamento em lote do Apex?"
  • "Encontre conteúdo do Trailhead sobre Agentforce para iniciantes."
  • "Procure o conteúdo do emblema da Camada de confiança do Einstein e faça um resumo."

Você deverá ver conteúdo do Trailhead citado na resposta. Se a IA responder usando conhecimento geral, sem citar o Trailhead, consulte a seção Obter ajuda.

Dicas para melhores resultados
  • Dê instruções específicas: "Use o MCP do Trailhead para encontrar..." para ajudar o Claude a direcionar para a ferramenta certa.
  • Consulte a seção "Guia de prompts" para saber mais.

Primeiros passos: Cursor

Antes de começar

Você precisa ter o Cursor instalado. Faça o download do Cursor.

Adicionar MCP do Trailhead
  1. Clique neste link para que o Cursor adicione automaticamente o MCP.
Verifique se está funcionando

Abra uma nova janela do Composer (⌘+I) e tente:

  • "Procure no Trailhead conteúdo sobre práticas recomendadas do Flow para administradores."
Dicas para melhores resultados
  • Consulte a seção "Guia de prompts" para saber mais.
  • O MCP do Trailhead funciona melhor no Agent mode (Modo Agente) do Cursor Composer.
  • Especifique o papel e o nível para resultados mais segmentados (por exemplo, "Conteúdo do Trailhead sobre LWC para desenvolvedores, nível intermediário").

Guia de prompts: aproveite ao máximo o MCP do Trailhead

O MCP do Trailhead é uma ferramenta de busca e recuperação; a qualidade do resultado depende amplamente do que é solicitado.
As duas ferramentas e quando usá-las:

  • content_search – use para descoberta. Ideal para quando você sabe o tópico, mas não o nome exato do emblema ou da trilha. Exemplo: "Encontre conteúdo do Trailhead sobre práticas recomendadas de teste Apex."
  • fetch_content – use quando você souber exatamente o que procura. Isso extrai o conteúdo completo do módulo. Exemplo: "Encontre o conteúdo do emblema do Trailhead 'Apex Triggers'."

Se a sua IA continua usando content_search quando você quer o conteúdo completo, dê instruções explícitas: "Use fetch_content para recuperar..."

Filtrar por papel e nível

Ambas as ferramentas oferecem suporte a filtros, e usá-las melhora consideravelmente os resultados.

  • Papéis: Administrator (Administrador), Developer (Desenvolvedor), Architect (Arquiteto), Marketer (Profissional de marketing), Business Analyst (Analista comercial) e Consultant (Consultor)
  • Níveis: Foundational (Básico), Intermediate (Intermediário) e Advanced (Avançado)

Exemplo: "Encontre conteúdo do Trailhead sobre modelagem de dados para arquitetos no nível Avançado."

Exemplos de prompts por perfil

Desenvolvedor

  • "O que o Trailhead diz sobre práticas recomendadas de processamento em lote do Apex?"
  • "Encontre todo o conteúdo do Trailhead relacionado a LWC e explique os principais conceitos."
  • "Extraia o conteúdo SOQL e SOSL do Trailhead e faça um resumo das diferenças."

Administrador

  • "Com quais emblemas do Trailhead um novo Administrador do Salesforce deve começar?"
  • "Encontre conteúdo do Trailhead no Salesforce Flow para iniciantes."
  • "Procure no Trailhead conteúdo sobre Relatórios e Painéis."

Arquiteto

  • "Procure no Trailhead conteúdo sobre arquitetura de dados do Salesforce no nível Avançado."
  • "Procure o emblema da Camada de confiança do Einstein e apresente um detalhamento técnico."
  • "Encontre todo o conteúdo do Trailhead sobre padrões de integração e APIs."

Agent Builder

  • "Encontre todo o conteúdo do Trailhead relacionado ao Agentforce e à IA."
  • "O que o Trailhead diz sobre engenharia de prompts para o Salesforce?"
  • "Encontre o conteúdo de 'Como começar com o Agentforce' e faça um resumo dos principais conceitos para um público-alvo de desenvolvedores."
O que fazer quando os resultados parecerem estranhos
  • Nenhum resultado: Tente usar palavras-chave alternativas; "Flow" versus "Salesforce Flow" versus "automação de processo" pode retornar resultados diferentes.
  • Resultados desatualizados: o conteúdo é atualizado diariamente. Tente novamente no dia seguinte ou use fetch_content com o nome exato.
  • Respostas da IA de conhecimento geral: adicione "Use o MCP do Trailhead para..." no início do seu prompt.
Usar o MCP do Trailhead em configurações de agente

Se você estiver criando um agente e quiser que ele sempre use o MCP do Trailhead para perguntas de aprendizagem do Salesforce, adicione isso ao seu prompt do sistema ou copilot-instructions.md:

Ao responder perguntas sobre produtos, recursos ou práticas recomendadas da Salesforce, sempre use as ferramentas content_search ou fetch_content do MCP do Trailhead para recuperar conteúdo atualizado e confiável do Trailhead. Cite o emblema ou nome da trilha na sua resposta.

Privacidade e tratamento de dados

Qual conteúdo é exibido

Todo o conteúdo exibido pelo MCP do Trailhead é conteúdo do Trailhead publicamente disponível, o mesmo conteúdo que qualquer visitante pode acessar em trailhead.com sem fazer login. Nenhum dado privado de aluno, informação de conta ou conteúdo personalizado é incluído.

Autenticação

Nenhuma autenticação é necessária.

Nossos compromissos de dados
  • O MCP do Trailhead não vende nem compartilha seus dados com terceiros.
  • O MCP do Trailhead não vai armazenar, coletar ou reter suas consultas ou prompts.
  • O MCP do Trailhead não usa suas interações para treinar modelos de IA.
  • O MCP do Trailhead não acessa, lê ou modifica sua conta, emblemas ou pontos do Trailhead.

Perguntas frequentes

Sim, gratuito para usar sem precisar de uma conta para acessar conteúdo público.

Não. Todo o conteúdo do Trailhead disponível é acessível sem autenticação.

Não é possível conquistar emblemas ou acompanhar seu progresso pelo MCP. Faça login em Trailhead.com para acessar nossa gamificação e conteúdo personalizado.

  • Atualização de conteúdo: O serviço de conhecimento é atualizado diariamente. Conteúdo publicado recentemente pode não aparecer ainda.
  • Formulações alternativas: A pesquisa é baseada em palavra-chave. Sinônimos são importantes; tente "Flow" versus "Salesforce Flow".
  • Use fetch_content diretamente: Se você souber o nome exato do emblema ou da trilha, peça para a IA procurar por nome.

Uma vez por dia.

Todo o conteúdo do Trailhead está no escopo, incluindo emblemas (módulos/unidades), trilhas, jornadas do Trailhead e superbadges.

Não. O MCP do Trailhead é somente leitura. Ele não armazena consultas, prompts ou qualquer dado do usuário. Consulte a seção Privacidade e tratamento de dados para ver mais detalhes.

Qualquer cliente compatível com MCP que usa Streamable HTTP deve funcionar, incluindo: Slackbot, Agentforce, Claude/Claude Code, Cursor e VS Code (com GitHub Copilot).

Certifique-se de que seu cliente Cursor esteja atualizado e o URL do servidor MCP esteja correto em Settings → MCP (Configurações → MCP).

Consulte abaixo a seção Obter ajuda.

Obter ajuda

Autoatendimento para resolução de problemas

Verifique as perguntas frequentes acima; elas abrangem os problemas mais comuns, incluindo conteúdo não encontrado, erros 405 e problemas de configuração específicos do cliente.

Soluções de problemas por cliente
  • Claude Code: verifique se o seu comando inclui --transport http e --scope user.
  • Cursor: Confirme se o URL está inserido corretamente em Settings → MCP (Configurações → MCP).
  • VS Code: confirme se o JSON de configurações do MCP é válido e se o VS Code foi recarregado.
  • Slackbot: Tente atualizar o Slack (Cmd+Shift+R / Ctrl+Shift+R) se o ícone do conector do MCP não estiver visível.
Informar um erro ou enviar feedback
  1. Navegue até https://help.salesforce.com/s/cases.
  2. Selecione "Pergunte ao Agentforce".
  3. Envie os detalhes do seu caso via Agentforce.

Importante: Sempre indique antecipadamente que seu problema está relacionado ao MCP do Trailhead. Essa trilha de suporte abrange todas as ofertas de conteúdo e produto do Trailhead, então invocar "MCP do Trailhead" imediatamente ajuda a equipe a direcionar e destinar seu caso da maneira correta.

Para obter a resolução mais rápida, estruture seu caso usando este formato:

Produto: Cliente de MCP do Trailhead: [por exemplo, Claude Desktop v1.2.3, Cursor 0.45, Slackbot]

Prompt usado: [o prompt ou consulta exata que você executou]

Comportamento esperado: [o que você espera que aconteça]

Comportamento: [a mensagem de erro ou resultado inesperado que você encontrou]

Reproducibility (Reprodutibilidade): [Always / Intermittent / One-time] (Sempre/Intermitente/Única)

Observações adicionais: [o que mais for relevante, como alterações recentes na configuração]