🏥zapier-status
- プラグイン
- zapier
- ソース
- GitHub で見る ↗
説明
Zapier MCPのセットアップ状態を確認します。 3つのモードを備えています — ヘルスチェック(ダッシュボード表示)、監査(無駄や重複の検出)、診断(体系的なトラブルシューティング)。 次のような場合に使用: 「MCPは正常に動作していますか?」「ツールを確認して」「セットアップを監査して」「何が壊れていますか?」「Zapierのステータスを教えて」などと尋ねるとき。
原文を表示
Check the health of your Zapier MCP setup. Three modes — health check (dashboard view), audit (find waste and duplicates), diagnose (systematic troubleshooting). Use when asking "is my MCP working?", "check my tools", "audit my setup", "what's broken?", or "zapier status".
ユースケース
- ✓MCPの正常動作を確認するとき
- ✓無駄や重複を検出するとき
- ✓セットアップを監査するとき
- ✓トラブルシューティングが必要なとき
- ✓Zapierのステータスを確認するとき
本文(日本語訳)
Zapier ステータス
Zapier MCP セットアップの監視・維持管理を行う3つのモード。 コンテキストからモードを判断し、不明な場合は確認してください。
Zapier MCP サーバー自体の仕組みについては docs.zapier.com/mcp を参照してください。
モード 1: ヘルスチェック
トリガー: 「ツールを確認して」「zapier status」「ちゃんと動いてる?」など、全般的なステータス確認。
現在の状態をダッシュボード形式で素早く表示します。
手順
-
利用可能な Zapier MCP ツールを確認する。 表示される内容はサーバーの設定によって異なります。アクションの一覧を報告するメタツールを公開しているサーバーもあれば、設定済みの各アクションを独自の名前付きツールとして公開しているサーバーもあります。利用可能なシグナルをそのまま使用してください。
-
Zapier ツールが利用できない場合: 接続状況を報告し、zapier-onboard の実行を提案する。
-
ツールが利用可能な場合は、アプリごとにグループ化してサマリーを作成する。
各アプリについて、以下を表示:
- アプリ名
- アクション数
- アクションの種類(名前から読み取り/書き込みを推測: find/search/get/list = 読み取り、send/create/update/add = 書き込み)
- クイックステータス: 正常 / 要認証 / エラー
ダッシュボード形式で表示:
Zapier MCP ステータス
=====================
サーバー: 接続済み
合計アクション数: 5 アプリにわたり 14 件
Slack 3 アクション (読み取り 2, 書き込み 1) ✓ 正常
Gmail 3 アクション (読み取り 1, 書き込み 2) ✓ 正常
Google Cal 2 アクション (読み取り 1, 書き込み 1) ✓ 正常
Jira 3 アクション (読み取り 2, 書き込み 1) ✓ 正常
Google Docs 2 アクション (読み取り 1, 書き込み 1) ✓ 正常
-
最近のエラーや認証の問題により、正常に動作していないアクションがあれば警告を表示する。
-
最後に次のいずれかで締めくくる: 「すべて正常です。」または「[N] 件の問題が見つかりました。診断しましょうか?」
モード 2: 監査
トリガー: 「セットアップを監査して」「ツールを整理して」「重複を探して」「何を削除すべき?」
非効率な部分(重複アクション、未使用ツール、ネイティブ MCP サーバーとの競合)を発見します。
手順
-
利用可能な Zapier MCP ツールを確認し、全アクションの一覧を取得する。
-
Zapier MCP 内の重複を確認:
- 同じアプリに対して似たようなことを行う複数のアクション(例: Slack に「find message」と「search messages」の両方が存在するなど)
- 有用性の低い方を削除するよう推奨する
-
ネイティブ MCP サーバーとの競合を確認:
- クライアントの MCP 設定ファイル(例:
.cursor/mcp.json、claude_desktop_config.json、.mcp.json— クライアントにより異なる)に設定された他の MCP サーバーを確認する - ネイティブの Slack MCP と Zapier の Slack アクションが両方ある場合は警告を表示する
- 推奨例: 「Slack が Zapier とネイティブ Slack サーバーの両方で設定されています。単一アプリの利用にはネイティブサーバーの方が通常優れています。Zapier の Slack アクションの削除を検討してください。」
- クライアントの MCP 設定ファイル(例:
-
未使用または低価値なアクションを確認:
- デフォルトとして有用性が低いアクション(例: 必要なときだけ使うような非常に限定的な書き込みアクション)
- 必要に応じて再追加できるアクションは削除を提案する
-
監査レポートを表示:
監査結果
========
重複: 1 件
- Slack: "find_message" と "search_messages" が重複しています。"search_messages" の削除を推奨。
ネイティブ競合: 1 件
- Slack: ネイティブ Slack MCP も設定されています。Zapier の Slack アクションの削除を検討してください。
整理候補: 2 件
- Google Sheets "delete_row": 使用頻度が低く、必要時に再追加可能
- Jira "add_attachment": 限定的なアクション、必要時に追加してください
削除推奨アクション数: 4 件
これらの整理方法を案内しましょうか?
- ユーザーが「はい」と答えた場合は、推奨アクションを削除するために mcp.zapier.com へ誘導する(サーバーにチャット内での無効化ツールがある場合はそれを使用)。削除すべきアクションを正確にリストアップする。
モード 3: 診断
トリガー: 「何が壊れてる?」「ツールが動かない」「MCP をデバッグして」、または特定のツール呼び出しが失敗した場合。
エラーパターンのマッチングによる体系的なトラブルシューティング。
手順
-
コンテキストの収集: 何が問題だったかを確認するか、現在の会話のエラーを使用する。
-
以下の順で診断を実行:
a. 接続確認: 利用可能な Zapier ツールを呼び出してみる。何も動作しない場合、問題はサーバーレベル(認証、設定、ネットワーク)にある。
b. アクション確認: 対象のアクションがこのサーバーで利用可能か確認する。利用できない場合、ユーザーは mcp.zapier.com でそのアクションを追加する必要がある(サーバーにチャット内のディスカバリーツールがある場合はそれを使用)。
c. 認証確認: 対象アプリの読み取りアクションを呼び出してみる。認証エラーが返ってきた場合、アプリの再認証が必要。
d. パラメータ確認: 失敗した呼び出しのパラメータを確認する。よくある問題:
- 必須フィールドの欠落
- フィールド形式の誤り(ID と名前の混在など)
- パラメータリゾルバに対して曖昧すぎる指示
-
既知のエラーパターンと照合:
| 症状 | 考えられる原因 | 対処法 |
|---|---|---|
| すべてのツールが失敗する | サーバー認証の期限切れ | mcp.zapier.com で再認証 |
| 1 つのアプリが失敗し、他は正常 | アプリレベルの認証期限切れ | 該当アプリの再接続 |
| ツールが見つからない / 利用不可 | アクションが未設定 | mcp.zapier.com でアクションを追加するよう案内 |
| 「invalid params」エラー | フィールドまたは形式の誤り | ツールのパラメータスキーマを確認 |
| 結果が空だがデータが存在するはず | 検索条件が狭すぎる、またはフィールド名の誤り | 検索条件を広げるかフィールド名を確認 |
| 実行時にタイムアウト | サーバー過負荷またはアクションが低速 | 1 度リトライし、継続する場合は報告 |
| 「rate limit exceeded」エラー | リクエスト過多 | リクエストを分散し、30 秒待機 |
| あるプロジェクトでは動くが別では失敗 | プロジェクトレベルとグローバル設定の差異 | クライアントのプロジェクトレベルおよびグローバル MCP 設定の両方を確認 |
- 診断結果を報告:
「診断結果は以下の通りです:
- 接続: 正常(サーバー応答あり)
- アクション: 5 アプリにわたり 14 ツール利用可能
- 認証の問題: Gmail の接続が期限切れです。mcp.zapier.com で Gmail を再認証してください。
- 推奨事項: [直接リンクまたは具体的な手順]」
- ユーザーの操作が必要な場合(再認証、設定変更など)は、具体的なリンクまたは手順を提示する。AI が対処できる問題(パラメータの調整、別ツールの試用など)であれば、実行を申し出る。
全般的な注意事項
- どのモードでも、最初の診断ステップとして利用可能な Zapier MCP ツールを必ず確認する。
- 生のエラーメッセージをそのまま出力しない。わかりやすい言葉に翻訳する。
- スキルで診断できない問題(サーバー側のバグ、API 障害など)の場合はその旨を伝え、status.zapier.com の確認またはサポートへの連絡を提案する。
原文(English)を表示
Zapier status
Three modes for monitoring and maintaining a Zapier MCP setup. Determine the mode from context, or ask if unclear.
For how the Zapier MCP server itself works, see docs.zapier.com/mcp.
Mode 1: Health check
Trigger: "check my tools", "zapier status", "is everything working?", or any general status inquiry.
A quick dashboard view of the current state.
Steps
-
Inspect the available Zapier MCP tools. The exact surface depends on the server's configuration — some servers expose meta-tools that report the action inventory, others expose each configured action as its own named tool. Use whichever signal is available.
-
If no Zapier tools are available: report the connection status and suggest running zapier-onboard.
-
If tools are available, build a summary by grouping them by app:
For each app, show:
- App name
- Number of actions
- Action types (infer read vs write from names: find/search/get/list = read, send/create/update/add = write)
- Quick status: working / needs auth / error
Format as a dashboard:
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
-
If any actions appear broken (based on recent errors or auth issues), flag them.
-
End with: "Everything looks good." or "Found [N] issues. Want me to diagnose them?"
Mode 2: Audit
Trigger: "audit my setup", "clean up my tools", "find duplicates", "what should I remove?"
Find inefficiencies: duplicate actions, unused tools, conflicts with native MCP servers.
Steps
-
Get the full inventory by inspecting the available Zapier MCP tools.
-
Check for duplicates within Zapier MCP:
- Multiple actions for the same app that do similar things (e.g., both a "find message" and a "search messages" Slack action)
- Recommend removing the less useful one
-
Check for conflicts with native MCP servers:
- Look at other MCP servers configured in the client's MCP config file (e.g.,
.cursor/mcp.json,claude_desktop_config.json,.mcp.json— depends on the client) - If the user has both a native Slack MCP and Zapier Slack actions, flag it
- Recommend: "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."
- Look at other MCP servers configured in the client's MCP config file (e.g.,
-
Check for unused or low-value actions:
- Actions that are rarely useful as defaults (e.g., very specific write actions that are only needed occasionally)
- Suggest removing actions that can be re-added on demand
-
Show the audit report:
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?
- If the user says yes, direct them to mcp.zapier.com to remove the recommended actions (or use the server's in-chat disable tool if available). List exactly which ones to remove.
Mode 3: Diagnose
Trigger: "what's broken?", "my tools aren't working", "debug my MCP", or when a specific tool call has failed.
Systematic troubleshooting with error pattern matching.
Steps
-
Gather context: Ask what went wrong, or use the error from the current conversation.
-
Run diagnostics in order:
a. Connection check: Try calling any available Zapier tool. If nothing works, the problem is server-level (auth, config, network).
b. Action check: Is the specific action available on this server? If not, the user needs to add it at mcp.zapier.com (or via the server's in-chat discovery tools if available).
c. Auth check: Try calling a read action for the affected app. If it returns an auth error, the app connection needs re-authentication.
d. Parameter check: Review the failing call's parameters. Common issues:
- Missing required fields
- Wrong field format (IDs vs names)
- Instructions that are too vague for the params resolver
-
Match against known error patterns:
| Symptom | Likely cause | Fix |
|---|---|---|
| All tools fail | Server auth expired | Re-authenticate at mcp.zapier.com |
| One app fails, others work | App-level auth expired | Re-connect that specific app |
| Tool not found / unavailable | Action not configured | Direct user to mcp.zapier.com to add it |
| "invalid params" | Wrong fields or format | Check the tool's parameter schema |
| Results are empty but expected data exists | Search too narrow or wrong field | Broaden the search or check field names |
| Timeout on execute | Server overloaded or action is slow | Retry once, then report if persistent |
| "rate limit exceeded" | Too many calls | Space out requests, wait 30 seconds |
| Works in one project, fails in another | Project-level vs global config | Check both project-level and global MCP config for the client |
- Report findings:
"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]"
- If the fix requires user action (re-auth, config change), provide the specific link or instruction. If it's something the AI can fix (adjust parameters, try a different tool), offer to do it.
General notes
- Always inspect the available Zapier MCP tools as the first diagnostic step in any mode.
- Don't dump raw error messages. Translate them into plain language.
- If a problem is beyond what the skill can diagnose (server-side bug, API outage), say so and suggest checking status.zapier.com or contacting support.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。