zapier-workflows

Zapier 工作流技能

解决的问题

Zapier MCP 让 Claude 可以使用 8,000 多个独立工具（即 Zapier 的每个操作），但存在一些关键限制：

❌ 没有记忆——Claude 不记得你使用哪些工具，也不知道原因 ❌ 没有上下文——不知道在你的工作流中何时该使用特定工具 ❌ 只能执行一次性操作——无法触发复杂的多步骤 Zap ❌ 每次会话都从头开始——对话之间的上下文会全部丢失

两种 Zapier 自动化

1. MCP 工具（一次性操作）

• 独立的 Zapier 操作（添加行到表格、发送邮件等）
• 可通过 Zapier MCP 使用：https://mcp.zapier.com/mcp/servers
• 适合灵活、即时的自动化
• **问题：**有 8,000 多种选择，却没有关于该用哪个或何时使用的指导

2. 多步骤 Zap（由 Webhook 触发）

• 你在 Zapier 控制面板中创建的复杂工作流
• 多个操作串联在一起，并经过预先优化
• 通过 Webhook URL 触发（POST 请求）
• **问题：**Claude 无法触发这些工作流，因为它们不在 MCP 中

此技能的作用

此技能通过为 Claude 提供关于 Zapier 工作流的持久记忆，解决上述两个问题：

✅ 记住你对 MCP 工具的偏好——“费用用 Google Sheets 管理，任务用 Notion 管理” ✅ 知道何时以及为何使用每个工具——“研究时用 Perplexity 搜索，不要用 Google” ✅ 触发多步骤 Zap——“运行我的每日摘要”＝向你的复杂 Zap 发送 Webhook POST 请求 ✅ 自我学习——Claude 会根据你的指导更新技能，永不遗忘 ✅ 跨会话持久保存——适用于所有对话（全局安装）

你将获得

针对多步骤 Zap：

• 保存 Webhook URL 及其功能
• 只需提出请求即可触发复杂工作流
• 记住何时以及为何使用每个 Zap
• 记录成本、时间安排和输出

针对 MCP 工具：

• 记录不同任务中你偏好的工具
• 构建可复用的工作流模式
• 保存特定工具的偏好（表格名称、格式等）
• 创建多工具编排序列

自我学习：

• 你指导 Claude 时，它会自动更新技能文件
• 更改会永久保存（全局安装）或按项目保存（本地安装）
• 无需手动编辑，只需与 Claude 对话

安装与设置

安装位置

全局（~/.claude/skills/）——推荐：

• 学到的模式会在所有项目中保留
• 一个 Zap 库即可用于所有用途
• 偏好设置会延续到所有项目

项目级（./.claude/skills/）：

• 学到的模式仅在此项目中生效
• 与其他项目隔离
• 适用于特定项目的工作流

⚠️ 安全警告

**重要：**此技能会以纯文本文件的形式保存 Webhook URL 和工作流详情。

**Webhook URL 包含身份验证令牌。**如果有人获得你的 Webhook URL，就能触发你的 Zap。

最佳实践：

• ✅ 全局安装到 ~/.claude/skills/（不要安装在项目仓库中）
• ✅ 如果安装在项目中，请将 .claude/ 添加到你的 .gitignore
• ✅ 切勿将包含真实 Webhook URL 的技能文件提交到公开仓库
• ✅ 如果 Webhook URL 意外泄露，请重新生成
• ✅ 在可用时使用 Zapier 的 Webhook 身份验证功能

如果需要分享此技能：

• 先移除真实的 Webhook URL
• 替换为占位符示例
• 或使用单独的 Webhook URL 进行分享和测试

前提条件

必需：

• Claude Code
• Zapier 账户（用于 Webhook 和 MCP 工具）

可选：

• 根据你的工作流使用的其他 MCP 工具（Perplexity Search、Google Sheets 等）

设置 Zapier MCP

要将 Zapier 的 MCP 工具连接到 Claude Code：

