zapier-workflows

Zapier Workflows スキル

このスキルが解決する課題

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

❌ 記憶がない - Claude は、あなたがどのツールをなぜ使うのかを覚えていません ❌ 文脈がない - あなたのワークフローでいつ特定のツールを使うべきかを把握していません ❌ 単発のアクションしか実行できない - 複雑で複数ステップからなる Zap をトリガーできません ❌ セッションごとに毎回まっさらな状態 - 会話をまたぐとすべての文脈が失われます

Zapier 自動化の2つの種類

1. MCP ツール（単発のアクション）

• 個別の Zapier アクション（シートに行を追加、メールを送信など）
• Zapier MCP（https://mcp.zapier.com/mcp/servers）から利用可能
• その場その場の柔軟な自動化に最適
• 課題: 8,000 以上の選択肢があり、どれをいつ使うべきかの指針がない

2. 複数ステップの Zap（Webhook トリガー）

• Zapier ダッシュボードで構築した複雑なワークフロー
• 複数のアクションが連結され、事前に最適化されている
• Webhook URL（POST リクエスト）でトリガー
• 課題: Claude はこれらをトリガーできません。MCP に含まれていないためです

このスキルでできること

このスキルは、Zapier ワークフローに対する永続的な記憶を Claude に与えることで、両方の課題を解決します。

✅ MCP ツールの設定を記憶 - 「経費は Google スプレッドシート、タスクは Notion を使う」 ✅ 各ツールをいつ・なぜ使うかを把握 - 「調査には Google ではなく Perplexity で検索する」 ✅ 複数ステップの Zap をトリガー - 「毎日のダイジェストを実行」= 複雑な Zap への Webhook POST ✅ 自己学習 - あなたが教えるたびに Claude がスキルを更新し、忘れることはありません ✅ セッションをまたぐ永続性 - すべての会話で動作します（グローバルインストール）

得られるもの

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

• Webhook URL とその用途を保存
• 頼むだけで複雑なワークフローをトリガー
• 各 Zap をいつ・なぜ使うかを記憶
• コスト、タイミング、出力を文書化

MCP ツールの場合:

• どのタスクにどのツールを優先するかを文書化
• 再利用可能なワークフローのパターンを構築
• ツールごとの設定（シート名、フォーマットなど）を保存
• 複数ツールを組み合わせた連携シーケンスを作成

自己学習:

• あなたが教えると、Claude がスキルファイルを自動的に更新します
• 変更はグローバルインストールなら永続的に、ローカルインストールならプロジェクト単位で保存されます
• 手動での編集は不要です。Claude に話しかけるだけです

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

インストール場所

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

• 学習したパターンがすべてのプロジェクトで保持されます
• Zap のライブラリは1つにまとまります
• 設定がすべてのプロジェクトに引き継がれます

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

• 学習したパターンはこのプロジェクトのみに保存されます
• 他のプロジェクトから分離されます
• プロジェクト固有のワークフローに便利です

⚠️ セキュリティ警告

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

Webhook URL には認証トークンが含まれています。 誰かがあなたの Webhook URL を入手すると、あなたの Zap をトリガーできてしまいます。

ベストプラクティス:

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

このスキルを共有する必要がある場合:

• 先に実際の Webhook URL を削除する
• プレースホルダーの例に置き換える
• または、共有・テスト用に別の Webhook URL を使用する

前提条件

必須:

• Claude Code
• Zapier アカウント（Webhook と MCP ツールのため）

任意:

• ワークフローに応じた追加の MCP ツール（Perplexity Search、Google スプレッドシートなど）

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 のアクションを選択します (each becomes an MCP tool) 各アクションが 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 サーバーを編集し、接続コマンドをもう一度実行します。

Webhook でトリガーされる Zap の作成

事前に構築され最適化されたワークフローを、必要なときにトリガーしたい場合に使用します。

1. Zapier ダッシュボードで:

   • 新しい Zap を作成します
   • トリガーとして「Webhooks by Zapier」を選択します
   • 「Catch Hook」を選択します
   • 提供された Webhook URL をコピーします

