AI 智能体 (MCP)

面向 AI 智能体的 Tranzly

您的 WordPress 网站本身就是一个 MCP 服务器。AI 助手使用应用程序密码作为 WordPress 用户登录,且只能执行该用户在 Tranzly 中有权执行的操作 — 绝无多余权限。

73 项操作:免费版 53 项,Pro 版 20 项。

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

仅需三步即可完成设置

  1. 检查开关

    您需要 WordPress 6.9 或更高版本,以及 Tranzly 3.19.0 或更高版本。在插件设置中,除非您手动关闭,否则“允许 AI 智能体 (MCP)”默认处于开启状态。

  2. 创建应用程序密码

    在 WordPress 中,打开“用户”,然后进入“个人资料”,添加一个以您的 AI 应用程序命名的应用程序密码。请复制它:WordPress 仅显示一次。

  3. 将站点添加到您的 AI 应用程序

    使用您的 WordPress 用户名、应用程序密码以及站点的连接地址:

https://example.com/wp-json/tranzly/v1/mcp

主流 AI 应用的配置

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

Claude Desktop

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

Claude Code

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

Cursor

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

VS Code

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

Claude 和 ChatGPT(登录)

在 Claude 中将连接地址添加为自定义连接器,或在 ChatGPT 开发者模式中添加为应用。它们会打开您的站点,以便您以 WordPress 用户身份进行授权,无需复制应用程序密码。您的站点需要启用自定义固定链接(Pretty Permalinks)。

其他应用

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

AI 智能体可以做什么

插件自身界面可以执行的所有操作。标有 Pro 的操作需要 Tranzly Pro 许可证。

