EmDash 文件 MCP

本頁內容

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。結果包含來源 URL 和匹配段落;AI 客戶端決定如何在其回答中使用它們。

連接

伺服器可在以下端點存取,無需身份驗證或 API 金鑰。它是公開的且唯讀的。

https://docs.emdashcms.com/mcp

EmDash 範本中的自動發現

如果你從 EmDash 範本(npm create emdash)啟動專案,三個設定檔已經就位,會自動被偵測到:

檔案使用者
.mcp.jsonClaude Code
.cursor/mcp.jsonCursor
.vscode/mcp.jsonVS 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 伺服器建立應用。建立應用時使用文件 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 工具,將它們指向文件 MCP,使其優先使用真實文件而非猜測:

## 文件

需要驗證 API、鉤子、設定選項或模式時,透過 `emdash-docs` MCP 伺服器查找
EmDash 文件。優先使用文件 MCP 而非訓練資料的猜測——文件反映了目前已發布的
行為。

EmDash 入門範本已預裝此程式碼片段。