前言¶
DeepSeek Harness（DSH）里若要把外部 MCP 接进智能体会话，常见做法是改配置文件、重启进程，并把访问令牌写进 YAML。Zapier 提供托管 MCP 服务（mcp.zapier.com），背后是你已在 Zapier 里连好的各类应用，但把该端点挂到 Harness 上仍需要处理连接与密钥存放。
dsh-zapier-mcp（维护者 parolkar）是 DSH 社区目录中的「联网工具」类插件，目标是在不改配置文件的前提下，用 Web UI 粘贴 Zapier MCP 令牌、即时校验连接，并把 Zapier 侧工具注册为会话内可调用的 agent 工具。下文按安装、配置与日常使用说明可核对的操作步骤。
这是什么¶
该插件是面向 DeepSeek Harness 的 bundle：连接 Zapier 托管 MCP 端点 https://mcp.zapier.com/api/v1/connect，在 Harness 设置里增加 Zapier MCP 页面，令牌存入 profile 的 credential store（配置里只保留 credentialRef 引用名，不写明文密钥）。连接成功后，模型侧可见形如 mcp__zapier__<tool> 的工具；插件还会在系统提示中说明 Zapier meta-tool 的用法，减少「应用未启用就被模型判为不可用」的情况。
- 许可证：MIT
- 当前包版本（
package.json）：0.1.2 - 兼容声明：DSH
>=0.2.0 <0.3.0，README 写明在 0.2.1-rc.2 上构建与测试 - 运行时：Node.js ≥ 22.19，无构建步骤（纯 ESM）
核心功能¶
下面列出的能力均来自项目 README 与 package.json 描述。
- 托管 Zapier MCP — 使用令牌连接 Zapier 官方端点，无需本地 MCP 进程或桥接服务。
- Settings → Zapier MCP — 页面位于 Models 下方，用于粘贴令牌、保存并校验、重新检查、删除令牌；高级选项可覆盖 MCP endpoint（自托管或本地测试服务器）。
- 保存即重连 — 成功时页面显示
Connected — N tools available及工具名列表（最多展示前 25 个）；失败时显示Token rejected及服务端消息。 - 全会话挂载 — 通过
cordis.patch.yml在 harness 根挂载一行配置，工具在每个会话与 agent（含 DS Bot）中可用。 - 系统提示增强 — 连接后向模型说明 Zapier 返回的 meta-tool 列表是「脚手架」，并映射到实际可调用的
mcp__<serverName>__*名称及当前已启用应用。 - 依赖 pin — 使用
@deepseek-ai/dsh-mcp-client0.2.1-rc.2 做 MCP 连接与工具注册；Harness 升级时需与此依赖版本对齐（README Compatibility 节）。
环境与前置条件¶
| 项目 | 要求 |
|---|---|
| DeepSeek Harness | 0.2.x（文档示例为 0.2.1-rc.2） |
| Node.js | ≥ 22.19 |
| Zapier | 具备托管 MCP server，在 mcp.zapier.com 创建或管理 |
还需在 Zapier 侧选好希望模型快速调用的 action；未列入工具列表的 action 仍可能通过 Zapier meta-tool 发现与启用（插件文档 How Zapier MCP actually works 有说明）。
安装与启用¶
安装通过 DSH 的 dsh plugin 命令完成：剩余参数原样转发给 profile 目录下的 pnpm（如 add、remove、why）。官方推荐从 GitHub 安装，以便依赖随包一并解析：
dsh plugin --profile web add https://github.com/parolkar/dsh-zapier-mcp
将 web 换成你实际使用的 profile 名；dsh plugin --help 与 dsh --help 可查看命令形式。
安装完成后还需两步（README Enable the bundle, then reload）：
- 在 Harness Plugins UI 中启用已安装的 bundle，以应用
cordis.patch.yml中的zapier-mcp行。 - 刷新浏览器标签页，否则已打开的页面可能不会注册新的 Settings → Zapier MCP 入口。
本地开发若用目录链接，需先在 checkout 中 pnpm install，或使用 file: 规格安装；README 对本地路径与依赖解析有单独说明。本文不展开 clone 流程。
配置 Zapier MCP 令牌¶
- 打开 mcp.zapier.com，创建 server 或进入已有 server，选择要暴露的工具（Zapier actions）。
- 复制 connect URL，形态类似：
https://mcp.zapier.com/api/v1/connect?token=<USER_ZAPIER_MCP_TOKEN>
- 在 Harness 打开 Settings → Zapier MCP，在令牌字段粘贴 仅
token查询参数的值（不是整段 URL），点击 Save & verify。
保存后令牌写入 profile credential store，并立即尝试连接。设置页不会把令牌值回显给前端，只反映是否已配置。
典型用法¶
设置页操作¶
- Save & verify：存凭证并重连。
- Re-check：在不改令牌的情况下强制重连并刷新工具列表（在 Zapier 里增减 action 后应手动 Re-check；Harness 不会轮询 Zapier）。
- Remove token：二次确认后删除凭证并断开。
- Advanced → MCP endpoint override：留空则使用默认
https://mcp.zapier.com/api/v1/connect；可改为其他 MCP 端点。
会话中调用工具¶
连接成功后，Zapier 桥接过来的工具对模型呈现为：
mcp__zapier__<tool>
其中 zapier 为默认 namespace，可通过 serverName 配置修改。因挂载在 harness 根，这些工具对所有会话与 agent 可见。
适用场景与注意¶
适合谁： 已在 Zapier 里串联邮件、表格、CRM 等自动化，希望 DSH 智能体通过 MCP 直接触发已授权 action，且希望令牌只出现在 credential store、通过 UI 校验连接状态的开发者。
权限与安全： 插件以当前 DSH 进程权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，确认令牌范围与 Zapier 侧启用的工具符合你的环境策略。无效令牌时服务端可能返回例如 Invalid OAuth token - please re-authenticate 一类消息，页面会一并展示。
生态说明： DSH 社区插件目录（如 SkillHub 上的条目）由社区维护，与 DeepSeek / 幻方无官方从属关系；「一切皆插件」是 Harness 的产品思路，本文仅介绍该 bundle 的接入方式。
结尾¶
dsh-zapier-mcp 把 Zapier 托管 MCP 收成「一行 profile 配置 + 设置页存令牌 + 保存即验证」，避免在 YAML 里留密钥，并把 Zapier 工具稳定暴露为 mcp__zapier__* agent 工具。需要进一步了解 meta-tool 行为、endpoint 覆盖或兼容性 pin，请以仓库 README 为准。
