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 を使用しています。クローラーはインデックスを公開サイトと同期させているため、回答は読んでいるドキュメントを反映しています。
接続
サーバーは以下のエンドポイントで到達可能で、認証や API キーは不要です。公開されており、読み取り専用です。
https://docs.emdashcms.com/mcp
EmDash テンプレートでの自動検出
EmDash テンプレート(npm create emdash)からプロジェクトを開始した場合、3つの設定ファイルがすでに配置されており、自動的に検出されます:
| ファイル | 使用者 |
|---|---|
.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 スターターテンプレートには、このスニペットがあらかじめ含まれています。