Zapier ワークフロー スキル

このスキルで解決する問題

Zapier MCP は Claude に 8,000 以上の個別ツール（すべての Zapier アクション）へのアクセスを提供します。ただし、重大な制限があります：

❌ メモリがない - Claude はあなたが使用するツールやその理由を記憶しません ❌ コンテキストがない - 特定のツールをいつ使用するかを知りません ❌ 1 回限りのアクションのみ - 複雑な複数ステップの Zap をトリガーできません ❌ セッションごとに新規スタート - すべてのコンテキストが会話間で失われます

2 種類の Zapier 自動化

1. MCP ツール（1 回限りのアクション）

• 個別の Zapier アクション（シートに行を追加、メール送信など）
• https://mcp.zapier.com/mcp/servers の Zapier MCP 経由で利用可能
• 柔軟でアドホックな自動化に最適
• 問題： 8,000 以上の選択肢があり、どれを使うべきか、いつ使うべきかガイドがありません

2. 複数ステップの Zap（ウェブフック トリガー）

• Zapier ダッシュボードで構築した複雑なワークフロー
• 複数のアクションが連鎖し、事前に最適化
• ウェブフック URL（POST リクエスト）経由でトリガー
• 問題： Claude はこれらをトリガーできません - MCP に含まれていません

このスキルの機能

このスキルは両方の問題を解決します - Claude に Zapier ワークフローの永続的なメモリを与えます：

✅ MCP ツールの好みを記憶 - 「経費は Google Sheets、タスクは Notion を使用」 ✅ 各ツールをいつ・なぜ使うかを知る - 「リサーチ時は Perplexity で検索、Google ではなく」 ✅ 複数ステップの Zap をトリガー - 「毎日のダイジェストを実行」= 複雑な Zap にウェブフック POST ✅ 自己学習 - Claude はあなたが教えるにつれてスキルを更新し、決して忘れません ✅ セッション間の永続性 - すべての会話で動作（グローバル インストール）

得られるもの

複数ステップの Zap の場合：

• ウェブフック URL とその機能を保存
• 複雑なワークフローを尋ねるだけでトリガー
• 各 Zap をいつ・なぜ使うかを記憶
• コスト、タイミング、出力をドキュメント化

MCP ツールの場合：

• どのタスクにどのツールを好むかをドキュメント化
• 再利用可能なワークフロー パターンを構築
• ツール固有の設定（シート名、形式など）を保存
• マルチツール オーケストレーション シーケンスを作成

自己学習：

• Claude が教えたときに自動的にスキル ファイルを更新
• 変更が永続化（グローバル インストール）またはプロジェクトごと（ローカル インストール）
• 手動編集は不要 - Claude と話すだけ

インストールとセットアップ

インストール場所

グローバル（~/.claude/skills/）- 推奨：

• 学習したパターンはすべてのプロジェクトで永続化
• すべてのための 1 つの Zap ライブラリ
• すべてのプロジェクトで設定が引き継がれます

プロジェクト レベル（./.claude/skills/）:

• 学習したパターンはこのプロジェクトのみ
• 他のプロジェクトから隔離
• プロジェクト固有のワークフローに便利

⚠️ セキュリティに関する警告

重要： このスキルはウェブフック URL とワークフロー詳細をプレーン テキスト ファイルに保存します。

ウェブフック URL には認証トークンが含まれます。 ウェブフック URL を持っている人は誰でも Zap をトリガーできます。

ベストプラクティス：

• ✅ グローバル ~/.claude/skills/ にインストール（プロジェクト リポジトリ内ではなく）
• ✅ プロジェクトにインストールする場合は .claude/ を .gitignore に追加
• ✅ 実際のウェブフック URL を持つスキル ファイルをパブリック リポジトリにコミットしない
• ✅ ウェブフック URL が誤って公開された場合は再生成
• ✅ 利用可能な場合は Zapier のウェブフック認証機能を使用

このスキルを共有する場合：

• 実際のウェブフック URL を削除
• プレースホルダー例に置き換え
• または共有/テスト用の個別のウェブフック URL を使用

前提条件

必須：

• Claude Code
• Zapier アカウント（ウェブフック と 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 ツールになります）
   • 一般的なツール：Run Zap、Add Row to Google Sheets、Send Email など

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 サーバーを編集してからコマンドを再度実行することで、後からツールを追加できます。

ウェブフック トリガーの Zap を作成

事前構築された最適化されたワークフローでオンデマンドでトリガーしたい場合：

1. Zapier ダッシュボード内：

   • 新しい Zap を作成
   • トリガーとして「Webhooks by Zapier」を選択
   • 「Catch Hook」を選択
   • 提供されたウェブフック URL をコピー

