Trailhead MCP

什么是 MCP？

MCP（模型上下文协议）标准化了 Slackbot、Claude 或 Cursor 等 AI 助理连接外部工具与数据源的方式。它让 AI 助理能实时从网站、数据库和服务中获取最新信息。

Trailhead MCP 是什么？

Trailhead MCP 是一款免费、开放的 MCP 服务器，可将您的 AI 助理连接到 Trailhead 的所有学习资料。在您向 AI 智能体询问有关 Salesforce 主题的问题时，比如：“给我介绍一下 Agentforce 的架构”或“Flow 有什么用？”它能直接在您当前工作的界面中执行查找，并为您展示实际的 Trailhead 内容。您不需要打开新的浏览器标签页，无需复制粘贴信息，也不必担心出现幻觉。

适用对象是谁？

Trailhead MCP 的设计目标：

正在利用 Trailhead 内容构建学习体验的赋能团队
希望在 AI 工具中呈现按需学习内容的 Trailblazer
在日常工作流中使用 Claude、Cursor 或 VS Code 的 Salesforce 开发人员和管理员
致力于构建智能体的 AI 团队，且需要依赖可信的 Trailhead 内容来生成回复

它可以做什么？

Trailhead MCP 提供了两种简单的工具，可让您直接在 AI 助理中访问其内容：

fetch_content — 按名称检索完整的徽章或 Trail 内容，并以针对 LLM 优化的 Markdown 格式返回。
content_search — 按主题在 Trailhead 的所有公开内容中搜索学习材料。此工具可查找徽章、Trail、Trailhead 旅程和超级徽章。您可以按角色（如管理员、开发人员、架构师）和技能级别（基础级、进阶级或专业级）进行筛选。这可以省去您在数百个徽章和 Trail 中浏览查找相关内容的时间。

Trailhead MCP 限制条件

务必注意，Trailhead MCP 并非旨在取代您在 trailhead.com 上获得的包含结构化学习路径和游戏化功能的完整交互式 Trailhead 体验。您无法通过 MCP 获得徽章或追踪学习进度，在当前形式下，MCP 也无法访问您的任何私人学员数据或账户信息。

支持的客户端

Slackbot
Agentforce
Claude / Claude Code
Cursor
任何使用 Streamable HTTP 且兼容 MCP 的客户端

服务器端点

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

服务器始终运行，无需托管或部署任何内容。

身份验证与访问

访问公开 Trailhead 内容无需身份验证（当前状态）

内容范围

Trailhead MCP 提供对公开徽章和 Trail 的访问权限，且即将推出 Trailhead 旅程和超级徽章。内容每天刷新一次，以确保您获得最新的学习资料。

开始：Slackbot

开始之前

您需要拥有已提供 Trailhead MCP 的 Slack 工作区的访问权限。Slack 管理员必须为您的工作区启用 Trailhead MCP 应用。

将 Trailhead MCP 添加到 Slack 工作区

访问 https://api.slack.com/apps，如果您在工作区中拥有足够的权限，就会看到“创建新应用”(Create New App) 按钮。
点击“创建新应用”(Create New App) 并选择“通过清单文件创建”(From a Manifest)
选取工作区，然后点击“下一步”(Next)
在“通过清单文件创建应用”(Create app from 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"
        }
    }
}

在查看摘要并创建您的应用 (Review summary & create your app) 模态框中，检查所有设置，然后点击“创建”(Create) 并在 Slackbot 中启用 Trailhead MCP
打开与 Slackbot 的任何对话（或发起新的私信）
点击消息设计器中的应用集成 (App integrations) 图标，如未看到此图标，请先刷新 Slack（Mac 按 Cmd+Shift+R，Windows/Linux 按 Ctrl+Shift+R）
找到 Trailhead MCP 并点击以添加
为获得最佳结果：转到管理应用 (Manage Apps) → Trailhead MCP → 将所有工具设置为始终允许 (Always allow)

验证其是否有效

在您的 Slackbot 私信中，尝试：

“使用 Trailhead MCP 查找有关 Salesforce Flow 的新手内容。”

获取最佳结果的提示

将工具设置为“始终允许”(Always allow)，可避免 Slackbot 在每次发出请求时都请求权限
明确指定 —“使用 Trailhead MCP 来...”，以确保 Slackbot 路由到正确的工具

开始使用：Agentforce

概述

Trailhead MCP 可用于以受信任的 Trailhead 内容为基础，帮助 Agentforce 智能体进行学习，使其能够使用所引用的最新资料回答学习类问题。

添加 Trailhead MCP

