将你的工具连接到 Codewhale

连接 MCP 服务器来添加工具，加载技能来复用指令，或安装将两者打包的插件。由你决定运行哪些集成。

浏览 Codewhale 目录插件编写指南

插件、技能，还是 MCP 服务器？

根据你想添加的能力选择。

技能

可复用的 Markdown 任务指令。使用已有工具，不会自行创建服务连接。

MCP 服务器

提供工具、资源或提示词的外部程序或服务。配置命令或 URL 以及认证方式。

插件

将技能、命令、代理配置、钩子、MCP 服务器或模型提供商声明打包。安装、审阅、信任后再启用。

Computer Use

智能体在 Mac 应用中后台操作，你可以继续使用电脑。将 Computer Use 助手和插件连接到 Codewhale 或其他兼容 MCP 的宿主。

已发布的 CLI v0.10.2 内置较旧的 Computer Use 插件。安装目录条目不会升级内置副本。连接当前 Mac 助手前，请按对应版本的指南设置。

市场插件适用于 Mac。GitHub 发布页另有未签名的 Windows 实验性预览包；Linux 仍需实验性源码或 Docker 设置。其他平台不提供 Mac 式后台输入。

Computer Use
后台工作
在 macOS 上，智能体可在选定应用中输入、点击和滚动，无需移动你的指针或抢占焦点。部分应用和对话框需要前台操作。
读取应用控件
无障碍控件提供按钮、输入框及其当前值，让纯文本模型也能操作支持的应用。任务需要时，仍可使用截图。

浏览 Codewhale 插件

以下是公开 Codewhale 目录中的部分示例。终端内置离线快照，条目及固定版本取决于 CLI 版本；浏览目录不会运行任何内容。

/plugin marketplace list

目录来源：github.com/codewhale-hq/codewhale-plugin-marketplace。名为 codewhale 的本地目录优先于内置快照。

直接连接 MCP 服务器

通过 stdio 使用本地工具，或通过 Streamable HTTP 连接远程服务。直接连接的远程服务器可使用 OAuth 或环境变量令牌，无需安装插件。

codewhale mcp add cloudflare-docs --url "https://docs.mcp.cloudflare.com/mcp"
codewhale mcp tools cloudflare-docs
MCP 设置、认证与故障排查

支持哪些插件格式？

兼容性取决于插件包含的能力。能识别清单，并不代表其他宿主的每项功能都能运行。

Codewhale / Agent Plugins v1
支持声明式技能、命令、代理配置、钩子、MCP 及模型提供商声明。原生 TypeScript 扩展为实验功能，需启用 extension_host；声明 LSP 或文件系统根目录不会启用对应能力。
Claude Code 与 Kimi 插件包
可导入兼容的技能、命令、代理配置及 MCP 声明。Claude 钩子、LSP、自定义 MCP 路径及插件根路径展开会被拒绝。请审阅导入的能力。
DeepSeek Harness（DSH）
导入兼容工作进行中。已发布插件的完整工作流及交互视图尚未通过发布验证，请勿假定 DSH 包可直接运行。
MCP 认证与界面
插件内的 MCP 不支持 OAuth，请改为直接配置服务器。MCP Apps 界面及所有可选协议功能并非普遍受支持。

从来源安装插件包

/plugin install 可以指向目录、GitHub 仓库、压缩包或指定版本的 npm 包。获取的目录树必须恰好包含一个 bundle 根：plugin.json、兼容的 kimi.plugin.json 或 .claude-plugin/plugin.json，或旧版 plugin.toml。

  • GitHub 仓库获取仓库归档。固定提交可实现可重复安装。/plugin install github:owner/repo
  • 本地目录从磁盘复制。编写自己的 bundle 时最快的迭代方式。/plugin install ./path/to/bundle
  • 压缩包 URL在按域网络策略下直接下载归档。未知主机会被拒绝，直到你允许它。/plugin install https://example.com/x.tar.gz
  • 固定版本的 npm 包获取指定版本的压缩包，不运行生命周期脚本或安装依赖。包中须包含受支持的原生插件清单。/plugin install npm:@example/plugin@1.0.0

审阅并启用插件

每个 bundle 安装后均为未启用、未信任状态。审阅清单与声明的能力后，再信任并启用。内容有变更的更新需要重新审阅。

  1. 审阅

    /plugin trust <name> 显示能力审阅内容，并打印确认命令。

  2. 信任

    审阅后，复制并运行打印出的完整确认命令，保留两个完整哈希。目录来源本身不授予权限。

  3. 启用

    /plugin enable <name> 激活 bundle。插件提供的 MCP 服务器使用带命名空间的身份，受已审阅的插件权限约束。

下载仅限压缩包，有大小限制且不允许符号链接；路径穿越、模糊根目录与插件身份变更都会被拒绝。/plugin suggest 仅对已安装与目录中的 bundle 按任务排序，不会安装任何内容。

分享你的集成

将实用工作流打包，说明依赖并提供验证结果。编写指南介绍本地插件包；新增目录条目或改进现有条目，请前往目录仓库。

插件编写指南参与目录贡献

命令参考

在终端中完成整个生命周期：

插件编写指南
/plugin marketplace list
/plugin marketplace show codewhale
/plugin marketplace install codewhale <name>
/plugin install github:owner/repo
/plugin show <name>
/plugin trust <name>
/plugin trust <name> <full-content-sha256>.<full-capability-sha256>
/plugin enable <name>
/plugin update <name>
/plugin suggest <task>