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".
Zapier MCP セットアップの監視・維持管理を行う3つのモード。 コンテキストからモードを判断し、不明な場合は確認してください。
Zapier MCP サーバー自体の仕組みについては docs.zapier.com/mcp を参照してください。
トリガー: 「ツールを確認して」「zapier status」「ちゃんと動いてる?」など、全般的なステータス確認。
現在の状態をダッシュボード形式で素早く表示します。
利用可能な Zapier MCP ツールを確認する。 表示される内容はサーバーの設定によって異なります。アクションの一覧を報告するメタツールを公開しているサーバーもあれば、設定済みの各アクションを独自の名前付きツールとして公開しているサーバーもあります。利用可能なシグナルをそのまま使用してください。
Zapier ツールが利用できない場合: 接続状況を報告し、zapier-onboard の実行を提案する。
ツールが利用可能な場合は、アプリごとにグループ化してサマリーを作成する。
各アプリについて、以下を表示:
ダッシュボード形式で表示:
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] 件の問題が見つかりました。診断しましょうか?」
トリガー: 「セットアップを監査して」「ツールを整理して」「重複を探して」「何を削除すべき?」
非効率な部分(重複アクション、未使用ツール、ネイティブ MCP サーバーとの競合)を発見します。
利用可能な Zapier MCP ツールを確認し、全アクションの一覧を取得する。
Zapier MCP 内の重複を確認:
ネイティブ MCP サーバーとの競合を確認:
.cursor/mcp.json、claude_desktop_config.json、.mcp.json — クライアントにより異なる)に設定された他の 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 をデバッグして」、または特定のツール呼び出しが失敗した場合。
エラーパターンのマッチングによる体系的なトラブルシューティング。
コンテキストの収集: 何が問題だったかを確認するか、現在の会話のエラーを使用する。
以下の順で診断を実行:
a. 接続確認: 利用可能な Zapier ツールを呼び出してみる。何も動作しない場合、問題はサーバーレベル(認証、設定、ネットワーク)にある。
b. アクション確認: 対象のアクションがこのサーバーで利用可能か確認する。利用できない場合、ユーザーは mcp.zapier.com でそのアクションを追加する必要がある(サーバーにチャット内のディスカバリーツールがある場合はそれを使用)。
c. 認証確認: 対象アプリの読み取りアクションを呼び出してみる。認証エラーが返ってきた場合、アプリの再認証が必要。
d. パラメータ確認: 失敗した呼び出しのパラメータを確認する。よくある問題:
既知のエラーパターンと照合:
| 症状 | 考えられる原因 | 対処法 |
|---|---|---|
| すべてのツールが失敗する | サーバー認証の期限切れ | mcp.zapier.com で再認証 |
| 1 つのアプリが失敗し、他は正常 | アプリレベルの認証期限切れ | 該当アプリの再接続 |
| ツールが見つからない / 利用不可 | アクションが未設定 | mcp.zapier.com でアクションを追加するよう案内 |
| 「invalid params」エラー | フィールドまたは形式の誤り | ツールのパラメータスキーマを確認 |
| 結果が空だがデータが存在するはず | 検索条件が狭すぎる、またはフィールド名の誤り | 検索条件を広げるかフィールド名を確認 |
| 実行時にタイムアウト | サーバー過負荷またはアクションが低速 | 1 度リトライし、継続する場合は報告 |
| 「rate limit exceeded」エラー | リクエスト過多 | リクエストを分散し、30 秒待機 |
| あるプロジェクトでは動くが別では失敗 | プロジェクトレベルとグローバル設定の差異 | クライアントのプロジェクトレベルおよびグローバル MCP 設定の両方を確認 |
「診断結果は以下の通りです:
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.
Trigger: "check my tools", "zapier status", "is everything working?", or any general status inquiry.
A quick dashboard view of the current state.
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:
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?"
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.
Get the full inventory by inspecting the available Zapier MCP tools.
Check for duplicates within Zapier MCP:
Check for conflicts with native MCP servers:
.cursor/mcp.json, claude_desktop_config.json, .mcp.json — depends on the client)Check for unused or low-value actions:
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?
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.
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:
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 |
"Here's what I found:
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。