EmDash 문서 사이트는 https://docs.emdashcms.com/mcp에서 Model Context Protocol 서버를 제공합니다. 코딩 어시스턴트를 이에 연결하면 오래된 훈련 데이터에서 추측하는 대신 작업하면서 문서를 검색할 수 있습니다.
이것은 사이트의 MCP 서버와 별개입니다(AI 도구 가이드에서 다룹니다). 문서 MCP는 EmDash의 문서에 대해서만 알고 있으며 콘텐츠를 읽거나 수정할 수 없습니다. 대부분의 개발자는 두 가지를 모두 원합니다: 문서 MCP는 정보를 찾고 사이트 MCP는 콘텐츠를 관리합니다.
기능
문서 MCP는 단일 도구를 제공합니다:
| 도구 | 목적 |
|---|---|
search_docs | EmDash 문서를 검색합니다. 소스 URL과 일치 점수가 포함된 관련 청크를 반환합니다. |
내부적으로는 docs.emdashcms.com에서 구축된 인덱스에 대해 Cloudflare AI Search를 사용합니다. 크롤러는 인덱스를 게시된 사이트와 동기화하므로 답변은 읽고 있는 문서를 반영합니다.
연결 방법
엔드포인트는 다음과 같습니다:
https://docs.emdashcms.com/mcp
인증 불필요, API 키 불필요. 공개적이며 읽기 전용입니다.
EmDash 템플릿에서의 자동 검색
EmDash 템플릿(npm create emdash)에서 프로젝트를 시작한 경우 세 개의 구성 파일이 이미 준비되어 있으며 자동으로 감지됩니다:
| 파일 | 사용 도구 |
|---|---|
.mcp.json | Claude Code |
.cursor/mcp.json | Cursor |
.vscode/mcp.json | VS Code |
프로젝트를 열고 처음 실행할 때 도구가 표시하는 작업 공간 신뢰 프롬프트를 수락하기만 하면 됩니다. 다른 작업은 필요하지 않습니다.
수동 설정
템플릿을 사용하지 않거나 다른 도구를 사용하는 경우 클라이언트에 맞는 스니펫으로 한 번 추가합니다:
Claude Code
Claude Code CLI로 서버를 추가합니다:
claude mcp add --transport http emdash-docs https://docs.emdashcms.com/mcp또는 프로젝트 루트에 .mcp.json을 커밋합니다:
{
"mcpServers": {
"emdash-docs": {
"type": "http",
"url": "https://docs.emdashcms.com/mcp"
}
}
} OpenCode
opencode.jsonc에 추가합니다:
{
"mcp": {
"emdash-docs": {
"type": "remote",
"url": "https://docs.emdashcms.com/mcp"
}
}
} Cursor
프로젝트 루트에 .cursor/mcp.json을 커밋하거나 Cursor Settings -> MCP -> Add new MCP server를 통해 추가합니다:
{
"mcpServers": {
"emdash-docs": {
"type": "http",
"url": "https://docs.emdashcms.com/mcp"
}
}
} VS Code
프로젝트의 .vscode/mcp.json(또는 사용자 설정)에 추가합니다:
{
"servers": {
"emdash-docs": {
"type": "http",
"url": "https://docs.emdashcms.com/mcp"
}
}
} Claude Desktop
Claude Desktop은 기본적으로 stdio MCP 서버만 지원하므로 mcp-remote를 브리지로 사용합니다. claude_desktop_config.json에 추가합니다:
{
"mcpServers": {
"emdash-docs": {
"command": "npx",
"args": ["mcp-remote", "https://docs.emdashcms.com/mcp"]
}
}
} 사용 시기
- EmDash 사이트를 구축 중이며 AI 어시스턴트가 반쯤 기억된 훈련 데이터가 아닌 현재 문서에서 올바른 API, 훅 이름 또는 구성 옵션을 찾기를 원하는 경우.
- 플러그인을 작성 중이며 어떤 훅이 어떤 순서로 실행되는지 찾고 싶은 경우.
- WordPress 테마를 이식하고 있으며 시드 파일 패턴의 예가 필요한 경우.
- 오류로 막혀 있으며 릴리스 노트와 개념을 검색하고 싶은 경우.
AGENTS.md에서 추천하기
프로젝트가 AI 도구를 지시하기 위해 AGENTS.md(또는 CLAUDE.md, .cursorrules 등)를 사용하는 경우, 문서 MCP를 가리켜 가정보다 실제 문서를 우선하도록 합니다:
## Documentation
Look up EmDash documentation via the `emdash-docs` MCP server when you need to
verify an API, hook, config option, or pattern. Prefer the docs MCP over
assumptions from training data -- the docs reflect the current published
behaviour.
EmDash 스타터 템플릿에는 이 스니펫이 미리 포함되어 있습니다.