Kling AI Agent Extensions

可灵生成式媒体能力的多客户端扩展仓库：同一套设计原则（OAuth-first、实时 schema、单次计费提交、宿主会话内原生结果），针对不同 Agent 宿主分别打包。当前包含 Codex、Cursor、Kimi Code CLI、Claude Code、WorkBuddy、OpenClaw、千问办公、DeepSeek Harness、TRAE、Pi、Hermes Agent、Grok Build、Manus、Coze 与百度搭子 DuMate。

品牌说明：本项目接入可灵公开提供的服务。除非获得可灵正式授权，不应将第三方发行版本标注为"可灵官方"或暗示品牌背书。

这张图用于汇报表达：左侧是 Codex、Cursor、Claude Code 和未来 MCP/IDE 客户端等宿主；中间的 Host Adapter 收敛安装机制和指令载体差异；共享的 Kling Agent Core 负责 OAuth-first、实时 schema 和单次提交；结果在宿主会话内原生呈现。工程事实以各子项目 README、架构文档和 Mermaid 图为准。

子项目

目录	宿主	分发形态	状态
mcp-app/	共享组件（非宿主）	唯一 standards-first MCP App、结果 widget 与确定性 mock	开发中
codex/	OpenAI Codex	.codex-plugin/plugin.json + Skill，通过本地 marketplace 安装	可用
cursor/	Cursor	Add to Cursor deep link / .cursor/mcp.json + Rule + Agent Skill / 原生 Plugin manifest	可用（公共 Marketplace 上线待办，见下）
kimi/	Kimi Code CLI	kimi.plugin.json + Skill + Commands + MCP server 声明，通过 Kimi Code CLI 的 /plugins install 安装	可用（不显示在 Kimi 桌面 Work 插件市场；公共 Marketplace 上线待办，见下）
claude/	Claude Code	.claude-plugin/plugin.json + Skill + Commands + HTTP MCP	可用（本地 --plugin-dir；公共 Marketplace 上线待办）
workbuddy/workbuddy/	WorkBuddy 国内版	中文 Connector 包 + 国内 OAuth MCP	可用（国内账号）
workbuddy/workbuddy.ai/	WorkBuddy 国际版	English Connector package + Global OAuth MCP	Available (Global accounts)
openclaw/	OpenClaw	openclaw.plugin.json + native entry + Skill + manifest MCP	可用（原生插件；ClawHub 上线待办）
qwenwork/	千问办公（QwenWorkCN）	.qoder-plugin/plugin.json + Skill + MCP + runtime descriptors	可用（本地专家套件；公共市场路径待确认）
deepseek/	DeepSeek Harness	dsh.bundle + 远端 MCP OAuth + Agent Skill	可用（本地安装、OAuth 与实时工具验证）
trae/	TRAE	mcp.json + TRAE CN MCP import link + 项目 Rule + 市场提交材料	可用（手动/链接安装；市场审核待提交）
pi/	Pi	Pi package + pi-mcp-adapter + Agent Skills	已发布至 npm 与 Pi Package Gallery
hermes/	Hermes Agent	原生 mcp_servers 配置 + Agent Skills	可用（官方 Catalog + optional-skills 提交包已就绪，待上游合入）
grok/	xAI Grok Build / grok.com	.grok-plugin/plugin.json + Skills + OAuth MCP；网页端 Custom Connector	可用（本地插件/网页直连；xAI 官方 Marketplace PR 待提交）
manus/	Manus	Custom MCP Server + 根目录 Agent Skill	可用（自定义 MCP + ZIP/GitHub Skill 导入；官方收录需向 Manus 确认审核通道）
coze/	Coze / 扣子编程	资源库 MCP 插件 + 商店提交工作表 + Agent 提示词	提交材料与自动检查可用；生产 OAuth 联调阻塞，暂不宣称可安装或上架
dumate/	百度搭子 / DuMate	可导入 Agent Skill + 插件套件兼容性门禁	Skill 已适配；第三方远端 MCP 注册规范未公开，运行时阻塞