2. ワークフローを構築：

   • 必要なアクション（API 呼び出し、データ処理など）を追加
   • Zap をテストして最適化

3. このスキルでドキュメント化：

   • Claude に新しい Zap について説明（ウェブフック URL、機能、トリガー フレーズ）
   • Claude が自動的に references/zaps.md に追加
   • これで Claude に尋ねるだけでトリガーできます！

ウェブフック と MCP ツール：

• ウェブフック： 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. 更新形式：

   ユーザー：「会社データには Clearbit の代わりに Apollo を使用してください」
   Claude：[references/mcp-patterns.md で Read ツール を使用]
           [Edit ツール を使用して設定を更新]
           「更新しました！これからは会社のエンリッチメント用に Apollo を使用します。
            この変更はスキルで永続化されています。」
   

スキル更新でキャプチャすべき内容：

• ✅ ツール設定（どのタスクにどのツール）
• ✅ ワークフロー シーケンス（ステップバイステップ パターン）
• ✅ エラー処理アプローチ
• ✅ データ形式要件
• ✅ 新しい Zap とその詳細
• ❌ 1 回限りのリクエスト（スキルを乱雑にしないでください）
• ❌ 一時的なコンテキスト（代わりにメモリを使用）

決定ロジック

ウェブフック トリガーの Zap を使用するべき場合

ウェブフックを使用：

• タスクが複雑で複数ステップであり、既に洗練されている
• ユーザーが特定の Zap 名を提及（references/zaps.md を確認）
• 決定論的な実行が重要
• タスクに 5 以上の API 呼び出しまたは複雑なオーケストレーションが含まれる
• コスト/時間効率が重要（事前構築された Zap は最適化されている）

MCP ツール オーケストレーションを使用するべき場合

MCP ツールを使用：

• タスクが単純（1～3 個のアクション）
• 柔軟性が必要（パラメータが変わる）
• 新しいワークフロー パターンをテスト
• ユーザーが特定の MCP ツールを使用するよう明確に要求

実行パターン

1. トリガーをリッスン： ワークフロー名、「実行」、「トリガー」、「検索」、「リサーチ」など
2. 参照を確認： 詳細については、Read ツール を使用して適切なリファレンス ファイルを使用
3. 前提条件を確認：
   • MCP ツールが必要だが利用不可の場合： Zapier MCP セットアップ手順を提供（下記を参照）
   • MCP ツールが利用可能だが未ドキュメント化の場合： ツール発見プロトコルをトリガー（下記を参照）
   • ウェブフック URL が必要だが参照にない場合： ウェブフック抽出手順を提供（下記を参照）
4. 実行：
   • ウェブフック トリガーの Zap の場合： Bash ツール を使用して curl で ウェブフック URL に POST（ウェブフックは Zapier ダッシュボードで「Catch Hook」トリガーで作成）
   • MCP ツール ワークフローの場合： 適切な Zapier MCP ツール を直接呼び出し（https://mcp.zapier.com/mcp/servers 経由で設定）
5. 確認： ユーザーに自然言語で何が起きたかを伝える
6. 学習： ユーザーが修正した場合、Edit ツール を使用してスキル ファイルを更新
7. パターン保存を提案： 成功したツール使用後、パターンを保存することを提案（下記を参照）

プロアクティブなパターン検出と学習

重要： MCP ツールまたはワークフローでユーザーを正常にサポートした後、価値のあるパターンを保存することをプロアクティブに提案します。

パターンを保存するべき場合

MCP ツールを使用してタスクを完了した後、このパターンを保存する価値があるかを確認：

探すべき内容：

• 効果的に機能した複数ステップのツール シーケンス
• ユーザーが気に入った特定のパラメータの組み合わせ
• 繰り返されるワークフローまたはユースケース
• タスク中にユーザーが表現したツール設定
• ユーザーの問題に対する成功した解決策

以下の場合、保存を提案：

• 2 以上の MCP ツールをシーケンスで使用
• ユーザーが結果に満足を表現
• ユーザーが繰り返す可能性があるもの
• ユーザーがインタラクション中に特定の設定を指定

パターン保存を提案する方法

タスクの成功後：

「うまくいきました！[説明、例：「Perplexity でリサーチしてから Google Sheets に結果を保存」]することに気づきました。

このパターンを保存したいですか？教えてください：
- リッスンするトリガー ワード
- このワークフローをいつ・なぜ使用するか
- 任意の設定または変更

次回は自動的に記憶して実行します！」

パターンをドキュメント化

ユーザーが「はい」と言った場合：

