EmDash 內建了一個 MCP 伺服器,讓 AI 助手可以直接處理你網站的內容。你可以讓 Claude、ChatGPT 或其他工具來起草文章、更新頁面、管理媒體、搜尋內容等——一切透過自然對話完成。
MCP 伺服器
MCP 伺服器預設啟用——/_emdash/api/mcp 路由會自動掛載,除非你明確關閉它。它始終需要認證,因此沒有有效憑證不會暴露任何內容。
要停用它,在 Astro 設定中設定 mcp: false:
emdash({
mcp: false,
})
設定
你網站的 MCP 伺服器 URL 為:
https://example.com/_emdash/api/mcp
將 example.com 替換為你的網域。本地開發時使用 http://localhost:4321/_emdash/api/mcp。
Claude
在 claude.ai 中新增的連接器在網頁端和 Claude Desktop 中均可使用。
-
前往 設定 > 連接器
-
點擊 新增自訂連接器
-
輸入你網站的 MCP 伺服器 URL
-
點擊 新增——瀏覽器會開啟,供你登入並授權存取
-
開始新對話,點擊聊天輸入框中的 +,然後點擊 連接器,啟用你的網站
對於 Team 和 Enterprise 方案,擁有者首先從 管理設定 > 連接器 新增連接器。成員然後從各自的設定中個別連接。
ChatGPT
ChatGPT 在 Pro、Business 和 Enterprise 方案中支援 MCP 伺服器。
-
前往 設定 > 應用程式和連接器 > 進階設定 並啟用 開發者模式
-
前往 設定 > 連接器 > 建立
-
輸入名稱、描述和你網站的 MCP 伺服器 URL
-
點擊 建立
-
在對話中,點擊編輯器旁的 +,然後點擊 更多,選擇你的連接器
你可以做什麼
連接後,你可以用自然語言要求 AI 助手執行以下任何操作。你不需要知道工具名稱——只需描述你想要的即可。
內容
- 瀏覽內容 ——「顯示最新的 10 篇部落格文章」或「尋找所有草稿頁面」
- 閱讀內容 ——「取得名為 ‘hello-world’ 的文章並摘要」
- 建立內容 ——「寫一篇關於夏季促銷的新部落格文章」或「為關於區段建立一個草稿頁面」
- 編輯內容 ——「更新價格頁面以提及新方案」或「修正 FAQ 文章中的錯字」
- 發佈和排程 ——「發佈夏季促銷文章」、「將公告排程到 6 月 1 日上午 9 點」或「取消發布文章的排程」
- 比較版本 ——「顯示自上次發佈以來首頁有何變化」
- 管理草稿 ——「捨棄關於頁面的草稿變更」或「複製電子報範本」
- 翻譯 ——「歡迎文章有哪些翻譯?」(當啟用 i18n 時)
媒體
- 瀏覽媒體 ——「列出所有已上傳的圖片」或「顯示媒體庫中的 PDF」
- 查看詳情 ——「取得此媒體項目的詳細資訊」
- 註冊上傳 ——「將我剛上傳到
media/2026/banner.png的檔案註冊為媒體項目」 - 更新中繼資料 ——「將首圖的 alt 文字設定為’山間日落’」
- 刪除檔案 ——「刪除舊的橫幅圖片」
搜尋
- 尋找內容 ——「搜尋提及’無障礙’的文章」或「在所有集合中尋找與 TypeScript 相關的內容」
分類法
- 瀏覽 ——「列出所有分類」或「顯示標籤」
- 建立術語 ——「新增一個’教學’標籤」或「在’工程’下建立’前端’子分類」
- 重新命名術語 ——「將’frontend’分類重新命名為’Web Frontend’」
- 移動術語 ——「將’教學’標籤移到’指南’分類下」或「將’react’從其父級分離」
- 刪除術語 ——「刪除未使用的’封存’標籤」
選單
- 檢視選單 ——「顯示主導覽選單」或「頁尾選單裡有什麼?」
- 建立選單 ——「建立一個新的’側邊欄’選單」
- 編輯選單 ——「將’主’選單重新命名為’主要導覽’」
- 設定項目 ——「將主選單的項目替換為首頁、部落格、關於和聯絡」
- 刪除選單 ——「刪除未使用的’行動版’選單」
網站設定
- 檢查 ——「目前的網站標題是什麼?」或「顯示社群連結」
- 更新識別 ——「將網站標題設為’Acme Blog’,標語設為’團隊的故事’」
- 設定 Logo / Favicon ——「使用此圖片作為網站 Logo」(用
media_upload上傳後) - SEO 預設值 ——「將預設 OG 圖片設為新橫幅」或「將標題分隔符號更新為直線」
- 社群帳號 ——「將我們的 Mastodon 和 YouTube 連結新增到社群設定」
Schema(僅管理員)
- 檢查 ——「有哪些集合?」或「顯示文章集合的欄位」
- 建立集合 ——「建立一個帶有名稱和引用欄位的新’推薦語’集合」
- 修改 Schema ——「為文章新增一個’精選’布林欄位」
修訂
- 檢視歷史 ——「顯示此文章的修訂歷史」
- 還原 ——「將文章還原到上一個版本」
權限
當 MCP 用戶端開啟 OAuth 同意頁面時,每個請求的權限預設被選取。在批准存取之前,取消選取用戶端不需要的任何權限。產生的權杖僅限於你保留選取的權限和你的 EmDash 角色允許的權限,因此授予更少的權限永遠不會增加用戶端能做的事情。
| 角色 | AI 能做什麼 |
|---|---|
| 管理員 | 一切,包括 Schema 變更和更新網站設定 |
| 編輯者 | 所有內容、媒體、分類法和選單。可以檢視 Schema 和讀取設定。 |
| 作者 | 自己的內容和媒體 |
| 貢獻者 | 自己的內容(不可發佈)和媒體 |
如果你嘗試沒有權限的操作,AI 會通知你。
提示
- 對集合要具體。 如果有多個集合,請說「建立一篇部落格文章」而不是「建立一篇文章」。
- 先詢問 Schema。 如果不確定集合有哪些欄位,在建立或編輯內容之前先問「文章集合有哪些欄位?」
- 發佈前先審查。 讓 AI 建立內容為草稿,在管理面板中審查,然後讓 AI 發佈——或自己發佈。
- 使用比較進行審查。 發佈前,問「比較這篇文章的已發佈版本和草稿版本」以準確了解將要發生的變化。
- 富文字欄位使用 Portable Text。 AI 可以為富文字欄位撰寫內容,但複雜格式最好在管理編輯器中完成。
面向開發者
MCP 伺服器端點、認證方法、OAuth 探索、工具參數和錯誤處理的文件請參閱 MCP 伺服器參考。