AI 工具

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。

你可以做什么

连接后，你可以用自然语言要求 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。 如果不确定集合有哪些字段，在创建或编辑内容之前先问”文章集合有哪些字段？”
• 发布前先审查。 让 AI 创建内容为草稿，在管理面板中审查，然后让 AI 发布——或自己发布。
• 使用比较进行审查。 发布前，问”比较这篇文章的已发布版本和草稿版本”以准确了解将要发生的变化。
• 富文本字段使用 Portable Text。 AI 可以为富文本字段编写内容，但复杂格式最好在管理编辑器中完成。

面向开发者

MCP 服务器端点、认证方法、OAuth 发现、工具参数和错误处理的文档请参阅 MCP 服务器参考。