EmDash 文件網站在 https://docs.emdashcms.com/mcp 提供了一個 Model Context Protocol 伺服器。將您的編碼助手連接到它,助手就可以在您工作時搜尋文件,而不是從可能過時的訓練資料中猜測。
這與您網站的 MCP 伺服器是分開的(在 AI 工具指南中介紹)。文件 MCP 只了解 EmDash 的文件——它無法讀取或修改您的內容。大多數開發者想要兩者:用於查找資訊的文件 MCP,以及用於管理內容的網站 MCP。
它的功能
文件 MCP 提供單個工具:
| 工具 | 用途 |
|---|---|
search_docs | 搜尋 EmDash 文件。傳回帶有來源 URL 和匹配分數的相關片段。 |
在幕後,它使用 Cloudflare AI Search 對從 docs.emdashcms.com 建立的索引進行搜尋。爬蟲使索引與發布的網站保持同步,因此答案反映了您正在閱讀的文件。
連接它
伺服器可透過以下端點存取,無需驗證或 API 金鑰。它是公開且唯讀的。
https://docs.emdashcms.com/mcp
EmDash 範本中的自動發現
如果您從 EmDash 範本(npm create emdash)啟動專案,三個設定檔已經就位,將自動被偵測到:
| 檔案 | 使用者 |
|---|---|
.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 中推薦它
如果您的專案使用 AGENTS.md(或 CLAUDE.md、.cursorrules 等)來指導 AI 工具,請將它們指向文件 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 啟動範本預裝了此程式碼片段。