1. references/mcp-patterns.md で Read ツール を使用
2. Edit ツール を使用して以下を含む新しいパターンを追加：
   • パターン名
   • トリガー フレーズ
   • いつ・なぜ使用するか
   • ステップバイステップ ワークフロー
   • パラメータ/設定
   • 例
3. 確認：「保存しました！次回 [トリガー] の場合、[ワークフロー] を実行します。」

保存する価値があるパターン例：

• 「リサーチとドキュメント化」（Perplexity → 要約 → Google Sheets）
• 「経費追跡」（金額/説明を抽出 → フォーマット → シートに追加）
• 「競争分析」（競合他社を検索 → 分析 → インサイトを保存）
• 「日次ブリーフィング」（複数検索 → 統合 → 配信）

保存しないでください：

• 1 回限りのリクエスト
• 非常に具体的/ユニークな状況
• シンプルなシングルツール使用（ユーザーが要求しない限り）

セットアップ検出と手順

Zapier MCP が検出されない場合

ユーザーが MCP ツール機能をリクエストしたが Zapier MCP が接続されていない場合：

「Zapier MCP ツールが接続されていません。セットアップ方法は次のとおりです：

1. https://mcp.zapier.com/mcp/servers にアクセス
2. Zapier アカウントにログイン
3. 「New MCP Server」（左上）をクリック
4. MCP Client ドロップダウンで「Claude Code」を選択
5. 名前を付ける（例：「My Zapier Tools」）
6. 「Add tools」をクリックし、必要な Zapier アクションを選択
7. 「Connect」をクリックして表示されたコマンドをコピー
8. ターミナルでそのコマンドを実行（次のようになります）：
   claude mcp add zapier https://mcp.zapier.com/api/mcp/mcp -t http -H "Authorization: Bearer [your-token]"
9. Claude Code を再起動

セットアップが完了すると、Zapier アクションを直接使用できるようになります！」

Zapier MCP が接続されている場合 - ツール発見とドキュメント化

重要： Zapier MCP が接続されている場合（mcp__zapier__ で始まるツールが利用可能）、ユーザーがリッチなコンテキストでドキュメント化するのをプロアクティブにサポート：

1. 利用可能なツールを一覧表示：

   • 利用可能な Zapier MCP ツールを確認
   • ユーザーに一覧を表示

2. 詳細なドキュメント化をプロンプト：

   「これらの Zapier MCP ツールが利用可能なことが確認できました：
   - mcp__zapier__google_sheets_create_spreadsheet_row
   - mcp__zapier__perplexity_chat_completion
   - [など]
   
   これらを効果的に使用するのを支援するために、理解する必要があります：
   
   使用したい各ツールについて、以下を教えてください：
   
   1. このツールはいつ使用すべきですか？
      - トリガーワードまたはフレーズは何ですか？
      - どのような状況またはコンテキスト？
      - どのタイプのリクエスト？
   
   2. このツールを他の選択肢の代わりに使用すべき理由は何ですか？
      - 何に最適ですか？
      - いつ使用しないべきですか？
   
   3. このツールはどのように使用すべきですか？
      - 特定のパラメータまたは設定は？
      - デフォルト値は？
      - シート名、形式、その他の詳細は？
   
   4. このツールが関連するパターンまたはワークフローは？
      - 複数ステップのシーケンス？
      - 他のツールとの一般的な組み合わせ？
   
   時間をかけてください - 詳細をいただくほど、より効果的にお役に立てます！」
   

3. スキルでドキュメント化：

   • references/mcp-patterns.md で Read ツール を使用
   • Edit ツール を使用して包括的なドキュメント化を追加：
     • ツール名と目的
     • トリガー フレーズ（いつ）
     • ユースケース（なぜ）
     • パラメータと設定（どのように）
     • 言及されている場合はワークフロー パターン
   • ドキュメント化された内容をユーザーに確認

これをトリガーすべき場合：

• MCP セットアップ後、初めてユーザーが Zapier またはワークフローについて言及
• ユーザーが明確に「どのツールがありますか？」または「Zapier で何ができますか？」と尋ねる
• references/mcp-patterns.md でドキュメント化されていない新しい Zapier MCP ツールを検出

ユーザーがウェブフック トリガーの Zap を追加したい場合

ユーザーが複数ステップの Zap をウェブフック トリガー用に作成または追加することを言及する場合、以下の手順を提供：

「既存の Zap からウェブフック URL を取得するには：

1. Zapier ダッシュボードで Zap にアクセス
2. トリガーが「Webhooks by Zapier」ノードであることを確認
3. 「Trigger Event」ドロップダウンで「Catch Hook」を選択
4. 「Test」タブに移動
5. 表示されている「Webhook URL」をコピー
6. その URL と以下を教えてください：
   - Zap がすることは何か（ステップバイステップ）
   - 使用したいトリガー フレーズ
   - その他の詳細（タイミング、コスト等）