十五个宿主适配复用同一套设计，只是安装机制和指令载体不同，以匹配各自宿主的扩展模型。WorkBuddy 使用原生 .workbuddy-plugin 入口；OpenClaw 使用原生插件入口和 OpenClaw 原生 MCP OAuth；千问办公额外登记两个 MCP App runtime server name；DeepSeek Harness 通过 dsh.bundle 加载官方 MCP 客户端并注册计费安全 Skill，当前使用宿主原生工具结果与文本/链接回落；TRAE 使用官网公开的 Streamable HTTP MCP 配置和导入链接；Pi 通过可安装 package 加载 OAuth/MCP Apps 客户端适配器；Hermes 使用原生 MCP OAuth 和开放 Agent Skills 目录；Grok Build 使用 xAI 原生 Plugin、Skills、Marketplace 与远端 MCP OAuth，grok.com 则可直接添加 Custom MCP Connector；Manus 使用官网公开的 Custom MCP Server 与根目录 Agent Skill 上传/GitHub 导入流程；Coze 使用资源库中的 MCP 插件和 Agent 提示词，但在其 OAuth 表单与 Kling DCR + PKCE 完成生产联调前保持阻塞状态；DuMate 已有可导入 Skill，但公开文档尚未给出第三方插件套件的远端 MCP 与 OAuth 契约，因此同样保持运行时阻塞。

插件中心网页

website/ 是面向内部分发和后续公开部署的静态下载页：提供 Codex、Cursor、Kimi、Claude、WorkBuddy、OpenClaw、千问办公、Pi、Hermes、Grok 与 Manus 十一端版本化 ZIP、宿主安装命令、官方文档入口、双语切换和响应式布局。它只读取本仓库的宿主包，不改变共享插件逻辑；部署前通过 VITE_PACKAGE_BASE_URL 和 VITE_SOURCE_REPOSITORY_URL 配置公开地址。Coze 当前没有官方仓库级 MCP manifest且 OAuth 联调未通过；DuMate 虽支持 Skill ZIP，但第三方插件套件的远端 MCP 注册契约未公开。两者都不加入公开下载清单，避免把仅有指令的包误称为可工作的生成插件。

设计摘要（多宿主共享）

• Regional endpoints：国内使用 https://klingai.com/mcp，海外使用 https://kling.ai/mcp；Hermes 固定使用海外端点，其他支持切区的宿主一次只激活一个区域，切区前断开旧 OAuth 并重新授权。详见 区域端点契约。
• OAuth-first：普通用户网页登录可灵账号，不在聊天中粘贴 API Key。
• Live-schema-first：模型、时长、分辨率和高级参数以 MCP 实时 schema 为准。
• Single-submit：用户确认后只提交一次可能消耗 credits 的生成写操作。
• Mock-first debug：UI 和交互调试默认使用确定性 mock，不访问远端、不消耗 credits。
• Explicit live generation：只有用户明确要求真实生成并确认计费参数后，才调用远端可灵 MCP。
• Native results：唯一 kling-mcp-app 用 kling_app_open_generation 打开首个完整快照，用 kling_app_update_generation 原地更新终态；无 widget 的宿主获得同一次调用的文本结果。
• Progressive disclosure：核心操作契约保持精炼，详细工作流、示例与排错按需加载。
• Store/Marketplace-honest：不伪造商店一键 Connect 能力或品牌背书；本地 OAuth 已可用的部分才对外宣传为可用。

快速开始

让 Agent 自动帮你装（推荐）

仓库根目录有一个宿主无关的安装 Skill：.agents/skills/kling-ai-setup/SKILL.md。用任一支持的宿主打开这个仓库，直接说：

帮我把 kling-ai 装到当前环境，装完带我做一次 OAuth 授权。

Agent 会识别自己是哪个宿主，并按下面对应小节的步骤执行，装完把生成能力交给对应的 kling-ai 使用型 Skill。下面各小节是同一套步骤的人工参考版本。

Codex

cd codex
codex plugin marketplace add "$PWD"
codex plugin add kling-ai@kling-local
codex mcp login kling-ai \
  --scopes generation.create,generation.read,account.credit.read

详见 codex/README.md。

Cursor

cd cursor/kling-ai
# 在 Cursor 中打开这个文件夹作为项目，或运行:
npm run install:into -- --target=/path/to/your-project

