AI 工具

EmDash 内置了 MCP 服务器,让 AI 助手可以直接处理您站点的内容。您可以让 Claude、ChatGPT 或其他工具起草文章、更新页面、管理媒体、搜索内容等等——所有这些都通过自然对话完成。

启用 MCP 服务器

MCP 服务器默认禁用。在您的 Astro 配置中启用它:

emdash({
  mcp: true,
})

设置

您站点的 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 的文件注册为媒体项目”
• 更新元数据 — “将主图像的替代文本设置为’山间日落’”
• 删除文件 — “删除旧横幅图像”

搜索

• 查找内容 — “搜索提到’无障碍’的文章”或”在所有集合中查找有关 TypeScript 的任何内容”

分类

• 浏览 — “列出所有类别”或”显示标签”
• 创建术语 — “添加’教程’标签”或”在’工程’下创建’前端’子类别”
• 重命名术语 — “将’frontend’类别重命名为’Web Frontend’”
• 移动术语 — “将’教程’标签移至’指南’类别下”或”将’react’从其父级分离”
• 删除术语 — “删除未使用的’存档’标签”

菜单

• 查看菜单 — “显示主导航菜单”或”页脚菜单中有什么?”
• 创建菜单 — “创建新的’sidebar’菜单”
• 编辑菜单 — “将’main’菜单重命名为’主导航’”
• 设置项目 — “用 Home、Blog、About 和 Contact 替换主菜单中的项目”
• 删除菜单 — “删除未使用的’mobile’菜单”

站点设置

• 检查 — “当前站点标题是什么?”或”显示社交链接”
• 更新身份 — “将站点标题设置为’Acme Blog’,标语设置为’来自团队的故事’”
• 设置徽标/网站图标 — “使用此图像作为站点徽标”(使用 media_create 注册后)
• SEO 默认值 — “将默认 OG 图像设置为新横幅”或”将标题分隔符更新为竖线”
• 社交账号 — “将我们的 Mastodon 和 YouTube 链接添加到社交设置”

架构(仅管理员)

• 检查 — “存在哪些集合?”或”显示文章集合中的字段”
• 创建集合 — “创建包含姓名和引用字段的新’testimonials’集合”
• 修改架构 — “向文章添加’featured’布尔字段”

修订

• 查看历史记录 — “显示此文章的修订历史记录”
• 恢复 — “将文章恢复到其先前版本”

权限

您可以通过 AI 工具执行的操作取决于您的 EmDash 角色。AI 助手使用您在管理面板中拥有的相同权限运行:

如果您尝试访问没有权限的内容,AI 会告诉您。

提示

• 明确集合。 如果您有多个集合,请说”创建博客文章”而不是”创建文章”。
• 先询问架构。 如果您不确定集合有哪些字段,请在创建或编辑内容之前询问”文章集合有哪些字段?”
• 发布前审查。 让 AI 将内容创建为草稿,在管理面板中审查,然后让 AI 发布它——或者您自己发布。
• 使用比较进行审查。 在发布之前,询问”比较此文章的实时版本和草稿版本”以准确查看将发生的更改。
• 富文本字段使用 Portable Text。 AI 可以为富文本字段编写内容,但复杂的格式最好在管理编辑器中完成。

面向开发者

MCP 服务器端点、身份验证方法、OAuth 发现、工具参数和错误处理记录在 MCP 服务器参考中。