1. 前往 Zapier MCP 服务：

   • 访问 https://mcp.zapier.com/mcp/servers
   • 如果系统提示，请登录你的 Zapier 账户

2. 创建新的 MCP 服务：

   • 点击“New MCP Server”按钮（左上角）
   • 在“MCP Client (required)”下拉菜单中，选择 Claude Code
   • 为你的服务命名（例如，“My Zapier Tools”）

3. 添加工具：

   • 点击“Add tools”按钮
   • 选择任意数量的 Zapier 操作（每个操作都会成为一个 MCP 工具）
   • 常用工具：运行 Zap、向 Google Sheets 添加行、发送电子邮件等

4. 连接到 Claude Code：

   • 点击“Connect”按钮
   • 你会看到类似这样的命令：

   claude mcp add zapier https://mcp.zapier.com/api/mcp/mcp -t http -H "Authorization: Bearer ZjFmZGJkN..................1NjBhYzc2MDRlYg=="
   

   • 复制此命令并在终端中运行

5. 重启 Claude Code：

   • 关闭并重新打开 Claude Code
   • 现在即可使用你的 Zapier MCP 工具

提示： 之后可以在 Zapier 中编辑 MCP 服务以添加更多工具，然后再次运行连接命令。

创建由 Webhook 触发的 Zap

对于预先构建且经过优化、需要按需触发的工作流：

1. 在 Zapier 控制面板中：

   • 创建一个新的 Zap
   • 选择“Webhooks by Zapier”作为触发器
   • 选择“Catch Hook”
   • 复制提供的 webhook URL

2. 构建工作流：

   • 添加所需的操作（API 调用、数据处理等）
   • 测试并优化 Zap

3. 在此技能中记录：

   • 告诉 Claude 新 Zap 的信息（webhook URL、功能、触发短语）
   • Claude 会自动将其添加到 references/zaps.md
   • 现在只需向 Claude 提出请求即可触发它！

Webhook 与 MCP 工具：

• Webhook： 通过 POST 请求触发的预构建多步骤 Zap。适用于复杂且经过优化的工作流。
• MCP 工具： 直接调用的独立 Zapier 操作。适用于灵活、即时的自动化。

自我改进协议

重要：此技能可以且应该自行编辑，以吸收用户反馈。

当用户教你新内容或纠正你的做法时：

1. 确定要更新的内容：

   • 需要记录新的 Zap → 编辑 references/zaps.md
   • MCP 工具偏好 → 编辑 references/mcp-patterns.md
   • 新的工作流模式 → 编辑 references/mcp-patterns.md

2. 使用 Claude Code 工具进行编辑：

   • 先使用 Read 工具读取文件
   • 使用 Edit 工具更新（指定准确的 old_string 和 new_string）
   • 向用户确认更改

3. 更新格式：

   User: "Use Apollo instead of Clearbit for company data"
   Claude: [uses Read tool on references/mcp-patterns.md]
           [uses Edit tool to update the preference]
           "Updated! I'll use Apollo for company enrichment from now on.
            This change is now permanent in the skill."
   

技能更新时需要记录的内容：

• ✅ 工具偏好（针对不同任务使用哪些工具）
• ✅ 工作流顺序（分步模式）
• ✅ 错误处理方法
• ✅ 数据格式要求
• ✅ 新 Zap 及其详情
• ❌ 一次性请求（不要让技能内容变得臃肿）
• ❌ 临时上下文（改用记忆）

决策逻辑

何时使用由 Webhook 触发的 Zap

以下情况使用 webhook：

• 任务复杂、包含多个步骤且已完善
• 用户提到特定 Zap 名称（检查 references/zaps.md）
• 确定性执行至关重要
• 任务涉及 5 次以上 API 调用或复杂编排
• 需要提高成本或时间效率（预构建的 Zap 已经过优化）

何时使用 MCP 工具编排

以下情况使用 MCP 工具：

• 任务简单（1–3 个操作）
• 需要灵活性（参数会变化）
• 正在测试新的工作流模式
• 用户明确要求使用特定的 MCP 工具