在贵组织的设置 (Setup)中，于快速查找 (Quick Find) 框中搜索 MCP，并点击已注册的 MCP 服务器 (Registered MCP Servers)
在 Agentforce 注册表 (Agentforce Registry) 页面上，点击新建 + (New +) 并在下拉菜单中点击注册表 MCP 服务器 (Register MCP Server)
On the Create Connection modal
1. 设置 MCP 服务器名称和说明，详细说明此连接的用途。
2. 将服务器 URL (Server URL) 设置为 https://mcp.trailhead.salesforce.com/mcp
3. 将身份验证方法 (Authentication Method) 设置为无身份验证 (No Authentication)
4. 点击创建并继续 (Create and Continue)
5. 在下一部分工具 (Tools) 中，点击您要使用的任何工具旁边的添加工具 (Add Tool) 按钮
6. 点击允许并继续 (Allow and Continue)
7. 在下一部分选择策略（可选）(Select policies (Optional))中，选择适用于您应用场景的任何适用策略。
8. 点击保存 (Save)

开始使用：Claude 和 Claude Code

开始之前

您需要先安装 Claude Desktop、Claude Code 或 Claude CLI。

添加 Trailhead MCP

Claude Code / Claude CLI — 在您的终端中运行以下命令：

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

使用 --scope user，即可使该服务器在您的所有 Claude Code 项目中可用。

Claude Desktop：

打开 Claude Desktop → 设置 (Settings) → 开发人员 (Developer) → 编辑配置 (Edit Config)
将以下内容添加到您的 claude_desktop_config.json：

claude_desktop_config.json

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

保存并重启 Claude Desktop

验证其是否有效

尝试以下提示之一：

“Trailhead 对 Apex 批量处理最佳实践有何说明？”
“帮我查找面向新手的 Agentforce 的 Trailhead 内容。”
“提取 Einstein 信任层徽章内容并对其进行总结。”

您应该能在回复中看到引用的 Trailhead 内容。如果 AI 基于其通用知识库回答，并未引用 Trailhead，请参阅“获取帮助”部分。

获取最佳结果的提示

明确指定： “使用 Trailhead MCP 来查找...”，以确保 Slackbot 路由到正确的工具
有关更多信息，请参阅“提示指南”部分

开始使用：Cursor

开始之前

您需要安装 Cursor。下载 Cursor。

添加 Trailhead MCP

点击此链接，以确保 Cursor 自动添加 MCP

验证其是否有效

打开一个新的 Composer 窗口 (⌘+I) 并尝试：

“在 Trailhead 中搜索有关面向管理员的 Flow 最佳实践内容。”

获取最佳结果的提示

有关更多信息，请参阅“提示指南”部分
Trailhead MCP 在 Cursor Composer 的智能体模式 (Agent mode) 下运行效果最佳
指定角色和级别以获取更精准的结果（例如，“面向进阶级开发人员且关于 LWC 的 Trailhead 内容”）

提示指南：充分利用 Trailhead MCP

Trailhead MCP 是一款搜索和检索工具，您所获得的结果质量很大程度上取决于您的提问方式。
两种工具及其适用情况

content_search — 适用于探索。当您知道主题但不知道确切的徽章或 Trail 名称时，这非常有用。 示例：“查找有关 Apex 测试最佳实践的 Trailhead 内容。”
fetch_content — 在您确切了解所需内容时使用。提取完整的模块内容。 示例：“提取‘Apex 触发器 (Apex Triggers)’Trailhead 徽章内容。”

如果在您需要完整内容时，您的 AI 一直在使用 content_search，请明确指定： “使用 fetch_content 检索…”

按角色和级别筛选

这两款工具都支持筛选功能——合理加以使用可显著改善结果。

角色： 管理员、开发人员、架构师、营销人员、业务分析师、顾问
级别： 基础级、进阶级、专业级

示例：“查找 Trailhead 中面向架构师的专业级数据建模内容。”

按角色划分的提示示例

开发人员

“Trailhead 对 Apex 批量处理最佳实践有何说明？”
“查找所有与 LWC 相关的 Trailhead 内容并解释关键概念。”
“提取 SOQL 和 SOSL Trailhead 内容，并总结它们之间的差异。”

管理员

“新 Salesforce 管理员应该从哪个 Trailhead 徽章入手？”
“查找针对新手的 Salesforce Flow 的 Trailhead 内容。”
“在 Trailhead 中搜索有关报表和仪表板的内容。”

架构师

“在 Trailhead 中搜索有关专业级 Salesforce 数据架构的内容。”
“提取 Einstein 信任层徽章并为我提供技术解析。”
“查找有关集成模式和 API 的所有 Trailhead 内容。”

智能体构建人员

“查找与 Agentforce 和 AI 相关的所有 Trailhead 内容。”
“Trailhead 对 Salesforce 提示工程有何说明？”
“提取‘开始使用 Agentforce ’内容，并为开发人员受众总结关键概念。”

当结果看似有问题时该怎么办

