EmDash 内置 MCP 服务器,让 AI 助手直接操作站点内容。您可以用自然语言请 Claude、ChatGPT 等起草文章、更新页面、管理媒体、搜索内容等。
启用 MCP 服务器
MCP 服务器默认关闭。在 Astro 配置中开启:
emdash({
mcp: true,
})
接入设置
您站点的 MCP 服务器地址为:
https://example.com/_emdash/api/mcp
将 example.com 换成您的域名。本地开发请使用 http://localhost:4321/_emdash/api/mcp。
Claude
在 claude.ai 添加的连接器在网页版与 Claude Desktop 中均可使用。
-
点击 Add custom connector
-
填写站点的 MCP 服务器 URL
-
点击 Add — 浏览器会打开以便登录并授权
-
新建对话,在输入框点击 +,再选 Connectors,打开您的站点
Team 与 Enterprise 套餐需由 Owner 先在 Admin Settings > Connectors 添加连接器,成员再在各自设置中单独连接。
ChatGPT
ChatGPT 在 Pro、Business、Enterprise 套餐支持 MCP 服务器。
-
进入 Settings > Apps & Connectors > Advanced settings,启用 Developer Mode
-
进入 Settings > Connectors > Create
-
填写名称、描述和站点 MCP 服务器 URL
-
点击 Create
-
在对话中点击输入区附近的 +,再选 More,选择您的连接器
能做什么
连接后,可用自然语言让 AI 执行下列操作,无需记住工具名称。
内容
- 浏览 — 「显示最新 10 篇博客」或「找出所有草稿页面」
- 阅读 — 「获取名为 hello-world 的文章并摘要」
- 创建 — 「写一篇夏季促销博客」或「为关于我们版块建草稿页」
- 编辑 — 「更新定价页提到新套餐」或「修正 FAQ 文章里的错字」
- 发布与定时 — 「发布夏季促销文」或「把公告定在 6 月 1 日 9 点」
- 对比版本 — 「首页自上次发布后改了什么」
- 管理草稿 — 「丢弃 about 页的草稿修改」或「复制邮件模板」
- 翻译 — 「欢迎文章有哪些语言版本?」(启用 i18n 时)
媒体
- 浏览 — 「列出所有已上传图片」或「媒体库里的 PDF」
- 查看详情 — 「这个媒体项的详细信息」
- 更新元数据 — 「把头图 alt 设为 Mountain sunset」
- 删除 — 「删掉旧横幅图」
搜索
- 查找 — 「搜索提到 accessibility 的文章」或「在所有集合里找 TypeScript 相关内容」
分类法
- 浏览 — 「列出所有分类」或「显示标签」
- 创建词条 — 「添加 tutorials 标签」或「在 Engineering 下建 Frontend 子类」
菜单
- 查看 — 「显示主导航菜单」或「页脚菜单里有什么?」
模式(仅管理员)
- 查看 — 「有哪些集合?」或「posts 集合有哪些字段?」
- 创建集合 — 「新建 testimonials 集合,含 name、quote 字段」
- 修改模式 — 「给 posts 加 featured 布尔字段」
修订
- 历史 — 「这篇文章的修订历史」
- 恢复 — 「把文章恢复到上一版」
权限
通过 AI 能做什么取决于您在 EmDash 中的角色。AI 与后台权限一致。
| 角色 | AI 可执行的操作 |
|---|---|
| Admin | 全部,含模式变更 |
| Editor | 所有内容、媒体、分类法、菜单;可查看模式。 |
| Author | 自己的内容与媒体 |
| Contributor | 自己的内容(不可发布)与媒体 |
越权操作时 AI 会告知。
提示
- 集合要说清楚。 若有多个集合,说「创建博客文章」而不是泛泛的「创建文章」。
- 先问模式。 不确定字段时,先问「posts 集合有哪些字段?」再创建或编辑。
- 发布前复核。 可让 AI 先建草稿,在后台看过再请其发布,或自行发布。
- 用对比做审阅。 发布前可问「对比这篇文章线上版与草稿」看清差异。
- 富文本使用 Portable Text。 AI 可写简单内容,复杂排版宜在后台编辑器完成。
面向开发者
MCP 端点、认证方式、OAuth 发现、工具参数与错误处理见 MCP 服务器参考。