执行模式

1. 监听触发词： 工作流名称、“运行”、“触发”、“搜索”、“研究”等。
2. 查看参考资料： 使用 Read 工具查阅相应的参考文件以获取详情
3. 检查前置条件：
   • 如果需要 MCP 工具但不可用： 提供 Zapier MCP 设置说明（见下文）
   • 如果 MCP 工具可用但尚未记录： 触发工具发现协议（见下文）
   • 如果需要 webhook URL 但参考资料中没有： 提供提取 webhook 的说明（见下文）
4. 执行：
   • 对于由 webhook 触发的 Zap： 使用 Bash 工具，通过 curl 向 webhook URL 发送 POST 请求（webhook 是在 Zapier 控制面板中通过“Catch Hook”触发器创建的）
   • 对于 MCP 工具工作流： 直接调用相应的 Zapier MCP 工具（通过 https://mcp.zapier.com/mcp/servers 配置）
5. 确认： 用自然语言告知用户已完成的操作
6. 学习： 如果用户纠正了你，使用 Edit 工具更新技能文件
7. 建议保存模式： 成功使用工具后，提议保存该模式（见下文）

主动发现并学习模式

重要： 在成功使用 MCP 工具或工作流帮助用户后，主动建议保存有价值的模式。

何时建议保存模式

使用 MCP 工具完成任务后，检查这是否是值得保存的模式：

留意：

• 效果良好的多步工具调用序列
• 用户喜欢的特定参数组合
• 重复出现的工作流或用例
• 用户在任务过程中表达的工具偏好
• 成功解决用户问题的方法

在以下情况下建议保存：

• 连续使用了 2 个或更多 MCP 工具
• 用户对结果表示满意
• 这似乎是用户可能会重复使用的模式
• 用户在交互过程中提出了具体偏好

如何建议保存模式

成功完成任务后：

"That worked well! I noticed I [describe what you did, e.g., 'used Perplexity to research, then saved results to Google Sheets'].

Would you like me to save this as a pattern? If you tell me:
- What trigger words to listen for
- When/why to use this workflow
- Any preferences or variations

I'll remember it and do this automatically next time!"

记录模式

如果用户同意：

1. 使用 Read 工具查阅 references/mcp-patterns.md
2. 使用 Edit 工具添加新模式，包含：
   • 模式名称
   • 触发短语
   • 何时／为何使用
   • 分步工作流
   • 参数／偏好
   • 示例
3. 确认：“已保存！下次你 [触发词] 时，我会 [工作流]。”

值得保存的模式示例：

• “研究并记录”（Perplexity → 总结 → Google Sheets）
• “费用跟踪”（提取金额／描述 → 格式化 → 添加到表格）
• “竞争分析”（搜索竞争对手 → 分析 → 保存洞察）
• “每日简报”（多次搜索 → 综合整理 → 提交简报）

不要保存：

• 一次性请求
• 高度具体／独特的情况
• 简单的单工具调用（除非用户提出要求）

设置检测与说明

未检测到 Zapier MCP 时

当用户请求 MCP 工具功能，但未连接 Zapier MCP 时，告知他们：

"I don't see the Zapier MCP tools connected. Here's how to set them up:

1. Go to https://mcp.zapier.com/mcp/servers
2. Login to your Zapier account
3. Click 'New MCP Server' (top left)
4. Select 'Claude Code' in the MCP Client dropdown
5. Give it a name (e.g., 'My Zapier Tools')
6. Click 'Add tools' and select the Zapier actions you want
7. Click 'Connect' and copy the command shown
8. Run that command in your terminal (it looks like):
   claude mcp add zapier https://mcp.zapier.com/api/mcp/mcp -t http -H "Authorization: Bearer [your-token]"
9. Restart Claude Code

Once setup, I'll be able to use those Zapier actions directly!"

已连接 Zapier MCP 时——工具发现与文档记录

重要： 连接 Zapier MCP 后（可使用以 mcp__zapier__ 开头的工具），主动帮助用户为这些工具补充详尽的背景说明：