2. ワークフローを構築します:

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

3. このスキルに記録します:

   • Claude に新しい Zap について伝えます (Webhook URL、機能、トリガーフレーズ)
   • Claude が references/zaps.md に自動的に追加します
   • これで、Claude に頼むだけでトリガーできるようになります!

Webhook と MCP ツールの違い:

• Webhook: 事前に構築された複数ステップの Zap を、POST リクエストでトリガーします。複雑で最適化されたワークフローに適しています。
• 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. 更新フォーマット:

   User: "Use Apollo instead of Clearbit for company data"
   Claude: [uses Read tool on references/mcp-patterns.md]
           [uses Edit tool to update the preference]
           "Updated! I'll use Apollo for company enrichment from now on.
            This change is now permanent in the skill."
   

スキルの更新に含めるべき内容:

• ✅ ツールの好み (どのタスクにどのツールを使うか)
• ✅ ワークフローの手順 (段階的なパターン)
• ✅ エラー処理の方法
• ✅ データ形式の要件
• ✅ 新しい Zap とその詳細
• ❌ 一度限りのリクエスト (スキルを散らかさないようにします)
• ❌ 一時的なコンテキスト (代わりにメモリを使います)

判断ロジック

Webhook でトリガーされる Zap を使う場合

次の場合に Webhook を使用します:

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

MCP ツールによるオーケストレーションを使う場合

次の場合に MCP ツールを使用します:

• タスクが単純である (1〜3 個のアクション)
• 柔軟性が必要である (パラメータが変わる)
• 新しいワークフローのパターンを試している
• ユーザーが特定の MCP ツールの使用を明示的に求めている

実行パターン

1. トリガーを検知する: ワークフロー名、「run」「trigger」「search」「research」などの語句
2. リファレンスを確認する: 詳細については、該当するリファレンスファイルを Read ツールで読み込む
3. 前提条件を確認する:
   • MCP ツールが必要だが利用できない場合: Zapier MCP のセットアップ手順を案内する（下記参照）
   • MCP ツールは利用できるがドキュメントがない場合: ツールの検出プロトコルを開始する（下記参照）
   • Webhook URL が必要だがリファレンスにない場合: Webhook の取得手順を案内する（下記参照）
4. 実行する:
   • Webhook でトリガーされる Zap の場合: Bash ツールで curl を使い、Webhook URL に POST する（Webhook は Zapier ダッシュボードで「Catch Hook」トリガーを使って作成される）
   • MCP ツールのワークフローの場合: 該当する Zapier MCP ツールを直接呼び出す（設定は https://mcp.zapier.com/mcp/servers で行う）
5. 確認する: 何が起きたかを自然な言葉でユーザーに伝える
6. 学習する: ユーザーから修正を受けた場合は、Edit ツールでスキルファイルを更新する
7. パターンの保存を提案する: ツールの利用に成功した後、パターンを保存するかどうかを提案する（下記参照）

自動的なパターン検出と学習

重要: MCP ツールやワークフローでユーザーを支援することに成功したら、価値のあるパターンを保存することを積極的に提案してください。

パターンの保存を提案するタイミング

MCP ツールを使ったタスクが完了したら、保存する価値のあるパターンかどうかを確認してください。

確認すべき点:

• うまく機能した複数ステップのツールの連携
• ユーザーが気に入った特定のパラメータの組み合わせ
• 繰り返し行われるワークフローやユースケース
• 作業中にユーザーが示したツールの好み
• ユーザーの問題に対する成功した解決策

次の場合は保存を提案する:

• 2 つ以上の MCP ツールを順番に使用した
• ユーザーが結果に満足を示した
• ユーザーが今後も繰り返しそうなものだと思われる
• ユーザーが対話中に特定の好みを示した

パターン保存の提案方法

タスクが無事に完了した後で:

"That worked well! I noticed I [describe what you did, e.g., 'used Perplexity to research, then saved results to Google Sheets'].

