跳到正文
GENNAI
咨询导入

Model Context Protocol

MCP

让 AI 智能体直接读写与管理后台相同数据的 API。文章、部件、图片、SEO 数据、任务与 Wiki，都可以通过 43 个工具来处理。

  • 43个工具
  • 6个类别
  • 权限范围按令牌分配权限

工作原理

1

AI 智能体

Claude 等 MCP 客户端。由技能掌握操作步骤

2

MCP 服务器

根据 manifest 自动生成工具（stdio / Streamable HTTP）

3

GENNAI CMS

/api/mcp/*（Bearer 令牌 + 权限范围）

令牌与权限范围

  • • 令牌在管理后台的“MCP 集成”中签发。可按用途分别创建
  • • 按权限范围授权，例如读取（posts.read）与写入（posts.write）
  • • 可以创建只负责委托图片、只读取报告之类的最小权限智能体
  • • 插件可以添加自己的工具与权限范围（cms.mcp.tools / cms.mcp.scopes）
获取工具列表
curl -H "Authorization: Bearer <令牌>" \
  http://localhost:<CMS端口>/api/mcp/manifest

MCP 服务器在启动时读取该 manifest 来生成工具，因此只要在 CMS 端添加工具，智能体端无需修改配置即可使用。

工具列表

文章5

posts.read / posts.write
  • GETposts.list文章列表（搜索、排序）
  • GETposts.get获取文章（含正文）
  • POSTposts.create新建文章（全部字段）
  • PATCHposts.update更新改写、元信息与部件关联
  • GETcategories.list分类列表

部件10

parts.read / parts.write
  • GETparts.list部件列表
  • GETparts.get获取部件
  • POSTparts.create创建部件
  • PATCHparts.update更新部件
  • POSTparts.preview代入变量预览 HTML
  • GETpart_groups.list部件组列表
  • GETpart_groups.get获取部件组（含内容）
  • POSTpart_groups.create创建部件组
  • PATCHpart_groups.update更新部件组（同步内容）
  • POSTpart_groups.preview预览部件组的 HTML

创意素材（图片）10

creatives.read / creatives.write
  • GETcreatives.list创意素材列表
  • GETcreatives.get获取创意素材
  • POSTcreatives.create订制图片
  • PATCHcreatives.update更新创意素材
  • POSTcreatives.insert_to_post插入到文章正文的指定位置
  • GETcreatives.versions_list版本列表
  • POSTcreatives.set_final_version确定交付的版本
  • GETcreative_codex_jobs.list生成任务列表
  • POSTcreative_codex_jobs.claim认领生成任务（供 Worker 使用）
  • PATCHcreative_codex_jobs.update报告生成结果

SEO、分析5

reports.read / analytics.read
  • GETreports.listSEO 日报列表
  • GETreports.getSEO 日报详情
  • GETreports.latest最新的 SEO 日报
  • GETsearch.performanceSearch Console 的搜索效果
  • GETkeywords.list目标关键词列表

任务、Wiki12

tasks.* / wiki.*
  • GETepics.list史诗（Epic）列表
  • GETepics.get获取史诗（Epic）
  • POSTepics.create创建史诗（Epic）
  • PATCHepics.update更新史诗（Epic）
  • GETtasks.list任务列表（按状态、优先级筛选）
  • GETtasks.get获取任务
  • POSTtasks.create创建任务
  • PATCHtasks.update更新任务（状态流转等）
  • GETwiki.listWiki 页面列表
  • GETwiki.get获取 Wiki 页面
  • POSTwiki.create创建 Wiki 页面
  • PATCHwiki.update更新 Wiki 页面

内容导出1

content.export
  • POSTcontent.export将 DB 中的内容导出为文件并提交到 git
查看使用 MCP 的技能用插件添加工具