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)からプロジェクトを開始した場合、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 スターターテンプレートには、このスニペットが事前に含まれています。