AI 代理 (MCP)

适用于 AI 代理的 Zinn® Chat

您的 WordPress 网站即其自身的 MCP 服务器。AI 助手会以应用密码以 WordPress 用户的身份登录，并能够执行该用户在 Zinn® Chat 中所被允许的操作——仅此而已。

36 个操作：21 个免费，15 个属于 Pro。

开发者参考：每个操作、其 REST 路由及参数

知识库中的同一指南，列出了所有免费操作

分三步完成设置

检查开关
您需要 WordPress 6.9 或更高版本以及 Zinn® Chat 2.9.0 或更高版本。在插件的设置中，“允许 AI 代理 (MCP)”处于开启状态，除非您将其关闭。
创建应用密码
在 WordPress 中，打开“用户”，然后选择“个人资料”，并添加一个以您的 AI 应用命名的应用程序密码。将其复制：WordPress 只会显示一次。
将站点添加到您的 AI 应用中
使用您的 WordPress 用户名、应用程序密码和您网站的连接地址：
```
https://example.com/wp-json/zinn-chat/v1/mcp
```

热门 AI 应用程序的配置

下方每个应用程序都通过官方的 WordPress 代理 @automattic/mcp-wordpress-remote 与您的网站进行通信。请将地址、用户名和密码替换为您自己的。

Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "zinn-chat": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

Claude Code

claude mcp add zinn-chat \
  -e WP_API_URL=https://example.com/wp-json/zinn-chat/v1/mcp \
  -e WP_API_USERNAME=your-username \
  -e WP_API_PASSWORD=your-application-password \
  -- npx -y @automattic/mcp-wordpress-remote@latest

光标

// .cursor/mcp.json
{
  "mcpServers": {
    "zinn-chat": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

VS Code

// .vscode/mcp.json — VS Code's key is "servers"
{
  "servers": {
    "zinn-chat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-wordpress-remote@latest"
      ],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "your-application-password"
      }
    }
  }
}

其他应用

任何支持标准输入和输出的 MCP 服务器的应用都可以使用相同的命令和设置。仅连接到远程 HTTP servers 的应用可以直接通过相同的用户名和应用程序密码访问连接地址。ChatGPT 目前是个例外：它仅通过 OAuth 登录连接到 MCP servers，因此无法使用应用程序密码。

AI 智能体可以做什么

插件自身界面能做到的所有事情。标记为 Pro 的操作需要 Zinn® Chat Pro 许可证。

操作	其功能	版本
回复工单	通过电子邮件（text）回复客户，或添加内部备注（note: true）；状态可选择性地更改工单状态。	免费版
向助手提问	向网站的 AI 助手提问，并返回其答案以及找到的所有来源。	免费版
批量更改工单 (Pro)	更改最多100个工单（ID）的状态、优先级或负责人。每个工单都经过与单独更改时相同的检查，结果会列出每一个工单。	专业版
将聊天转换为工单	从聊天中开启工单以便通过电子邮件回复（需要访客的电子邮件地址）。	免费版
关闭聊天	结束聊天；访客仍可请求获取聊天记录。	免费版
提交工单	代表客户提交工单（包括客户电子邮件、主题和首条消息）。	免费版
删除保存的回复 (Pro)	删除已保存的回复。	专业版
删除工单	永久删除工单及其对话（仅限经理）。	免费版
从服务单起草帮助文章 (Pro)	从已解决的工单中撰写知识库文章草稿；在人工发布之前，它将一直保持草稿状态。	专业版
为未解答的问题起草帮助文章（专业版）	编写回答所选问题（ID）的知识库文章草稿；它们将保持为草稿状态。	专业版
使用保存的回复 (Pro)	返回已保存回复的文本，其中已为某个聊天或工单填充了占位符。	专业版
阅读聊天记录	返回单个聊天的消息和访问者详细信息（after：仅返回此 ID 之后较新的消息）。	免费版
阅读支持概览	返回各种状态下的工单数量、等待人工服务的聊天数量（及其未读消息数），以及聊天、助手和工单功能是否已开启。	免费版
读取聊天设置	返回所有聊天设置：小组件、助手、人员及营业时间、工单与电子邮件、网站索引、隐私与垃圾信息。	免费版
读取支持统计信息 (Pro)	返回最近 N 天（天数）的聊天和工单数量、响应时间及评分。	专业版
查看工单	返回一张工单及其完整的对话、状态、优先级和经办人。	免费版
将对话移交给助手	返回与 AI 助手的一段对话，它会根据网站内容回答访客的问题。	免费版
已保存回复列表 (Pro)	列出客服人员可以插入的已保存回复及其快捷方式。	专业版
列出实时聊天	列出正在等待、进行中以及最近关闭的聊天，并显示每个聊天的处理人员。	免费版
列出助手已知的内容	按页列出助手回答所依据的内容及其索引状态。	免费版
列出未回答的问题 (专业版)	列出访客提出但知识库未能解答的问题。	专业版
工单列表	分页列出支持工单，可按状态或搜索关键词进行筛选。	免费版
重建助手的搜索索引	重新生成单个项目 (item_id) 或所有项目 (all: true) 的搜索向量（仅限管理员）。	免费版
重新向助手朗读内容	重新将单个项目 (item_id) 或所有项目 (all: true) 读取到助手的索引中（仅限管理者）。	免费版
在聊天中回复	向访客发送消息（text），或者添加只有客服可见的内部备注（note: true）。	免费版
保存已保存的回复 (Pro)	创建或修改保存的回复（标题、快捷方式、正文、部门；用于修改的 id）。	专业版
编写帮助文章 (Pro)	创建知识库文章或对其进行修改 (id)：标题、内容、摘要、分类和状态（草稿，或者在可以发布时发布）。	专业版
搜索知识库 (Pro)	查找要在回复中链接的帮助文章（q：搜索）。	专业版
设置对话的部门和标签 (Pro)	设置聊天或工单的部门与标签（类型：chat 或 ticket；id）。	专业版
标记未回答的问题 (Pro)	将未回答的问题标记为开放、已计划或已忽略（ID、状态）。	专业版
设置您的可用时间	将已登录的客服人员标记为新聊天可用或离开（离开：true 或 false）。	免费版
使用 AI 起草回复 (Pro)	根据网站内容草拟对聊天或工单的回复；不会发送任何内容。	专业版
总结与 AI 的对话 (Pro)	用几行文字总结聊天或工单。	专业版
发起聊天	将等待中的聊天分配给已登录的坐席，以便访客与真人对话。	免费版
更改聊天设置	修改您发送的设置（设置：键对应值）并保留其余部分。每个值的检查方式与设置屏幕上完全相同；get-settings 用于列出所有键。	免费版
修改工单	更改工单的状态、优先级或经办人。	免费版

设计安全

每个操作都会检查与插件自身界面相同的 WordPress 权限，针对其所涉及的具体页面或文章。订阅者根本无法连接。

可以在“用户”下的“个人资料”中随时撤销应用密码，而无需更改您的常规密码。

关闭“允许 AI 智能体 (MCP)”后，操作和连接地址将从站点中消失。

代理更改的页面会保留其 WordPress 修订版本，因此任何更改都可以撤消。

使用 Zinn Digital® 托管？

如果 Zinn Digital® 托管该网站，我们自己的 MCP 服务器无需应用程序密码即可为您执行这些操作：将您的 AI 应用连接到 Zinn Digital® MCP 服务器，并使用 wordpress_abilities_list 和 wordpress_ability_run。

Zinn Digital® MCP 服务器