瓜奇MCP使用方法

什么是瓜奇 MCP？

瓜奇 MCP 是一个让 AI 连接网站后台的内容发布入口。接入以后，你可以直接告诉 AI 要发布什么内容，AI 会按照网站已有的分类、语言、用户组和权限规则，把内容写入 WordPress 后台。

它适合网站管理员、运营人员和内容团队使用。你不需要懂代码，只需要准备好 MCP 地址、WordPress 用户名和应用程序密码。

瓜奇 MCP 能做什么？

发布、编辑、更新文章。
发布商品，包括普通商品、多规格商品、虚拟商品、积分商品、询盘商品、淘宝客商品。
发布社区帖子，并支持悬赏、投票、红包等帖子功能。
发布链接，设置链接图标、截图、标签、分类和 SEO。
发布文档，设置上一篇、下一篇、FAQ、SEO、阅读权限。
上传或复用图片，包括特色图、商品图、链接图标、画廊图。
设置分类、标签、品牌、商品属性、社区节点、文档分类。
设置多语言内容和阅读权限。
设置 SEO 标题、SEO 描述、SEO 关键词和 FAQ 问答。

瓜奇 MCP 不能做什么？

它不是前台页面设计工具，不负责生成 UI。
它不会绕过后台权限，必须使用有权限的 WordPress 用户。
它不会自动猜测网站里不存在的语言、分类或用户组。
已经绑定语言的分类，不能通过 MCP 强行改成另一种语言。

接入前需要准备什么？

MCP 地址：格式通常是 https://你的域名/wp-json/gqapi/v1/mcp。
WordPress 用户名：建议单独创建一个给 AI 使用的后台用户。
WordPress 应用程序密码：在 WordPress 后台用户资料页面生成。

建议这个用户至少拥有编辑内容的权限。如果需要上传图片，还需要有上传媒体的权限。

通用接入方法

在支持 MCP 的 AI 工具里新增一个 MCP 服务，通常需要填写这些信息：

名称：自定义，例如 guaqi、guaqi-test、my-site。
类型：Streamable HTTP、HTTP MCP 或 Remote MCP。
地址：https://你的域名/wp-json/gqapi/v1/mcp。
认证方式：Bearer Token 或自定义请求头。
请求头名称：Authorization。
请求头内容：Bearer 生成出来的Base64字符串。

如何生成 Base64 字符串？

BASE64(用户名:应用程序密码) 只是说明格式，不能原样填写。你需要先把 用户名:应用程序密码 生成一串真正的 Base64 字符串。

在 Windows PowerShell 里运行：

$token = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("你的用户名:你的应用程序密码"))
$token

如果工具要求填写完整请求头，填写：

Bearer 生成出来的Base64字符串

不要这样填：

Bearer BASE64(guaqieditor:abcd efgh ijkl mnop)

应该这样填：

Bearer Z3VhcWllZGl0b3I6YWJjZCBlZmdoIGlqa2wgbW5vcA==

如果工具有单独的 Bearer Token 输入框，只填写生成出来的 Base64 字符串，不要加 Bearer 前缀。

Codex 接入示例

Codex 推荐用命令添加 MCP，而不是手动修改配置文件。

$token = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("你的用户名:你的应用程序密码"))
[Environment]::SetEnvironmentVariable("GUAQI_MCP_TOKEN", $token, "User")
codex mcp add guaqi --url https://你的域名/wp-json/gqapi/v1/mcp --bearer-token-env-var GUAQI_MCP_TOKEN

添加完成后，重启 Codex，然后运行：

codex mcp list

如果列表里能看到对应 MCP 名称，说明配置已经写入。

接入后怎么检查？

在 AI 工具里可以直接说：

请调用 guaqi MCP，读取使用说明，并列出支持的内容类型。

如果 AI 能返回文章、商品、社区帖子、链接、文档等内容类型，就说明接入成功。

可以直接这样问 AI

发布文章：

帮我发布一篇中文文章，标题是“新手建站指南”，内容围绕 WordPress 建站流程写，放到“教程”分类，添加标签“WordPress”和“建站”，先保存为草稿。

发布商品：

帮我创建一个商品，名称是“会员套餐”，价格 99 元，虚拟商品，不需要物流，支持积分购买，放到“会员服务”分类，先保存为草稿。

发布多规格商品：

帮我创建一个 T 恤商品，有颜色红色、黑色，尺码 M、L、XL，不同组合设置不同库存和价格，每个颜色可以设置不同图片，先保存为草稿。

发布链接：

帮我添加一个友情链接，名称是 Example，网址是 https://example.com，图标用这个图片地址，添加链接标签“工具站”，写好 SEO，保存为草稿。

发布文档：

帮我创建一篇文档，标题是“安装说明”，内容分步骤写，设置 FAQ，关联上一篇文档 ID 123，下一篇文档 ID 456，保存为草稿。

多语言注意事项

如果网站开启了多语言，最好让 AI 先读取网站支持哪些语言，然后再写内容。普通分类、标签、品牌、商品属性、文档分类可以有语言关系。

社区节点和社区话题标签不区分多语言。社区节点的名称和描述需要在同一个节点里填写多语言内容。

用户组注意事项

瓜奇用户组不是 WordPress 默认角色。让 AI 设置用户组权限前，要先读取瓜奇用户组。AI 只能使用网站设置里已经存在的用户组，不能自己编一个用户组。

图片注意事项

如果图片已经有 URL，可以直接让 AI 使用这个 URL，不需要重复生成。如果图片是 AI 新生成的，需要上传到媒体库后再使用。

安全建议

给 AI 单独建一个 WordPress 用户。
不要使用站长主账号。
第一次使用时只让 AI 创建草稿。
重要内容发布前人工检查。
不要把应用程序密码发给不可信的人。