也可以直接点击 Add to Cursor，再在 Cursor 的 Settings → Tools & Integrations → MCP 对 kling-ai 点击 Connect 完成授权； CLI 用户可运行 cursor-agent mcp login kling-ai。详见 cursor/kling-ai/README.md。

Kimi Code CLI

/plugins install /absolute/path/to/repo/kimi/kling-ai
/plugins enable kling-ai
/plugins mcp enable kling-ai kling-ai
/plugins reload
/mcp-config login kling-ai
/reload

授权和刷新使用 Kimi Code CLI 原生命令：/mcp-config login kling-ai、/mcp 和 /reload。详见 kimi/kling-ai/README.md。

注意：这里的 /plugins 是 Kimi Code CLI 里的插件管理器。Kimi 桌面 App 左侧 Work → 插件 页面是另一套产品内插件市场/已安装列表，本地安装的 Kimi Code CLI 插件不会出现在那个桌面列表里。要确认本插件是否安装，请在 Kimi Code CLI 中运行 /plugins list 或 /plugins info kling-ai。

Claude Code

claude --plugin-dir /absolute/path/to/repo/claude/kling-ai

首次使用时在 Claude Code 原生 /mcp 中选择 kling-ai 并完成可灵 OAuth；Claude Code 会自动刷新 access token，失效时在 /mcp 使用 Clear authentication 后重新授权。长期跨项目分发应接入自己的 Claude marketplace，再执行 /plugin install kling-ai@<marketplace>，插件内容变更后运行 /reload-plugins。也可使用插件内的 /kling-ai:connect 和 /kling-ai:refresh 命令获得同样的原生流程引导。

WorkBuddy

WorkBuddy 使用两个独立 Connector 包，安装前按账号区域二选一：国内版 workbuddy/workbuddy 全部用户文案为中文并固定连接 https://klingai.com/mcp；国际版 workbuddy/workbuddy.ai 全部用户文案为英文并固定连接 https://kling.ai/mcp。不要把两个包同时安装到同一会话。

cd /absolute/path/to/repo/workbuddy/workbuddy     # 国内版
npm run check && npm run pack:release

cd /absolute/path/to/repo/workbuddy/workbuddy.ai  # 国际版
npm run check && npm run pack:release

如果目标 WorkBuddy 版本的插件页或原生 MCP 连接不可用，应记录为该版本兼容性阻塞，不要退回旁路 Claude Code bridge 或把手工 MCP 配置当作安装流程。

OpenClaw

openclaw plugins install /absolute/path/to/repo/openclaw/kling-ai
openclaw plugins enable kling-ai
openclaw gateway restart
openclaw kling-ai login
openclaw dashboard

验证：openclaw plugins list --verbose、openclaw plugins inspect kling-ai --runtime --json 和 openclaw mcp doctor kling-ai --probe。插件登录命令只负责自动打开当前授权页；PKCE、回调、凭据、refresh 和 logout 仍使用 OpenClaw 原生 MCP 能力，不使用自制网页弹窗。

千问办公

cd qwenwork/kling-ai
npm run build
npm run install:runtime

随后在千问办公中将该目录作为完整专家套件安装，完整退出并重新打开应用，再新建任务。千问办公当前把普通 MCP 连接与 MCP App runtime 分开注册；install:runtime 只安装宿主要求的 server-name 描述，不复制共享 Widget，也不修改应用安装包。详见 qwenwork/kling-ai/README.md。

TRAE

打开 TRAE 的 AI 面板 → 设置 → MCP → 添加 → 手动添加 → 原始配置，粘贴 trae/kling-ai/mcp.json；TRAE CN 也可使用 store-listing.json 中的 trae-cn:// 安装链接。连接后在 Builder with MCP 中使用，或把 kling-ai 添加到自定义智能体。详见 TRAE README。

Pi

cd /absolute/path/to/repo/pi/kling-ai
npm install --omit=dev --ignore-scripts
pi install /absolute/path/to/repo/pi/kling-ai