免费版

  • 取消任务(免费)— 停止任务;已生成的翻译将被保留。
  • 连接到支持(免费)— 将此站点连接到 Zinn Digital® 支持(姓名、电子邮箱、同意书)。
  • 修改翻译(免费)— 保存翻译中修改后的段落(segments:键与文本);修改后的文本将受到保护,避免被重复翻译。
  • 启动翻译任务(免费)— 启动后台任务,将指定的文章列表(posts)或整个文章类型翻译为指定的目标语言(langs)。
  • 创建空白翻译(免费)— 为文章创建指定语言(lang)的草稿翻译,无需引擎即可手动编写。
  • 手动创建分类术语翻译(免费)— 使用您提供的名称、别名和描述创建指定语言的术语翻译。
  • 断开与支持的连接(免费)— 断开此站点与支持的连接。
  • 预估翻译费用(免费)— 在产生任何支出之前,预估使用指定引擎将文章(posts 或 post_type)翻译为目标语言(langs)所需的字符数和费用。
  • 翻译缺失内容(免费)— 将特定语言和文章类型中所有缺失(或已过期)的项目加入翻译队列。
  • 读取 DeepL 使用量(免费)— 返回已保存的 DeepL 密钥本月的字符使用量及额度上限。
  • 读取站点诊断信息(免费)— 返回支持工单所包含的诊断信息:版本、活跃插件、限制以及最近的错误。
  • 读取显示选项(免费)— 返回语言切换器和制作信息(credit)的显示设置。
  • 读取引擎设置(免费)— 返回默认和备用引擎、按语言划分的引擎和 AI 模型、每个引擎的状态、已连接的 AI 提供商及其模型,以及本月的支出。
  • 读取集成信息(免费)— 列出 Tranzly 支持的 SEO、WooCommerce、页面构建器和表单插件,以及当前站点中已启用的插件。
  • 读取任务进度(免费)— 返回单个任务的进度及计数。
  • 读取任务失败项(免费)— 列出任务的失败项目及其原因。
  • 读取 Tranzly 2.x 导入(免费)— 返回从 Tranzly 2.x 导入翻译的状态和报告。
  • 读取许可证(免费)— 返回此站点的 Tranzly 方案、许可证状态、续费日期以及方案包含的内容。
  • 读取每种语言的菜单(免费)— 返回每种语言在各个菜单位置显示的菜单。
  • 读取文章翻译(免费)— 列出文章的翻译组:每种语言成员的标题、状态和编辑链接。
  • 并排查看翻译(免费)— 并排返回译文与原文的片段,以供审核和更正。
  • 读取主题和插件文本(免费)— 返回特定语言下的主题和插件文本(作用域)及其翻译。
  • 读取特定语言的站点文本(免费)— 返回某种语言下的站点标题、标语和小工具文本。
  • 读取支持连接(免费)— 说明此站点是否已连接至 Zinn Digital® 支持,以及以何种身份连接。
  • 读取分类项翻译(免费)— 列出分类或标签的翻译组。
  • 读取地址设置(免费)— 返回语言在地址中的显示方式(目录、子网域或独立域名)、已翻译的别名和基础路径,以及未翻译页面的 noindex 设置。
  • 将现有文章关联为翻译(免费)— 将现有文章(目标)设为此文章在某种语言下的翻译。
  • 将现有分类项关联为翻译(免费)— 将现有分类项(目标)设为此分类项在某种语言下的翻译。
  • 列出翻译引擎(免费)— 列出翻译引擎、各自是否已配置,以及未指定时使用的默认引擎。
  • 列出翻译任务(免费)— 按最新优先列出后台翻译任务及其进度。
  • 列出语言(免费)— 列出站点的语言。第一种为原始内容编写所用的语言。
  • 列出缺失或过期的内容(免费)— 逐页列出原始内容及其在某种语言下的翻译状态(状态:缺失、已过期、最新)。
  • 提交支持工单(免费)— 提交支持工单(主题、消息、类型、电子邮箱);若管理员同意,还会附带此站点的诊断信息。绝不会创建或发送登录凭据。
  • 同意支持诊断(免费)— 记录管理员关于在支持工单中发送诊断信息的同意状态。
  • 重试或移交失败项(免费)— 重试失败项(操作:retry,可选使用其他引擎)或将其标记为手动翻译(操作:by-hand)。
  • 导入 Tranzly 2.x 翻译(免费)— 运行 2.x 导入:预演(仅报告)、运行或撤销。
  • 保存引擎密钥(免费)— 保存 DeepL、Google 或 Microsoft 的 API 密钥(以及 Microsoft 的区域设置);留空则移除。密钥经过加密存储,且绝不会被返回。
  • 设置每种语言的菜单(免费)— 为每个位置按语言分配菜单(映射)。
  • 保护或解锁翻译(免费)— 保护翻译免遭引擎覆盖(protected: true),或将其解锁。
  • 更正主题和插件文本(免费)— 保存已更正的主题和插件文本(字符串)翻译;这些翻译将被保护。
  • 翻译站点文本(免费)— 保存某种语言下的单个站点文本(键),例如站点标题或标语。
  • 更改地址设置(免费)— 设置地址模式(mode)、每种语言的域名、已翻译的基础路径和分段、noindex_untranslated 以及别名建议。
  • 开启免费 Pro 试用(免费)— 为此站点开启为期 14 天的 Tranzly Pro 试用(无需付款)。
  • 翻译图像文本(免费)— 保存某种语言(lang)下图像的替代文本、标题或说明(field)。
  • 翻译文章或页面(免费)— 使用翻译引擎将单篇文章或页面翻译成站点的一种或多种语言,创建或更新每个翻译。新翻译默认为草稿,除非 publish 设为 true。人工编辑过的翻译将被跳过,除非 force 设为 true。
  • 翻译缺失的主题和插件文本(免费)— 使用默认引擎翻译某种语言下下一页未翻译的主题和插件文本(通过 after 重复执行直至完成)。
  • 翻译分类或标签(免费)— 使用引擎将单个分类项(分类、标签或产品属性)翻译成某种语言(lang),创建或更新其翻译。
  • 翻译状态(免费)— 传入文章 ID 时:该文章在各语言下的翻译、是否已过期以及编写者。未传入时:按语言统计站点的翻译完成度。
  • 取消文章与其翻译的关联(免费)— 将文章从其翻译组中移除;保留其语言设置。
  • 取消分类项与其翻译的关联(免费)— 将分类项从其翻译组中移除。
  • 更改显示选项(免费)— 更改语言切换器(样式、国旗、名称、位置)和署名行。
  • 更改引擎设置(免费)— 设置默认引擎、备用引擎、按语言划分的引擎和按语言划分的 AI 模型(default、fallback、per_lang、models、caps)。除默认引擎外,所有内容均为 Pro 功能。
  • 更改语言和设置(免费版)— 设置站点的语言(languages:包含代码和名称的列表;第一个为原始语言)、前端 class 前缀以及是否允许 AI 代理 (MCP)。

