zapier-discovery-mcp

zapier-discovery-mcp

自動化の発見のためのMCPサーバーです。Zapier MCPは自動化を実行します。このサーバーは、その前に知りたいこと、つまり「何を自動化できるか」という問いに答えます。

• 「Slack と Notion の間では、どのような自動化が使われていますか？」 — 実際に人気のある Zap テンプレートを紹介します。それぞれワンクリックで作成できるリンク付きです。
• 「このツールに Zapier インテグレーションはありますか？」 — 9,000 以上のアプリディレクトリを検索します。
• 「私の CRM 向けに自動化のアイデアを教えてください」 — 幻覚ではなく、実際の利用状況に基づいて順位付けされたテンプレートを紹介します。

関連プロジェクト：zapier-dev-mcp は、Zapier インテグレーションの構築に使えます。

セットアップ

Zapier Partner API の client_id が必要です。Zapier インテグレーションがあれば無料で取得でき、秘密情報ではありません（クライアント側の埋め込みコードに含まれます）。取得場所については、Partner API のドキュメントをご覧ください。

Claude Code

claude mcp add zapier-discovery --env ZAPIER_CLIENT_ID=your_client_id -- npx -y zapier-discovery-mcp

Claude Desktop — claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "zapier-discovery": {
      "command": "npx",
      "args": ["-y", "zapier-discovery-mcp"],
      "env": { "ZAPIER_CLIENT_ID": "your_client_id" }
    }
  }
}

任意で、ZAPIER_API_BASE を指定すると API ホストを上書きできます（テスト、プロキシ用）。

ツール

ツール	機能
search_apps	アプリディレクトリを名前で検索します。クエリを指定しない場合は、人気順に表示します。次の手順で使うスラッグを返します。
find_zap_templates	1 つのアプリまたはアプリのペア向けに、人気のすぐ使える Zap テンプレートを表示します。タイトル、ステップの連鎖（Slack → Notion）、説明、ワンクリック作成 URL を返します。

設計上の注意点

• 堅牢な解析。 Partner API のレスポンスは一部しかドキュメント化されていません。そのため、クライアントはフィールドをホワイトリストで管理し、レスポンスの形式を決めつけずに、配列形式とラップされた形式の両方を処理します。
• 認証情報がなくてもテスト可能。 スモークテストでは Partner API のローカル HTTP モックを起動し、ZAPIER_API_BASE を使ってサーバーからモックに接続します。秘密情報がなくても、stdio 経由でエンドツーエンドのテストを実行できます。ZAPIER_CLIENT_ID が設定されていない場合はクラッシュせず、ツールのエラーとしてセットアップ手順を表示します。
• タイトルや説明に含まれる HTML は、モデルに渡す前に除去して短縮します。

Zapier とは提携しておらず、Zapier の推奨を受けたものでもありません。

開発

npm install
npm test                 # offline unit tests (mocked fetch)
npm run build            # tsc → dist/
node scripts/smoke.mjs   # end-to-end against a local Partner API mock

ライセンス

MIT