Zapier MCP

通过 Zapier 的 MCP（Model Context Protocol）集成，将您的 AI 智能体连接至 8,000+ 款应用。本技能提供以下能力：

• 完整 UI 控制台 — 配置您的 MCP URL、测试连接、浏览可用工具
• 无需处理 OAuth 复杂性 — Zapier 全权负责所有认证流程
• MCP 集成 — 工具可通过 mcporter 调用

概览

Zapier MCP 将您在 Zapier 中配置的操作以工具形式暴露，供您的智能体调用。与 Pipedream（需自行管理 OAuth Token）不同，Zapier MCP 采用基于 URL 的简易认证方式 — 只需粘贴您的 MCP URL 即可完成连接。

前提条件

1. Zapier 账户 — 在 zapier.com 注册
2. mcporter — MCP 工具运行器（npm install -g mcporter）
3. Clawdbot 网关 — v2026.1.0 或更高版本，且已启用 UI

快速开始

步骤 1：获取您的 Zapier MCP URL

1. 访问 zapier.com/mcp 并登录
2. 配置要暴露的操作（例如：“发送 Slack 消息”、“在 Google Sheet 中创建一行”）
3. 复制您的专属 MCP URL（格式类似 https://actions.zapier.com/mcp/...）

步骤 2：在 Clawdbot UI 中配置

1. 打开 Clawdbot 控制台 → Tools → Zapier
2. 点击 Configure
3. 粘贴您的 MCP URL
4. 点击 Save

完成！Zapier 将验证该 URL，并显示当前可用的工具数量。

步骤 3：使用您的工具

连接成功后，所有工具均可通过 mcporter 调用：

# 列出可用工具
mcporter list zapier-mcp --schema

# 调用指定工具
mcporter call zapier-mcp. --args '{"instructions": "your request"}'

使用模式

instructions 参数

每个 Zapier 工具均接受 instructions 参数。Zapier 的 AI 将据此推断并补全缺失参数：

# ❌ 表述模糊 — 可能触发澄清提示
mcporter call zapier-mcp.slack_send_message 
  --args '{"instructions": "Send a message"}'

# ✅ 表述具体 — AI 可自主解析参数
mcporter call zapier-mcp.slack_send_message 
  --args '{"instructions": "Send "Hello team!" to the #general channel"}'

output_hint 参数

用于控制返回的数据字段：

mcporter call zapier-mcp.google_sheets_find_row 
  --args '{
    "instructions": "Find row where email is bob@example.com",
    "output_hint": "name, email, phone number"
  }'

常见工具调用示例

# Slack
mcporter call zapier-mcp.slack_send_message 
  --args '{"instructions": "Send "Build complete!" to #deployments"}'

# Gmail
mcporter call zapier-mcp.gmail_send_email 
  --args '{"instructions": "Send email to bob@example.com with subject "Meeting" and body "See you at 3pm""}'

# Google Sheets
mcporter call zapier-mcp.google_sheets_create_row 
  --args '{"instructions": "Add row with Name=John, Email=john@example.com to Sales Leads spreadsheet"}'

# Notion
mcporter call zapier-mcp.notion_create_page 
  --args '{"instructions": "Create page titled "Meeting Notes" in the Team Wiki database"}'

# Calendar
mcporter call zapier-mcp.google_calendar_create_event 
  --args '{"instructions": "Create meeting "Team Standup" tomorrow at 10am for 30 minutes"}'

架构

工作原理

1. 您在 Zapier 的 MCP 控制台中配置操作
2. Zapier 为您的账户生成唯一的 MCP URL
3. Clawdbot 将该 URL 存入 mcporter 配置中
4. 当您调用工具时，mcporter 向 Zapier 发送 JSON-RPC 请求
5. Zapier 执行对应操作并返回结果

修改的文件

后端端点

该技能使用以下网关 RPC 方法：

SSE 响应格式

Zapier MCP 使用 Server-Sent Events 格式：

event: message
data: {"result":{"tools":[...]},"jsonrpc":"2.0","id":1}

后端会自动解析该格式。

UI 功能

Clawdbot 控制台中的 Zapier 页面提供以下功能：

• 连接状态 — 显示是否已配置及当前可用工具数量
• MCP URL 配置 — 支持粘贴并校验您的 URL
• 连接测试 — 验证 URL 是否有效
• 工具浏览器 — 可展开分组，按应用分类展示全部可用工具

工具分组

工具按所属应用自动分组：

• QuickBooks Online（47 个工具）
• Google Sheets（12 个工具）
• Slack（8 个工具）
• 等等

对比：Zapier vs Pipedream

建议选用 Zapier 的场景：您希望快速配置，且已在使用 Zapier。

建议选用 Pipedream 的场景：您需要细粒度的 OAuth 控制能力，或更倾向 Pipedream 的定价策略。

故障排查

“连接测试失败”

• 确认 URL 正确（必须以 https://actions.zapier.com/mcp/ 开头）
• 检查是否已在 Zapier 的 MCP 控制台中至少配置了一个操作
• 尝试在 Zapier 中重新生成 MCP URL

“无可用工具”

• 前往 zapier.com/mcp 添加若干操作
• 添加操作后，在 Clawdbot UI 中点击“Refresh”按钮

响应中包含 “followUpQuestion”

• Zapier 需要更多信息。请在 instructions 参数中提供更明确的指令。
• 示例：将“查找客户”改为“查找名为 Acme Corp 的客户”

工具未找到

• 运行 mcporter list zapier-mcp 查看当前可用工具列表
• 工具名称使用下划线命名：如 quickbooks_online_find_customer
• 您可能需要在 Zapier 的 MCP 配置中添加对应操作

添加应用专属技能

Zapier MCP 连接成功后，您可为高频使用的集成创建应用专属技能。参考：

• zapier-quickbooks — QuickBooks Online 工具，含详细参数说明

这些技能在复用底层 Zapier MCP 连接的同时，为特定应用提供更深入的文档支持。

参考文件

本技能包含如下参考实现：

• reference/zapier-backend.ts — 网关 RPC 处理器
• reference/zapier-controller.ts — UI 控制器逻辑
• reference/zapier-views.ts — UI 渲染（Lit）

可用于构建自定义集成或调试时参考。

安全注意事项

最佳实践：

• 切勿公开分享您的 MCP URL
• 若 URL 泄露，请立即在 Zapier 控制台中重新生成
• 定期审查 Zapier MCP 设置中已暴露的操作列表

支持资源

• ClawdHub：clawdhub.com/skills/zapier-mcp
• Zapier MCP：zapier.com/mcp
• Zapier 帮助中心：help.zapier.com
• Clawdbot Discord：discord.com/invite/clawd