Would you like me to save this as a pattern? If you tell me:
- What trigger words to listen for
- When/why to use this workflow
- Any preferences or variations

I'll remember it and do this automatically next time!"

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

ユーザーが「はい」と答えた場合:

1. Read ツールで references/mcp-patterns.md を読み込む
2. Edit ツールで、次の内容を含む新しいパターンを追加する:
   • パターン名
   • トリガーとなるフレーズ
   • いつ・なぜ使うか
   • ステップごとのワークフロー
   • パラメータ・設定の好み
   • 例
3. 確認メッセージ: 「保存しました！次回「[トリガー]」と言われたら、[ワークフロー]を実行します。」

保存する価値のあるパターンの例:

• 「調査とドキュメント化」（Perplexity → 要約 → Google スプレッドシート）
• 「経費管理」（金額・内容を抽出 → 整形 → スプレッドシートに追加）
• 「競合分析」（競合を検索 → 分析 → 洞察を保存）
• 「毎日のブリーフィング」（複数の検索 → 統合 → 配信）

保存しないもの:

• 単発のリクエスト
• 非常に特殊・固有の状況
• 単純な単一ツールの利用（ユーザーが求めた場合を除く）

セットアップの検出と案内

Zapier MCP が検出されない場合

ユーザーが MCP ツールの機能を求めているのに Zapier MCP が接続されていない場合は、次のように伝えてください:

"I don't see the Zapier MCP tools connected. Here's how to set them up:

1. Go to https://mcp.zapier.com/mcp/servers
2. Login to your Zapier account
3. Click 'New MCP Server' (top left)
4. Select 'Claude Code' in the MCP Client dropdown
5. Give it a name (e.g., 'My Zapier Tools')
6. Click 'Add tools' and select the Zapier actions you want
7. Click 'Connect' and copy the command shown
8. Run that command in your terminal (it looks like):
   claude mcp add zapier https://mcp.zapier.com/api/mcp/mcp -t http -H "Authorization: Bearer [your-token]"
9. Restart Claude Code

Once setup, I'll be able to use those Zapier actions directly!"

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

重要: Zapier MCP が接続されている場合（mcp__zapier__ で始まるツールが利用可能な場合）、詳細なコンテキストとともにツールをドキュメント化するよう、積極的に支援してください。

1. 利用可能なツールを一覧にする:

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

2. 詳細なドキュメントを求める:

   "I see you have these Zapier MCP tools available:
   - mcp__zapier__google_sheets_create_spreadsheet_row
   - mcp__zapier__perplexity_chat_completion
   - [etc.]
   
   To help me use these effectively, I need to understand:
   
   For each tool you want me to use, please tell me:
   
   1. WHEN should I use this tool?
      - What trigger words or phrases?
      - What situations or contexts?
      - What types of requests?
   
   2. WHY should I use this tool vs alternatives?
      - What's it best for?
      - When should I NOT use it?
   
   3. HOW should I use it?
      - Any specific parameters or preferences?
      - Default values I should use?
      - Sheet names, formats, or other specifics?
   
   4. Any PATTERNS or workflows involving this tool?
      - Multi-step sequences?
      - Common combinations with other tools?
   
   Take your time - the more detail you give me, the better I can serve you!"
   

3. スキルにドキュメント化する:

   • Read ツールで references/mcp-patterns.md を読み込む
   • Edit ツールで、次の包括的なドキュメントを追加する:
     • ツール名と用途
     • トリガーとなるフレーズ（いつ）
     • ユースケース（なぜ）
     • パラメータと設定の好み（どのように）
     • 言及されていればワークフローのパターン
   • ドキュメント化した内容をユーザーに伝える

このプロセスを開始するタイミング:

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

ユーザーが Webhook でトリガーされる Zap を追加したい場合

ユーザーが Webhook でトリガーされる複数ステップの Zap の作成または追加に言及した場合は、次の手順を案内してください:

"To get your webhook URL from an existing Zap:

