SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场zapier-status

zapier-status

智能体与模型

查看项目

更新于 10-16 06:34

技能介绍

用途

zapier-status 用于监控和维护 Zapier MCP 配置，提供三种模式：健康检查、审计和诊断。用户可根据上下文确定模式，或在不明确时询问。关于 Zapier MCP 服务器本身的工作方式，可参阅 docs.zapier.com/mcp。

主要能力

模式一：健康检查

触发词包括“check my tools”“zapier status”“is everything working?”或任何一般性状态询问。该模式提供当前状态的快速仪表盘视图。

步骤：

  1. 检查可用的 Zapier MCP 工具。具体接口取决于服务器配置——有些服务器暴露报告动作清单的元工具，有些则将每个配置的动作暴露为独立命名的工具。使用任何可用的信号。
  2. 如果没有可用的 Zapier 工具：报告连接状态并建议运行 zapier-onboard。
  3. 如果有可用工具，按应用分组构建摘要。对每个应用显示：应用名称、动作数量、动作类型（根据名称推断读写：find/search/get/list 为读，send/create/update/add 为写）、快速状态（working / needs auth / error）。
  4. 以仪表盘格式呈现，例如：
Zapier MCP status
=================
Server: connected
Total actions: 14 across 5 apps

Slack         3 actions (2 read, 1 write)     ✓ working
Gmail         3 actions (1 read, 2 write)     ✓ working
Google Cal    2 actions (1 read, 1 write)     ✓ working
Jira          3 actions (2 read, 1 write)     ✓ working
Google Docs   2 actions (1 read, 1 write)     ✓ working
  1. 如果任何动作看起来异常（基于近期错误或认证问题），标记出来。
  2. 以“Everything looks good.”或“Found [N] issues. Want me to diagnose them?”结束。

模式二：审计

触发词包括“audit my setup”“clean up my tools”“find duplicates”“what should I remove?”。该模式查找低效之处：重复动作、未使用的工具、与原生 MCP 服务器的冲突。

步骤：

  1. 通过检查可用的 Zapier MCP 工具获取完整清单。
  2. 检查 Zapier MCP 内部的重复：同一应用有多个功能相似的动作（例如同时存在“find message”和“search messages”的 Slack 动作），建议移除较不实用的那个。
  3. 检查与原生 MCP 服务器的冲突：查看客户端 MCP 配置文件中配置的其他 MCP 服务器（例如 .cursor/mcp.json、claude_desktop_config.json、.mcp.json——取决于客户端）。如果用户同时拥有原生 Slack MCP 和 Zapier Slack 动作，标记出来。建议：“You have Slack through both Zapier and a native Slack server. The native server is usually better for single-app use. Consider removing Zapier's Slack actions.”
  4. 检查未使用或低价值的动作：作为默认值很少有用的动作（例如仅在偶尔需要的非常具体的写动作），建议移除可按需重新添加的动作。
  5. 展示审计报告，例如：
Audit results
=============
Duplicates:       1 found
  - Slack: "find_message" and "search_messages" overlap. Recommend removing "search_messages".

Native conflicts:  1 found
  - Slack: native Slack MCP also configured. Consider removing Zapier Slack actions.

Cleanup candidates: 2 found
  - Google Sheets "delete_row": rarely needed, can re-add on demand
  - Jira "add_attachment": niche action, add when needed

Recommended removals: 4 actions
Want me to show you how to clean these up?
  1. 如果用户同意，引导他们前往 mcp.zapier.com 移除建议的动作（或使用服务器可用的聊天内禁用工具）。准确列出要移除的动作。

模式三：诊断

触发词包括“what's broken?”“my tools aren't working”“debug my MCP”，或当特定工具调用失败时。该模式进行系统化故障排查，并匹配错误模式。

步骤：

  1. 收集上下文：询问出了什么问题，或使用当前对话中的错误。
  2. 按顺序运行诊断：
    • a. 连接检查：尝试调用任何可用的 Zapier 工具。如果都不工作，问题是服务器级别的（认证、配置、网络）。
    • b. 动作检查：该特定动作在此服务器上是否可用？如果不可用，用户需要在 mcp.zapier.com 添加它（或通过服务器可用的聊天内发现工具）。
    • c. 认证检查：尝试为受影响的应用调用一个读动作。如果返回认证错误，该应用连接需要重新认证。
    • d. 参数检查：审查失败调用的参数。常见问题：缺少必填字段、字段格式错误（ID 与名称）、指令对参数解析器来说过于模糊。
  3. 匹配已知错误模式：
症状 可能原因 修复
所有工具失败 服务器认证过期 在 mcp.zapier.com 重新认证
一个应用失败，其他正常 应用级认证过期 重新连接该特定应用
工具未找到/不可用 动作未配置 引导用户前往 mcp.zapier.com 添加
“invalid params” 字段或格式错误 检查工具的参数字段模式
结果为空但预期数据存在 搜索过窄或字段错误 扩大搜索范围或检查字段名
执行超时 服务器过载或动作缓慢 重试一次，若持续则报告
“rate limit exceeded” 调用过多 分散请求，等待 30 秒
在一个项目可用，另一个失败 项目级与全局配置 检查客户端的项目级和全局 MCP 配置
  1. 报告发现，例如：“Here's what I found: Connection: OK (server responding); Actions: 14 tools available across 5 apps; Auth issue: Gmail connection expired. You need to re-authenticate Gmail at mcp.zapier.com. Recommendation: [direct link or specific instruction]”
  2. 如果修复需要用户操作（重新认证、更改配置），提供具体链接或指令。如果是 AI 可以修复的（调整参数、尝试不同工具），主动提出执行。

使用方式

在任何模式下，始终将检查可用的 Zapier MCP 工具作为第一步诊断。不要直接输出原始错误消息，应将其翻译为通俗语言。如果问题超出该技能可诊断的范围（服务器端 bug、API 中断），应说明并建议查看 status.zapier.com 或联系支持。

适用场景

  • 用户想快速了解 Zapier MCP 连接状态和可用工具。
  • 用户希望清理重复、未使用或与原生 MCP 服务器冲突的动作。
  • 用户遇到工具调用失败，需要系统化排查认证、配置或参数问题。

限制

该技能依赖可用的 Zapier MCP 工具进行检查。对于服务器端 bug 或 API 中断等超出其诊断范围的问题，只能建议查看 status.zapier.com 或联系支持。部分修复需要用户前往 mcp.zapier.com 手动操作。