重启 Pi 后运行 /kling-region。新安装默认使用海外 https://kling.ai/mcp；执行 /kling-region china 会切换到国内 https://klingai.com/mcp，/kling-region global 可切回，两个区域均保留 Plugin-Pi-kling-ai server key。切区前完成已接受任务的交接并执行 /mcp logout Plugin-Pi-kling-ai；切换后只会加载一个端点，需重新执行 /mcp-auth 和 /mcp reconnect。Pi 本体不内置 MCP，本包固定使用 pi-mcp-adapter 提供远端 OAuth、实时工具发现与 MCP Apps 渲染；不会携带本地 MCP server。详见 Pi README。

Hermes Agent

hermes mcp add Plugin-Hermes-kling-ai \
  --url https://kling.ai/mcp \
  --auth oauth
hermes mcp login Plugin-Hermes-kling-ai

把 mcp.config.yaml 中的 integration header 与并发策略合并到当前 Hermes profile，并把 skills/kling-ai 复制到 $HERMES_HOME/skills/creative/ 或登记到 skills.external_dirs。官方 Catalog + optional-skills 上游提交材料已放在 hermes/kling-ai/submission/hermes-agent/；详见 Hermes README。

Grok

Grok Build 使用原生插件目录：

grok plugin validate grok/kling-ai
grok plugin install "$PWD/grok/kling-ai" --trust
grok plugin enable kling-ai
grok mcp doctor Plugin-Grok-kling-ai

随后在 Grok TUI 的 /mcps 中选择 Plugin-Grok-kling-ai，按 i 完成浏览器 OAuth。Grok Marketplace 包默认使用海外 https://kling.ai/mcp；国内私有分发改用未激活的 .mcp.china.json 模板，不得同时注册两个区域。grok.com 网页端无需安装插件：打开 Connectors，选择 New Connector → Custom，海外账号输入 https://kling.ai/mcp，国内账号输入 https://klingai.com/mcp。网页端只获得 MCP 工具，不会加载 Grok Build 包内的 Skills。详见 Grok README。

Manus

在 Manus 打开 Settings → Integrations → Custom MCP Servers → Add Server，名称填写 Plugin-Manus-kling-ai；国内账号 URL 填写 https://klingai.com/mcp，海外账号填写 https://kling.ai/mcp，二选一，测试连接并完成宿主提供的浏览器 OAuth。随后打开 Skills → + Add → Upload a skill，上传 kling-ai-manus-<version>-public.zip；也可以把 manus/kling-ai 单独发布为以 SKILL.md 为仓库根文件的公开仓库，再使用 Import from GitHub。不要同时连接两个区域，也不要把整个多宿主仓库根目录作为 Skill 导入。

Coze / 扣子编程

Coze 已公开支持在 资源库 → + 资源 → 插件 中选择 MCP，填写 HTTPS MCP URL，并自动同步远端工具。为 Kling 创建插件时使用名称 Plugin-Coze-kling-ai，国内账号选择 https://klingai.com/mcp，海外账号选择 https://kling.ai/mcp，只保留一个区域。

当前不要继续到生产发布：Coze 文档中的用户 OAuth 表单需要静态客户端配置，而 Kling MCP 当前使用 protected-resource discovery、动态客户端注册和 PKCE。必须先完成 Coze OAuth 兼容性门禁，再试运行、发布并把 agent-prompt.md 合并到智能体提示词；不得用“不需要授权”、共享 token 或第二个 MCP server 绕过。

国内商店提交字段、示例提示词和复用图标已整理在 store-listing.json，UI 创建、试运行、版本发布和插件市场上架步骤见 CREATE_AND_PUBLISH.md。先运行 npm run verify:live --prefix coze/kling-ai 检查远端契约；只有目标扣子版本的非敏感证据补齐并让 npm run verify:release --prefix coze/kling-ai 通过后才能提交审核。

百度搭子 / DuMate

DuMate 已公开支持在 技能 → 安装技能 中通过 URL 或 .zip / .md 导入 Skill。 dumate/kling-ai 已提供以 SKILL.md 为根文件的适配，保留 生成前确认、单次提交、任务标识和结果回落契约。

安装 Skill 不会自动注册远端 MCP。DuMate 虽在更新动态中宣布“插件套件”，但公开文档 尚未给出第三方套件 manifest、远程 MCP 注册或 OAuth 客户端格式。必须先完成 DuMate MCP / 插件套件兼容性门禁，证明 Plugin-DuMate-kling-ai 能在单一区域完成 OAuth 和实时工具发现，才能宣称真实生成可用； 不得用 API key、共享 token、本地代理或虚构 mcp.json 绕过。