1. 列出可用工具：

   • 检查有哪些 Zapier MCP 工具可用
   • 向用户列出这些工具

2. 提示用户补充详细说明：

   "I see you have these Zapier MCP tools available:
   - mcp__zapier__google_sheets_create_spreadsheet_row
   - mcp__zapier__perplexity_chat_completion
   - [etc.]
   
   To help me use these effectively, I need to understand:
   
   For each tool you want me to use, please tell me:
   
   1. WHEN should I use this tool?
      - What trigger words or phrases?
      - What situations or contexts?
      - What types of requests?
   
   2. WHY should I use this tool vs alternatives?
      - What's it best for?
      - When should I NOT use it?
   
   3. HOW should I use it?
      - Any specific parameters or preferences?
      - Default values I should use?
      - Sheet names, formats, or other specifics?
   
   4. Any PATTERNS or workflows involving this tool?
      - Multi-step sequences?
      - Common combinations with other tools?
   
   Take your time - the more detail you give me, the better I can serve you!"
   

3. 在技能中记录：

   • 使用 Read 工具查阅 references/mcp-patterns.md
   • 使用 Edit 工具添加全面的文档说明，包含：
     • 工具名称和用途
     • 触发短语（何时使用）
     • 用例（为何使用）
     • 参数和偏好（如何使用）
     • 用户提及的工作流模式
   • 向用户确认已记录的内容

触发时机：

• MCP 设置完成后，用户首次提及 Zapier 或工作流
• 用户明确询问“我有哪些工具？”或“你能用 Zapier 做什么？”
• 检测到 references/mcp-patterns.md 中尚未记录的新 Zapier MCP 工具

用户想要添加由 Webhook 触发的 Zap 时

当用户提到要创建或添加用于触发 webhook 的多步 Zap 时，提供以下说明：

"To get your webhook URL from an existing Zap:

1. Go to your Zap in the Zapier dashboard
2. Make sure the trigger is a 'Webhooks by Zapier' node
3. In the 'Trigger Event' dropdown, select 'Catch Hook'
4. Go to the 'Test' tab
5. Copy the 'Webhook URL' shown
6. Give me that URL and tell me:
   - What the Zap does (step-by-step)
   - What trigger phrases you want to use
   - Any other details (timing, cost, etc.)

I'll add it to my knowledge so you can trigger it anytime just by asking!"

快速参考

• **所有 Zap：**参见 references/zaps.md
• **MCP 模式：**参见 references/mcp-patterns.md
• **常见工作流：**两个文件都包含示例

使用示例

触发 Zap：

User: "Run my daily digest"
Claude: [uses Read tool on references/zaps.md for webhook details]
        [uses Bash tool to trigger webhook with curl POST]
        "Started your Daily AI Digest. You'll get the report via email
         in ~3 minutes, with SMS alerts for any high-priority items."

使用 MCP 编排：

User: "Research the latest on quantum computing"
Claude: [uses Read tool on references/mcp-patterns.md]
        [calls Perplexity Search MCP tool]
        [analyzes results, identifies gaps]
        [calls Perplexity Search again for deeper dive]
        "Here's what I found... [summary]"

学习和更新：

User: "No, when tracking expenses use my 'Personal Budget' sheet, not 'Expenses'"
Claude: [uses Read tool on references/mcp-patterns.md]
        [uses Edit tool to update the Google Sheets section]
        "Got it - updated the skill. I'll use 'Personal Budget' sheet
         for expense tracking from now on."

常见问题与故障排除

“Claude 无法检测到我的 Zapier MCP 工具”

检查 MCP 是否已连接：

• 在可用工具中查找以 mcp__zapier__ 开头的工具
• 尝试询问：“我有哪些 Zapier 工具？”

如果没有显示：

1. 确认你已运行 https://mcp.zapier.com/mcp/servers 中的连接命令
2. 完全重启 Claude Code（而不只是重新加载）
3. 检查 Claude Code 的 MCP 设置
4. 确认命令中的授权令牌正确无误

