EmDash 문서 MCP

이 페이지

EmDash 문서 사이트는 https://docs.emdashcms.com/mcp에서 Model Context Protocol 서버를 제공합니다. 코딩 어시스턴트를 이에 연결하면 오래된 훈련 데이터에서 추측하는 대신 작업하면서 문서를 검색할 수 있습니다.

이것은 사이트의 MCP 서버와 별개입니다(AI 도구 가이드에서 다룹니다). 문서 MCP는 EmDash의 문서에 대해서만 알고 있으며 콘텐츠를 읽거나 수정할 수 없습니다. 대부분의 개발자는 두 가지를 모두 원합니다: 문서 MCP는 정보를 찾고 사이트 MCP는 콘텐츠를 관리합니다.

기능

문서 MCP는 단일 도구를 제공합니다:

도구목적
search_docsEmDash 문서를 검색합니다. 소스 URL과 일치 점수가 포함된 관련 청크를 반환합니다.

내부적으로는 docs.emdashcms.com에서 구축된 인덱스에 대해 Cloudflare AI Search를 사용합니다. 크롤러는 인덱스를 게시된 사이트와 동기화하므로 답변은 읽고 있는 문서를 반영합니다.

연결 방법

엔드포인트는 다음과 같습니다:

https://docs.emdashcms.com/mcp

인증 불필요, API 키 불필요. 공개적이며 읽기 전용입니다.

EmDash 템플릿에서의 자동 검색

EmDash 템플릿(npm create emdash)에서 프로젝트를 시작한 경우 세 개의 구성 파일이 이미 준비되어 있으며 자동으로 감지됩니다:

파일사용 도구
.mcp.jsonClaude Code
.cursor/mcp.jsonCursor
.vscode/mcp.jsonVS 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 스타터 템플릿에는 이 스니펫이 미리 포함되어 있습니다.