この情報を追加すると、尋ねるだけで任意のタイミングでトリガーできるようになります！」

クイック リファレンス

• すべての Zap： references/zaps.md を参照
• MCP パターン： references/mcp-patterns.md を参照
• 一般的なワークフロー： 両方のファイルに例が含まれています

使用例

Zap をトリガー：

ユーザー：「毎日のダイジェストを実行」
Claude：[references/zaps.md で Read ツール を使用してウェブフック詳細を確認]
        [Bash ツール を使用して curl POST でウェブフックをトリガー]
        「毎日の AI ダイジェストを開始しました。約 3 分でメール経由で
         レポートが届きます。重大度の高い項目については SMS アラートがあります。」

MCP オーケストレーション を使用：

ユーザー：「量子コンピューティングの最新情報を調べてください」
Claude：[references/mcp-patterns.md で Read ツール を使用]
        [Perplexity Search MCP ツール を呼び出し]
        [結果を分析し、ギャップを特定]
        [より深い調査のために Perplexity Search を再度呼び出し]
        「ここで見つけたものは... [要約]」

学習と更新：

ユーザー：「いいえ、経費を追跡するときは『Expenses』ではなく『Personal Budget』シートを使用してください」
Claude：[references/mcp-patterns.md で Read ツール を使用]
        [Edit ツール を使用して Google Sheets セクションを更新]
        「了解しました - スキルを更新しました。これからは経費追跡に
         『Personal Budget』シートを使用します。」

FAQ とトラブルシューティング

「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 ツールを使用
• タスクが成功を完了
• 繰り返し可能と見える（1 回限りのリクエストではない）

明確に要求してみてください：

• 「これをパターンとして保存できますか？」
• 「次回のためにこのワークフローを記憶してください」

「ウェブフック 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 がウェブフック をトリガー成功

クイック テスト：

1. 「Zapier ツールがいくつありますか？」と尋ねる
2. 偽のウェブフックを追加して Claude に説明
3. references/zaps.md に追加されたかチェック

「スキル ファイルが大きくなりすぎて / ロードが遅い」

リファレンス ファイルが大きくなりすぎた場合：

• 古い/未使用のパターンを確認して削除
• 類似のワークフローを統合
• アクティブに使用されているツールのみをドキュメント化
• 異なるドメイン用に複数のスキル インスタンスに分割することを検討

パフォーマンス ヒント：

• トリガー フレーズを簡潔で具体的に保つ
• 1 回限りのワークフローをドキュメント化しない
• パターン カテゴリを使用して整理

「スキルをテンプレート状態にリセットしたい」

新規スタート：

1. 現在のスキル ファイルをバックアップ（保存したいものがあれば）
2. スキル ディレクトリを削除
3. GitHub から再クローン：https://github.com/AlexBoudreaux/claude-zapier-skill
4. フレッシュ テンプレートを ~/.claude/skills/ にコピー

「Zapier MCP なしでこのスキルを使用できますか？」

はい！ スキルは以下で動作します：

• ウェブフックのみ - MCP なしで複数ステップの Zap をトリガー
• MCP ツールのみ - ウェブフックなしでツール使用をドキュメント化
• 両方 - 完全な機能を取得

各モードは独立しており、それぞれ価値があります。

「セキュリティ：ウェブフック URL をアクシデンタルにコミットしました」

即座のアクション：

1. git 履歴からコミットを削除（git rebase、BFG Repo-Cleaner）
2. Zapier ダッシュボードでウェブフック URL を再生成：
   • Zap を編集
   • ウェブフック トリガー ノードを削除して再度追加
   • 新しいウェブフック URL を取得
3. スキル ファイルを新しい URL で更新
4. .claude/ を .gitignore に追加

予防：

• スキルをグローバル（~/.claude/skills/）にインストール
• プロジェクト内で .claude/ ディレクトリを決してコミットしない
• 共有例ではプレースホルダー URL を使用

重要な注釈

• ウェブフックはペイロードを必要としません - Zap は Zapier Tables からデータを取得します
• 常に実行前に参照ファイルを読んでください - 重要な詳細が含まれています
• 新しいことを学ぶときはスキル ファイルを更新してください - この会話に留めておかないでください

使用される Claude Code ツール

このスキルは以下の Claude Code ツールを使用します：

• Read - リファレンス ファイルを表示（zaps.md、mcp-patterns.md）
• Edit - スキル ファイルを新しいワークフロー、パターン、設定で更新
• Bash - curl POST リクエストを使用して Zapier ウェブフック をトリガー
• MCP ツール - Perplexity Search、Google Sheets、その他の統合を呼び出し