“Claude 没有建议保存模式”

以下情况会触发模式检测：

• 你连续使用了 2 个或更多 MCP 工具
• 任务成功完成
• 任务看起来可以重复执行（而非一次性请求）

尝试直接询问：

• “你能把这个保存为模式吗？”
• “记住这个工作流，下次用”

“Webhook URL 没有触发我的 Zap”

常见问题：

1. URL 错误——确保已从 Test 选项卡复制完整 URL
2. Zap 未启用——在 Zapier 控制面板中启用 Zap
3. 触发器节点不正确——必须是“Webhooks by Zapier” → “Catch Hook”
4. 防火墙/网络——先检查终端中的 curl 命令能否正常运行

手动测试：

curl -X POST https://hooks.zapier.com/hooks/catch/[your-url]

“Claude 一直让我记录已经记录过的工具”

可能原因：

• 工具已记录，但文件未正确保存
• 使用了不同的 Claude Code 实例/安装
• 技能安装在项目级别，而非全局级别

解决方法：

1. 检查 references/mcp-patterns.md 是否包含你的工具
2. 确认技能位置：~/.claude/skills/（全局）与 ./.claude/skills/（项目）
3. 如果安装在项目级别，请复制到全局位置，以便在不同项目间保留

“如何确认技能正在运行？”

运行正常的迹象：

1. 当你提到 Zapier/工作流时，Claude 会提到检查参考文件
2. Claude 会针对工具询问详细问题（何时/为什么/如何）
3. 使用工具后，Claude 会建议保存模式
4. Claude 能成功触发你的 webhook

快速测试：

1. 询问：“我有哪些 Zapier 工具？”
2. 添加一个虚构的 webhook，并告诉 Claude
3. 检查它是否已添加到 references/zaps.md

“技能文件变得太大/加载太慢”

如果参考文件变得太大：

• 检查并移除过时/未使用的模式
• 合并相似的工作流
• 仅记录当前正在使用的工具
• 考虑针对不同领域拆分为多个技能实例

性能建议：

• 触发短语应简洁且明确
• 避免记录一次性工作流
• 使用模式类别进行组织

“我想将技能重置为模板状态”

重新开始：

1. 备份当前技能文件（如果有需要保留的内容）
2. 删除技能目录
3. 从 GitHub 重新克隆：https://github.com/AlexBoudreaux/claude-zapier-skill
4. 将全新的模板复制到 ~/.claude/skills/

“不使用 Zapier MCP 也能使用此技能吗？”

**可以！**此技能支持：

• 仅使用 webhook——无需 MCP 即可触发多步骤 Zap
• 仅使用 MCP 工具——记录工具用法，无需 webhook
• 两者兼用——获得完整功能

每种模式都可独立使用，且各有价值。

“安全：我不小心提交了 webhook URL”

立即采取以下措施：

1. 从 git 历史记录中移除该提交（使用 git rebase、BFG Repo-Cleaner）
2. 在 Zapier 控制面板中重新生成 webhook URL：
   • 编辑 Zap
   • 删除并重新添加 webhook 触发器节点
   • 获取新的 webhook URL
3. 使用新 URL 更新技能文件
4. 将 .claude/ 添加到 .gitignore

预防措施：

• 全局安装技能（~/.claude/skills/）
• 切勿在项目中提交 .claude/ 目录
• 在共享示例中使用占位 URL

重要说明

• Webhook 不需要负载——Zap 会从 Zapier Tables 获取数据
• 执行前始终阅读参考文件——其中包含关键细节
• 学到新内容时更新技能文件——不要只在本次对话中记住

使用的 Claude Code 工具

此技能使用以下 Claude Code 工具：

• Read——查看参考文件（zaps.md、mcp-patterns.md）
• Edit——使用新的工作流、模式或偏好更新技能文件
• Bash——使用 curl POST 请求触发 Zapier webhook
• MCP Tools——调用 Perplexity Search、Google Sheets 和其他集成