AI 代理 (MCP)

适用于 AI 代理的 Zinn® Chat

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

36 个操作:21 个免费,15 个属于 Pro。

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

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

我们的维京人 Zinn® 在 AI 助手连接到平台工具时欢呼。

分三步完成设置

  1. 检查开关

    您需要 WordPress 6.9 或更高版本以及 Zinn® Chat 2.9.0 或更高版本。在插件的设置中,“允许 AI 代理 (MCP)”处于开启状态,除非您将其关闭。

  2. 创建应用密码

    在 WordPress 中,打开“用户”,然后选择“个人资料”,并添加一个以您的 AI 应用命名的应用程序密码。将其复制:WordPress 只会显示一次。

  3. 将站点添加到您的 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"
      }
    }
  }
}

Claude 和 ChatGPT(登录)

将连接地址作为自定义连接器添加到 Claude,或作为自定义 MCP 服务器添加到 ChatGPT。它们会打开您的站点,以便您以 WordPress 用户身份进行批准,无需复制应用程序密码。您的站点需要使用美观的固定链接。

其他应用

任何通过标准输入和输出支持 MCP 服务器的应用程序都可以使用相同的命令和设置。仅连接到远程 HTTP 服务器的应用程序可以直接使用相同的用户名和应用程序密码访问连接地址。

AI 智能体可以做什么

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

操作功能说明版本
回复工单通过电子邮件(text)回复客户,或添加内部备注(note: true);状态可选择性地更改工单状态。免费版
咨询助理向网站的 AI 助手提问,并返回其答案以及找到的所有来源。免费版
批量更改多个工单 (Pro)更改最多 100 个工单(编号)的状态、优先级或经办人。每个工单都经过与单独更改时相同的检查;结果中会列出每一个工单。专业版
将聊天转化为工单从聊天中创建工单以便通过电子邮件回复(需要访客的电子邮件地址)。免费版
关闭聊天结束聊天;访客仍可索取聊天记录。免费版
提交工单代表客户提交工单(包括其电子邮件、主题和第一条消息)。免费版
删除已保存的回复 (Pro)删除已保存的回复。专业版
删除工单永久删除工单及其对话(仅限经理)。免费版
从工单草拟帮助文章 (Pro)根据已解决的工单起草知识库文章草稿;在人工发布之前,它将一直保持为草稿状态。专业版
为未解答的问题起草帮助文章 (Pro)撰写草稿知识库文章以回答所选问题(ID);它们将保持草稿状态。专业版
填写保存的回复 (Pro)返回已保存回复的文本,其中包含针对单个聊天或工单填充的占位符。专业版
阅读聊天返回某个聊天的消息和访客详细信息(after:仅返回此 ID 之后较新的消息)。免费版
阅读支持概述返回每个状态下的工单数量、正在等待人工服务的聊天数量(及其未读消息数),以及聊天、助理和工单功能是否已开启。免费版
读取聊天设置返回所有聊天设置:小部件、助理、人员和营业时间、工单与电子邮件、网站索引、隐私与垃圾信息。免费版
查看支持统计信息 (Pro)返回最近 N 天(天)的聊天和工单数量、响应时间以及评分。专业版
阅读工单返回一张工单及其完整的对话内容、状态、优先级和经办人。免费版
将聊天转回给助手将聊天发送至 AI 助手,由其根据网站内容回答访客的问题。免费版
查看已保存的回复 (Pro)列出客服人員可插入的已儲存回覆及其捷徑。专业版
列出实时聊天列出等待中、进行中和最近关闭的聊天,以及每个聊天的处理人员。免费版
列出助手已知的信息按分页列出助手回答所依据的内容及其索引状态。免费版
列出未回答的问题 (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 服务器