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.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/mcpChatGPT 桌面應用、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 入門範本已預裝此程式碼片段。