目录

codex/     Kling AI for Codex：可发布插件、本地 marketplace、报告
cursor/    Kling AI for Cursor：MCP 配置、Rule、Agent Skill
kimi/      Kling AI for Kimi Code CLI：Plugin manifest、Skill、Commands
claude/    Kling AI for Claude Code：原生 Claude plugin bundle
workbuddy/ Kling AI for WorkBuddy：中文国内包与 English Global package
openclaw/  Kling AI for OpenClaw：原生 OpenClaw 插件
qwenwork/  Kling AI for 千问办公：专家套件与 MCP App runtime 登记
deepseek/  Kling AI for DeepSeek Harness：dsh.bundle、远端 MCP OAuth 与 Agent Skill
trae/      Kling AI for TRAE：HTTP MCP 配置、导入链接、项目 Rule 与上架材料
pi/        Kling AI for Pi：Pi package、OAuth/MCP Apps 客户端适配器与 Agent Skills
hermes/    Kling AI for Hermes Agent：原生 MCP OAuth 配置与 Agent Skills
grok/      Kling AI for Grok Build：原生 Plugin、Agent Skills 与 OAuth MCP
manus/     Kling AI for Manus：Custom MCP Server 与可上传/导入的 Agent Skill
coze/      Kling AI for Coze：资源库 MCP 插件说明、Agent 提示词与 OAuth 联调门禁
dumate/    Kling AI for 百度搭子：可导入 Skill 与远端 MCP / 插件套件兼容性门禁
.agents/   宿主无关安装 Skill：让 Agent 自动选择安装路径

每个子项目自带完整 README、架构文档、脚本和测试，可独立阅读、独立验证。新增宿主时，在仓库根目录新增同级子文件夹（例如 claude/），复用同一套确认、单次提交和结果归一化约定，只调整指令载体和安装方式。

发布准备

Codex、Cursor 与 Kimi 的本地/内部分发路径已经拆开记录，公共商店或 Marketplace 上线前必须按门禁补齐证据，不用占位配置冒充上线能力：

• 多宿主发布准备总表
• 国内/海外 MCP 区域端点契约
• Codex 商店发布清单
• Cursor 发布清单
• Kimi 发布清单
• Claude Code 发布清单
• WorkBuddy 国内版发布清单
• WorkBuddy Global release checklist
• OpenClaw 发布清单
• 千问办公发布清单
• TRAE 发布清单
• Pi 发布清单
• Hermes Agent 发布清单
• Grok Build 与 xAI 官方 Marketplace 发布清单
• Manus 发布与官方收录清单
• Coze 发布与 OAuth 联调清单
• 百度搭子 DuMate 发布与 MCP 兼容性清单

官方参考

• MCP Apps 官方概览
• MCP Apps 官方构建指南
• MCP Apps 官方 ext-apps SDK
• MCP Apps 官方 Quickstart
• OpenAI：Build plugins
• OpenAI：Build skills
• Cursor MCP 文档
• Kimi Code Plugins 文档
• Kimi Code MCP 文档
• Claude Code Plugins 文档
• OpenClaw Plugins 文档
• OpenClaw Plugin Manifest 文档
• OpenClaw MCP/OAuth 文档
• WorkBuddy 文档
• Qwen Code MCP 文档
• TRAE MCP 官方 FAQ
• TRAE MCP Server 安装链接
• Pi Packages 文档
• Pi Skills 文档
• Hermes Agent MCP 文档
• Hermes Agent Skills 文档
• Grok Build Plugins 与 Marketplaces 文档
• Grok Build MCP Servers 文档
• Grok Connectors 文档
• xAI 官方 Plugin Marketplace
• xAI 官方 Marketplace 贡献指南
• Manus Custom MCP Servers 文档
• Manus MCP Connectors 文档
• Manus Skills 文档
• Manus Skill 分享与导入帮助
• Coze：基于 MCP 服务创建插件
• Coze：插件介绍
• DuMate：技能管理
• DuMate：更新动态
• Kling AI VIDEO 3.0 Model User Guide

License

MIT。可灵、Kling AI 及相关标识归各自权利人所有。