EmDash Docs MCP

このページ

EmDash ドキュメントサイトは、https://docs.emdashcms.com/mcpModel Context Protocol サーバーを公開しています。コーディングアシスタントをこれに接続すると、作業中にアシスタントがドキュメントを検索でき、古くなっている可能性のあるトレーニングデータから推測する代わりに使用できます。

これはサイトの MCP サーバーとは別のものです(AI ツールガイドで説明されています)。ドキュメント MCP は EmDash のドキュメントについてのみ知っており、コンテンツを読み取ったり変更したりすることはできません。ほとんどの開発者は両方を望んでいます:情報を調べるためのドキュメント MCP と、コンテンツを管理するためのサイト MCP です。

機能

ドキュメント MCP は単一のツールを公開します:

ツール目的
search_docsEmDash ドキュメントを検索します。ソース URL とマッチスコアを含む関連する断片を返します。

内部的には、docs.emdashcms.com から構築されたインデックス上で Cloudflare AI Search を使用しています。クローラーはインデックスを公開サイトと同期させているため、回答は読んでいるドキュメントを反映しています。

接続

サーバーは以下のエンドポイントで到達可能で、認証や API キーは不要です。公開されており、読み取り専用です。

https://docs.emdashcms.com/mcp

EmDash テンプレートでの自動検出

EmDash テンプレート(npm create emdash)からプロジェクトを開始した場合、3つの設定ファイルがすでに配置されており、自動的に検出されます:

ファイル使用者
.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 スターターテンプレートには、このスニペットがあらかじめ含まれています。