Trailhead MCP

MCP란 무엇인가요?

MCP(모델 컨텍스트 프로토콜)는 Slackbot, Claude 또는 Cursor와 같은 AI 어시스턴트가 외부 도구 및 데이터 소스에 연결하는 방식을 표준화합니다. 이를 통해 AI 어시스턴트는 웹사이트, 데이터베이스 및 서비스의 최신 정보에 실시간으로 액세스할 수 있습니다.

Trailhead MCP란 무엇인가요?

Trailhead MCP는 AI 어시스턴트를 Trailhead의 모든 학습 자료에 연결하는 무료 개방형 MCP 서버입니다. "Agentforce의 아키텍처를 설명해 줘"나 "Flow는 어떤 역할을 해?"와 같이 AI 에이전트에 Salesforce 관련 질문을 하면, 해당 내용에 맞는 Trailhead 콘텐츠를 찾아 사용자가 작업 중인 환경에 바로 표시해 줍니다. 새 브라우저 탭을 열거나 정보를 복사하여 붙여넣거나 잘못된 정보 생성(환각)에 대해 걱정할 필요가 없습니다.

대상 사용자는 누구인가요?

Trailhead MCP는 다음과 같은 용도로 설계되었습니다.

Trailhead 콘텐츠를 기반으로 하는 학습 경험을 구축하는 역량 강화 팀
AI 도구에서 온디맨드 학습 콘텐츠를 즉시 확인하고 싶은 Trailblazer
매일 업무에 Claude, Cursor 또는 VS Code를 사용하는 Salesforce 개발자 및 관리자
팀이 신뢰할 수 있는 Trailhead 콘텐츠에 응답을 기반으로 하는 에이전트를 구축하는 AI 에이전트 빌더

무엇을 할 수 있나요?

Trailhead MCP는 AI 어시스턴트에서 콘텐츠에 직접 액세스할 수 있는 두 가지 간단한 도구를 제공합니다.

fetch_content — 이름으로 전체 배지 또는 트레일 콘텐츠를 검색하며, LLM에 최적화된 Markdown 형식으로 반환합니다.
content_search — Trailhead의 모든 공개 콘텐츠에서 주제별로 학습 자료를 검색합니다. 이 기능을 사용하여 배지, 트레일, Trailhead Journey, Superbadge 등을 검색할 수 있습니다. 역할(예: 관리자, 개발자, 아키텍트) 및 기술 수준(기초, 중급, 고급)으로 필터링할 수 있습니다. 이 기능은 수많은 배지와 트레일 중에서 필요한 내용을 찾으러 일일이 둘러보는 수고를 덜어 줍니다.

Trailhead MCP 제약 사항

Trailhead MCP는 trailhead.com에서 제공되는 구조화된 학습 경로 및 게임화 기능을 갖춘 완전한 대화형 Trailhead 경험을 대체하지 않는다는 점을 숙지하시기 바랍니다. MCP를 통해 배지를 획득하거나 학습 진행 상황을 추적할 수 없으며, 현재 형태에서는 내부 전용 학습자 데이터나 계정 정보에 액세스하지 않습니다.

지원되는 클라이언트

Slackbot
AgentForce
Claude/Claude Code
Cursor
Streamable HTTP를 사용하는 모든 MCP 호환 클라이언트

서버 엔드포인트

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

서버는 상시 가동 상태이므로, 별도의 호스팅이나 배포 작업이 필요하지 않습니다.

인증 및 액세스

현재 공개 상태인 Trailhead 콘텐츠 이용 시 인증이 필요하지 않습니다.

콘텐츠 범위

Trailhead MCP는 공개적으로 이용 가능한 배지 및 트레일에 대한 액세스를 제공하며, Trailhead Journey 및 Superbadge는 곧 제공될 예정입니다. 항상 최신 학습 자료를 제공하기 위해 콘텐츠는 매일 새로 고침됩니다.

시작하기: Slackbot

시작하기 전에

Trailhead MCP를 사용할 수 있는 Slack 워크스페이스에 액세스할 수 있어야 합니다. Trailhead MCP 앱을 사용하려면 Slack 관리자가 이 앱을 해당 워크스페이스에 대해 활성화해야 합니다.

Slack 워크스페이스에 Trailhead MCP 추가

https://api.slack.com/apps를 방문하여 워크스페이스 내에 충분한 권한이 있다면 새 앱 만들기 버튼이 표시되어야 합니다.
Create New App(새 앱 만들기)을 클릭하고 From a Manifest(매니페스트에서)를 선택합니다.
워크스페이스를 선택한 후 다음을 클릭합니다.
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(요약 검토 후 내 앱 만들기) 모달에서 모든 설정을 검토한 후 만들기를 클릭하여 Slackbot에서 Trailhead MCP를 활성화합니다.
Slackbot과의 기존 대화창을 열거나 새 DM을 시작합니다.
메시지 작성기에서 App integrations(앱 통합) 아이콘을 클릭합니다. 이 아이콘이 보이지 않으면 Slack을 먼저 새로 고침하세요(Mac:Cmd+Shift+R, Windows/Linux: Ctrl+Shift+R).
Trailhead MCP를 찾아 클릭하여 추가합니다.
최상의 결과를 얻으려면 Manage Apps(앱 관리) → Trailhead MCP로 이동하여 모든 도구를 'Always allow'('항상 허용') 상태로 설정합니다.