1. Go to your Zap in the Zapier dashboard
2. Make sure the trigger is a 'Webhooks by Zapier' node
3. In the 'Trigger Event' dropdown, select 'Catch Hook'
4. Go to the 'Test' tab
5. Copy the 'Webhook URL' shown
6. Give me that URL and tell me:
   - What the Zap does (step-by-step)
   - What trigger phrases you want to use
   - Any other details (timing, cost, etc.)

I'll add it to my knowledge so you can trigger it anytime just by asking!"

クイックリファレンス

• すべての Zap: references/zaps.md を参照
• MCP パターン: references/mcp-patterns.md を参照
• よくあるワークフロー: 両方のファイルに例が含まれています

使用例

Zap のトリガー:

User: "Run my daily digest"
Claude: [uses Read tool on references/zaps.md for webhook details]
        [uses Bash tool to trigger webhook with curl POST]
        "Started your Daily AI Digest. You'll get the report via email
         in ~3 minutes, with SMS alerts for any high-priority items."

MCP オーケストレーションの利用:

User: "Research the latest on quantum computing"
Claude: [uses Read tool on references/mcp-patterns.md]
        [calls Perplexity Search MCP tool]
        [analyzes results, identifies gaps]
        [calls Perplexity Search again for deeper dive]
        "Here's what I found... [summary]"

学習と更新:

User: "No, when tracking expenses use my 'Personal Budget' sheet, not 'Expenses'"
Claude: [uses Read tool on references/mcp-patterns.md]
        [uses Edit tool to update the Google Sheets section]
        "Got it - updated the skill. I'll use 'Personal Budget' sheet
         for expense tracking from now on."

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 ツールを連続して使用した
• タスクが正常に完了した
• 繰り返し可能そうである（一度限りのリクエストではない）

明示的に尋ねてみる:

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

「Webhook 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 がツールについて詳細な質問（WHEN/WHY/HOW）をする
3. ツールを使用した後、Claude がパターンの保存を提案する
4. Claude が自分の Webhook を正しくトリガーする

簡単なテスト:

1. 「私が使える Zapier ツールは何ですか？」と尋ねる
2. 偽の Webhook を追加して Claude に伝える
3. references/zaps.md に追加されたか確認する

「スキルファイルが大きくなりすぎる／読み込みが遅い」

参照ファイルが大きくなりすぎた場合:

• 古い／使われていないパターンを見直して削除する
• 類似のワークフローを統合する
• 実際に使用しているツールのみを文書化する
• 異なる領域ごとに複数のスキルインスタンスに分割することを検討する

パフォーマンスのヒント:

• トリガーフレーズは簡潔かつ具体的にする
• 一度限りのワークフローを文書化しない
• パターンのカテゴリを使って整理する

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

最初からやり直すには:

1. 現在のスキルファイルをバックアップする（残しておきたいものがある場合）
2. スキルディレクトリを削除する
3. GitHub から再クローンする：https://github.com/AlexBoudreaux/claude-zapier-skill
4. 新しいテンプレートを ~/.claude/skills/ にコピーする

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

はい！ このスキルは次の方法で動作します：

• Webhook のみ - MCP なしで複数ステップの Zap をトリガーする
• MCP ツールのみ - Webhook なしでツールの使用方法を文書化する
• 両方 - 完全な機能を利用する

各モードは独立しており、それぞれ単独でも有用です。

「誤って Webhook URL をコミットしてしまった」

直ちに行うこと:

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

予防策:

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

重要な注意事項

• Webhook にペイロードは不要です - Zap はデータを Zapier Tables から取得します
• 実行前に必ずリファレンスファイルを読んでください - 重要な詳細が記載されています
• 新しいことを学んだらスキルファイルを更新してください - この会話だけで覚えておくのではなく、保存してください

使用する Claude Code ツール

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

• Read - リファレンスファイル（zaps.md、mcp-patterns.md）を表示するため
• Edit - 新しいワークフロー、パターン、または設定でスキルファイルを更新するため
• Bash - curl POST リクエストで Zapier Webhook をトリガーするため
• MCP ツール - Perplexity Search、Google Sheets、その他の連携機能を呼び出すため