无结果： 尝试使用不同的关键字，例如，“Flow”、 “Salesforce Flow”与“流程自动化”，这可能会返回不同的结果
结果过时： 内容每天刷新一次。请在第二天重试，或使用带有准确名称的 fetch_content
AI 基于通用知识提供回答： 在您的提示开头添加“使用 Trailhead MCP 来…”

在智能体配置中使用 Trailhead MCP

如果您正在构建智能体，并希望它在遇到 Salesforce 学习问题时始终使用 Trailhead MCP，请将以下内容添加到您的系统提示或 copilot-instructions.md 中：

在回答有关 Salesforce 产品、功能或最佳实践的问题时，请始终使用 Trailhead MCP 的 content_search 或 fetch_content 工具来检索最新的受信任 Trailhead 内容。在回复中引用徽章或 trail 名称。

隐私与数据处理

提供哪些内容

Trailhead MCP 返回的所有内容都是公开且可用的 Trailhead 内容，与任何访客在无需登录的情况下即可在 trailhead.com 上访问的内容相同。不包含任何私人学员数据、账户信息或个性化内容。

身份验证

无需身份验证

我们的数据承诺

Trailhead MCP 不会将您的数据出售或共享给第三方
Trailhead MCP 不会存储、收集或保留您的查询或提示
Trailhead MCP 不会使用您的交互来训练 AI 模型
Trailhead MCP 不会访问、读取或修改您的 Trailhead 账户、徽章或点数

常见问题解答

是，可免费使用，且无需账户即可访问公开内容。

不需要。所有可用的 Trailhead 内容都可以在无需身份验证的情况下访问。

您无法通过 MCP 获得徽章或追踪您的进度。请登录到 Trailhead.com，以访问我们的游戏化内容和个性化内容。

内容刷新：知识服务每天刷新一次。如果内容发布时间较短，可能暂时还看不到。
其他措辞方式：搜索基于关键字。同义词会影响结果，您可以尝试使用 “Flow” 与“Salesforce Flow”，对比两者的结果。
直接使用 fetch_content：如果您知道确切的徽章或 Trail 名称，请要求 AI 按名称检索。

每天一次。

涵盖所有 Trailhead 内容，包括徽章（模块/单元）、Trail、Trailhead 旅程和超级徽章。

否。Trailhead MCP 是只读的。它不会存储查询、提示或任何用户数据。有关详细信息，请参阅“隐私与数据处理”部分。

任何使用 Streamable HTTP 且兼容 MCP 的客户端均可正常运行，包括：Slackbot、Agentforce、Claude / Claude Code、Cursor 以及 VS Code（搭配 GitHub Copilot）。

确保您的 Cursor 客户端已更新至最新版，且在“设置”(Settings) → “MCP”中正确输入了 MCP 服务器 URL。

请参阅下方的“获取帮助”部分。

获取帮助

自助服务故障排查

请先查看上方的常见问题解答，其中涵盖了最常见的问题，包括找不到内容、405 错误以及特定于客户端的设置问题。

各客户端故障排查

Claude Code：验证您的命令是否包含 --transport http 和 --scope user
Cursor：确认在“设置”(Settings) → “MCP”中输入了 URL
VS Code：确认您的 MCP 设置 JSON 有效，并且已重新加载 VS Code
Slackbot：如果找不到 MCP 连接器图标，请尝试刷新 Slack（Mac 按 Cmd+Shift+R，Windows/Linux 按 Ctrl+Shift+R）

报告问题或提供反馈

导航至 https://help.salesforce.com/s/cases
选择“问问 Agentforce”
通过 Agentforce 提交您的个案详情

重要提示：请始终在最开始明确指出，您的问题与 Trailhead MCP 相关。由于此支持路径涵盖所有 Trailhead 产品和内容，因此第一时间指明“Trailhead MCP”有助于支持团队正确转交和分类您的个案。

为尽可能加快解决速度，请使用以下格式构建您的个案：

产品：Trailhead MCP 客户端：[例如 Claude Desktop v1.2.3、Cursor 0.45、Slackbot]

所用提示：[您使用的具体提示或运行的具体查询]

预期行为：[您预期发生的情况]

实际行为：[您看到的错误消息或意外结果]

可再现性：[始终 / 间歇性 / 一次性]

补充说明：[任何其他相关信息，例如最近的设置更改]

Trailhead MCP 免费吗？

我需要 Trailhead 账户吗？

我可以通过 MCP 获得徽章或追踪学习进度吗？

为什么我找不到某些已知可用的内容？

内容多长时间刷新一次？

提供哪些 Trailhead 内容类型？

我的数据会被存储或发送给 Salesforce 吗？

支持哪些客户端？

如果我在 Cursor 中遇到“405 Method Not Allowed”错误，该怎么办？

出现了其他故障。我可以从哪里获取帮助？