Pro 专业版

  • 翻译整个网站(Pro 版)— 为给定内容类型的所有原始内容启动后台翻译任务(未指定时则为所有已翻译的类型):缺失的翻译、过期的翻译或全部内容。返回已启动的任务,每种语言一个。
  • 使用 AI 检查翻译(Pro 版)— 让 AI 将某篇翻译与其原文进行对比并打分,并将报告存储在该翻译上。使用 Tranzly 工作流设置中设定的质量检查 AI 模型。
  • 估算网站翻译成本 (Pro)(Pro 版)— 在启动前估算某语言的全站翻译(post_types、scope、engine)。
  • 导出一个供人工译员使用的文件 (Pro) — 返回一个 XLIFF 或 CSV 文件(以文本形式),包含单一语言的原文及其译文,供译员或翻译机构使用:指定的文章,或处于某种状态(缺失、已过时、已翻译或全部;使用 after 参数重复)的某种内容类型的最多 100 篇原文组成的一页。翻译完成后,可以将相同的文件导回导入。
  • 读取评论处理方式 (Pro)(Pro 版)— 返回评论是跨语言共享还是按语言独立保留。
  • 读取术语表(Pro 版)— 返回从不翻译的词汇、固定术语翻译以及每种语言的语气。
  • 读取质量报告 (Pro)(Pro 版)— 返回翻译的 AI 质量报告:评分和其标记的片段。
  • 读取工作流设置 (Pro)(Pro 版)— 返回发布时和更新时的自动翻译、发布前审核,以及 AI 质量检查的阈值、服务商和模型。
  • 从 WPML、Polylang 或 TranslatePress 迁移 (Pro)(Pro 版)— 从其他多语言插件导入下一页翻译(mode:dry-run 或 run;cursor)。
  • 写入导入的文件 (Pro)(Pro 版)— 从已上传的翻译文件中写入下一页文章(使用 after 重复,直到完成)。
  • 列出可迁移的插件 (Pro)(Pro 版)— 列出在此站点上找到的可以导入的 WPML、Polylang 和 TranslatePress 数据。
  • 列出主题和插件文本源 (Pro)(Pro 版)— 列出可以扫描以进行翻译的主题和插件,以及各自拥有的字符串数量。
  • 批准或拒绝翻译 (Pro)(Pro 版)— 批准翻译(并在原文已发布时发布它)或将其退回(decision、note)。
  • 扫描主题或插件中的文本 (Pro)(Pro 版)— 扫描组件的下一页 PHP 文件以查找可翻译的文本(使用 after 重复,直到完成)。
  • 使用 AI 检查翻译 (Pro)(Pro 版)— 为某语言的下一页翻译(或指定的文章)排定 AI 质量检查。
  • 多语言 SEO 审计 (Pro)(Pro 版)— 逐页检查某种语言的翻译中是否缺失 SEO 标题、描述、别名和 hreflang。
  • 更改评论处理方式 (Pro)(Pro 版)— 在文章的各种语言版本间共享评论或按语言独立保留(mode)。
  • 更新术语表(Pro 版)— 替换您发送的术语表部分(从不翻译的词汇、术语翻译、语气);未提交的部分将予以保留。从下一次翻译开始由所有引擎使用。
  • 更改工作流设置 (Pro)(Pro 版)— 设置 on_update(off、stale、translate)、on_publish、review、quality_threshold、quality_provider 和 quality_model。
  • 导入已翻译的文件 (Pro) (Pro) — 上传在其他地方翻译的 Tranzly XLIFF 或 CSV 文件(内容、文件名);返回一个标识该上传以用于导入的令牌。

引导式工作流

该服务器还提供现成的工作流,您的 AI 应用程序会将其作为提示词列出:

  • 翻译我的网站(免费版)— 引导式工作流:代理会检查语言和引擎,估算成本,并翻译缺失的内容,在产生费用或发布之前会先征询确认。

设计层面确保安全

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

应用程序密码可随时在“用户”>“个人资料”下撤销,无需更改您的常规密码。

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

智能体更改的页面将保留其 WordPress 修订版本,因此任何更改都可以撤销。

托管在 Zinn Digital®?

如果站点由 Zinn Digital® 托管,我们的自有 MCP 服务器可以为您使用这些操作,而无需应用程序密码:只需将您的 AI 应用程序连接到 Zinn Digital® MCP 服务器,并使用 wordpress_abilities_list 和 wordpress_ability_run 即可。

Zinn Digital® MCP 服务器