정상 작동 여부 확인

Slackbot DM에서 다음 단계를 따르세요.

"Trailhead MCP를 사용하여 Salesforce Flow에 관한 초보자용 콘텐츠를 찾아 줘."

최상의 결과를 위한 팁

도구를 'Always allow'('항상 허용')로 설정하면 Slackbot이 요청 시마다 권한 허용을 묻는 것을 방지할 수 있습니다.
"Trailhead MCP를 사용하여..."와 같이 명확히 지시해야 Slackbot이 올바른 도구로 연결됩니다.

시작하기: Agentforce

개요

Trailhead MCP는 Agentforce 에이전트가 신뢰할 수 있는 Trailhead 콘텐츠의 토대가 되도록 사용될 수 있으며, 이를 통해 에이전트는 인용 출처가 명시된 최신 자료를 바탕으로 질문에 답변할 수 있습니다.

Trailhead MCP 추가

조직의 Setup(설정) 내 Quick Find(빠르게 찾기) 창에 MCP를 입력하여 검색한 후, Registered MCP Servers(등록된 MCP 서버)를 클릭합니다.
Agentforce Registry(Agentforce 레지스트리) 페이지에서 New +(새로 만들기+)를 클릭하고 드롭다운에서 Register MCP Server(MCP 서버 등록)를 클릭합니다.
On the Create Connection modal
1. MCP Server Name(MCP 서버 이름) 및 Description(설명)을 설정하여 이 연결이 어떤 목적으로 사용될지 상세히 기재합니다.
2. Server URL(서버 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(저장)를 클릭합니다.

권장 사용 사례

Trailhead 모범 사례 콘텐츠에 기반한 헬프 데스크 에이전트
신입 사원에게 적합한 Trailhead 콘텐츠를 안내하는 온보딩 에이전트
공식 Trailhead 모듈을 인용하여 제품 질문에 답변하는 역량 강화 에이전트

시작하기: 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를 인용하지 않고 일반 지식으로 답변하는 경우, Get Help(도움 받기) 섹션을 참조하세요.

최상의 결과를 위한 팁

명확히 지시하세요. "Trailhead MCP를 사용하여 ...를 찾아 줘"라고 하면 Claude가 적절한 도구로 연결됩니다.
자세한 내용은 Prompting Guide(프롬프트 가이드) 섹션을 참조하세요.

시작하기: Cursor

시작하기 전에

Cursor가 설치되어 있어야 합니다. Cursor를 다운로드하세요.

Trailhead MCP 추가

이 링크를 클릭하면 Cursor가 자동으로 MCP를 추가합니다.

정상 작동 여부 확인

새 Composer(작성기) 창을 열고(⌘+I) 다음과 같이 해봅니다.

"관리자를 위한 Flow 모범 사례에 대한 콘텐츠를 Trailhead에서 검색해 줘."

최상의 결과를 위한 팁

자세한 내용은 Prompting Guide(프롬프트 가이드) 섹션을 참조하세요.
Trailhead MCP는 Cursor Composer의 Agent mode(Agent 모드)에서 가장 잘 작동합니다.
보다 정밀한 검색 결과를 위해 역할과 수준을 지정합니다(예: '개발자를 위한 중급 수준의 LWC에 관한 Trailhead 콘텐츠').

프롬프트 가이드: Trailhead MCP를 효과적으로 활용하는 방법

Trailhead MCP는 검색과 조회를 위한 도구로서, 응답 결과의 품질은 질문 방식에 크게 좌우됩니다.
두 가지 도구와 적절한 활용 시기

content_search — 검색용으로 사용합니다. 주제는 알지만, 정확한 배지 또는 트레일 이름을 모를 때 유용합니다. 예: "Apex 테스트 모범 사례에 관한 Trailhead 콘텐츠를 찾아 줘."
fetch_content — 원하는 내용을 정확히 알고 있을 때 사용합니다. 해당 모듈의 전체 콘텐츠를 가져옵니다. 예: "'Apex Triggers' Trailhead 배지 콘텐츠를 불러와 줘."

전체 콘텐츠를 원할 때 AI가 계속 content_search를 사용하는 경우, 다음과 같이 명확히 지정해 주세요. "fetch_content를 사용하여 ...를 검색해 줘"

역할 및 수준별 필터링

두 도구에서 모두 필터 기능을 제공하며, 적절히 활용할 경우 검색 결과의 품질이 개선됩니다.

역할: 관리자, 개발자, 아키텍트, 마케터, 비즈니스 분석가, 컨설턴트
수준: 기초, 중급, 고급

예: "고급 수준의 아키텍트를 대상으로 하는 데이터 모델링에 관한 Trailhead 콘텐츠를 찾아 줘."

페르소나별 샘플 프롬프트

개발자

"Trailhead는 Apex 대량화 모범 사례에 대해 어떻게 설명하나요?"
"LWC와 관련된 모든 Trailhead 콘텐츠를 찾아 주요 개념을 설명해 줘."
"SOQL 및 SOSL Trailhead 콘텐츠를 가져와 차이점을 요약해 줘."

관리자

"신규 Salesforce 관리자는 어떤 Trailhead 배지를 가장 먼저 취득해야 하나요?"
"Salesforce Flow에 관한 초보자용 Trailhead 콘텐츠를 찾아 줘."
"보고서 및 대시보드에 대한 콘텐츠를 Trailhead에서 검색해 줘."

아키텍트

"고급 수준의 Salesforce 데이터 아키텍처에 대한 콘텐츠를 Trailhead에서 검색해 줘."
"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 콘텐츠를 검색합니다. 답변 시 해당 배지나 트레일의 이름을 출처로 표기합니다.

개인정보 보호 및 데이터 처리

제공되는 콘텐츠

Trailhead MCP가 반환하는 모든 콘텐츠는 공개적으로 이용 가능한 Trailhead 콘텐츠이며, 이는 모든 방문자가 trailhead.com에서 로그인 없이 열람 가능한 내용과 동일합니다. 내부 전용 학습자 데이터, 계정 정보 또는 개인화된 콘텐츠는 포함되지 않습니다.

인증

인증이 필요 없습니다.

Salesforce의 데이터 보호 서약

Trailhead MCP는 사용자의 데이터를 제3자에게 판매하거나 공유하지 않습니다.
Trailhead MCP는 사용자의 쿼리나 프롬프트를 저장, 수집 또는 보관하지 않습니다.
Trailhead MCP는 사용자와의 대화 내용을 AI 모델 훈련에 활용하지 않습니다.
Trailhead MCP는 사용자의 Trailhead 계정, 배지 또는 포인트에 액세스하거나, 이를 읽거나 수정하지 않습니다.

FAQ

예. 공개 콘텐츠에 액세스하는 데는 계정이 필요 없으며 무료로 사용할 수 있습니다.

아니요. 이용 가능한 모든 Trailhead 콘텐츠는 인증 없이 액세스할 수 있습니다.

MCP를 통해 배지를 취득하거나 진행 상황을 추적할 수 없습니다. 게임화 기능 및 개인화된 콘텐츠를 이용하려면 Trailhead.com에 로그인하세요.

콘텐츠 새로 고침: 기술 자료 서비스는 매일 새로 고침됩니다. 가장 최근에 게시된 콘텐츠는 아직 반영되지 않았을 수 있습니다.
대체 표현: 검색은 키워드에 기반하여 이루어집니다. 유의어가 검색 결과에 영향을 줍니다. 'Flow'와 'Salesforce Flow'를 모두 테스트해 보세요.
fetch_content를 바로 사용합니다. 정확한 배지 또는 트레일 이름을 알고 있다면 AI에 이름으로 검색해 달라고 지시합니다.

하루에 한 번.

배지(모듈/단위), 트레일, Trailhead Journey 및 Superbadge를 포함한 모든 Trailhead 콘텐츠가 대상 범위에 포함됩니다.

아니요. Trailhead MCP는 읽기 전용으로 제공됩니다. 쿼리, 프롬프트 또는 사용자 데이터를 저장하지 않습니다. 자세한 내용은 개인정보 보호 및 데이터 처리 섹션을 참조하세요.

Streamable HTTP를 사용하는 모든 MCP 호환 클라이언트가 작동해야 하며, 여기에는 Slackbot, Agentforce, Claude/Claude Code, Cursor 및 VS Code(GitHub Copilot 탑재)가 포함됩니다.

Cursor 클라이언트가 최신 버전인지 확인하고 설정 → MCP에서 MCP 서버 URL이 올바르게 입력되었는지 확인합니다.

아래의 도움 받기 섹션을 참조하세요.

도움 받기

셀프 서비스 문제 해결

위 FAQ를 먼저 확인하세요. 여기에는 콘텐츠를 찾을 수 없는 경우, 405 오류 및 클라이언트별 설정 문제를 포함한 가장 일반적인 문제가 정리되어 있습니다.

클라이언트별 문제 해결

Claude Code: 명령어에 --transport http 및 --scope user가 포함되어 있는지 확인합니다.
Cursor: Settings(설정) → MCP에서 URL이 올바르게 입력되었는지 확인합니다.
VS Code: MCP 설정 JSON이 유효하고 VS Code가 다시 로드되었는지 확인합니다.
Slackbot: MCP 커넥터 아이콘이 보이지 않으면 Slack을 새로 고침해 보세요(Cmd+Shift+R/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' 오류가 발생하면 어떻게 해야 하나요?

다른 문제가 발생했습니다. 어디에서 도움을 받을 수 있나요?