EmDash Docs MCP

EmDash 문서 사이트는 https://docs.emdashcms.com/mcp에서 공개 Model Context Protocol 서버를 제공합니다. 코딩 어시스턴트를 연결하여 작업 중 게시된 문서를 검색할 수 있습니다.

이것은 사이트의 MCP 서버와 별개입니다(AI 도구 가이드에서 다룸). Docs MCP는 EmDash의 문서만 알고 있으며 콘텐츠를 읽거나 수정할 수 없습니다. 문서 검색에는 Docs MCP를, 콘텐츠 관리에는 사이트 MCP를, 또는 어시스턴트가 두 가지 접근 모두 필요할 때는 둘 다 연결하세요.

기능

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

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

서버는 docs.emdashcms.com 인덱스에 대해 Cloudflare AI Search를 사용합니다. 결과에는 소스 URL과 매칭되는 구절이 포함되며, AI 클라이언트가 답변에서 어떻게 사용할지 결정합니다.

연결하기

서버는 다음 엔드포인트에서 인증이나 API 키 없이 접근할 수 있습니다. 공개이며 읽기 전용입니다.

https://docs.emdashcms.com/mcp

EmDash 템플릿에서 자동 검색

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

파일	사용처
`.mcp.json`	Claude Code
`.cursor/mcp.json`	Cursor
`.vscode/mcp.json`	VS Code

프로젝트를 열고 도구가 첫 실행 시 표시하는 워크스페이스 신뢰 프롬프트를 수락하세요. 추가 설정은 필요 없습니다.

수동 설정

템플릿을 사용하지 않거나 다른 도구를 사용하는 경우, 클라이언트용 스니펫으로 한 번 추가하세요:

Codex

Codex CLI로 공개 원격 서버를 추가합니다:

codex mcp add emdash-docs --url https://docs.emdashcms.com/mcp

ChatGPT 데스크톱 앱, Codex CLI, IDE 확장은 같은 Codex 호스트에 대한 MCP 설정을 공유합니다. 공식 Codex MCP 문서에서 CLI, config.toml, 현재 트랜스포트 지원을 다룹니다.

ChatGPT

ChatGPT 개발자 모드는 인증 없이 원격 MCP 서버에서 앱을 만들 수 있습니다. 앱 생성 시 Docs MCP 엔드포인트를 사용하세요. 복사된 설정 경로에 의존하지 말고 공식 ChatGPT 개발자 모드 가이드를 따라 현재 자격 요건과 제어를 확인하세요.

Claude Code

다음 명령어로 Claude Code CLI에 서버를 추가합니다:

claude mcp add --transport http emdash-docs https://docs.emdashcms.com/mcp

또는 EmDash 템플릿이 제공하는 동일한 .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의 MCP 문서를 따르세요:

{
  "mcpServers": {
    "emdash-docs": {
      "type": "http",
      "url": "https://docs.emdashcms.com/mcp"
    }
  }
}

VS Code

프로젝트의 .vscode/mcp.json에 다음 항목을 추가합니다. 사용자 수준 설정과 신뢰 제어는 Visual Studio Code의 MCP 문서를 따르세요:

{
  "servers": {
    "emdash-docs": {
      "type": "http",
      "url": "https://docs.emdashcms.com/mcp"
    }
  }
}

Claude

엔드포인트를 원격 커스텀 커넥터로 추가합니다. 커넥터 화면과 플랜 요구사항은 Anthropic이 제어하므로, 현재 원격 MCP 커넥터 안내를 따르세요.

사용 시기

EmDash 사이트를 구축 중이며 AI 어시스턴트가 불완전한 훈련 데이터가 아닌 현재 문서에서 올바른 API, 훅 이름 또는 설정 옵션을 조회하길 원할 때.
플러그인을 작성 중이며 어떤 훅이 어떤 순서로 실행되는지 알고 싶을 때.
WordPress 테마를 포팅 중이며 시드 파일 패턴 예제가 필요할 때.
오류에 막혀서 릴리스 노트와 개념을 검색하고 싶을 때.

`AGENTS.md`에서 추천하기

프로젝트에서 AGENTS.md(또는 CLAUDE.md, .cursorrules 등)를 사용하여 AI 도구에 지시하는 경우, Docs MCP를 가리켜 추측보다 실제 문서를 선호하도록 하세요:

## 문서

API, 훅, 설정 옵션 또는 패턴을 확인해야 할 때 `emdash-docs` MCP 서버를 통해
EmDash 문서를 조회하세요. 훈련 데이터의 추측보다 Docs MCP를 선호하세요
-- 문서는 현재 게시된 동작을 반영합니다.

EmDash 스타터 템플릿에는 이 스니펫이 사전 포함되어 있습니다.