zapier-dev-mcp

zapier-dev-mcp

Zapier のインテグレーションを構築する方向けの MCP サーバーです。Zapier MCP は AI が Zapier アプリを 使える ようにします。このサーバーは、アプリを 公開する ためのものです。zapier-platform-cli プロジェクトを Claude に指定できます。

• 「このインテグレーションには何が含まれていますか？」 — トリガー、作成、検索、認証、プラットフォームのバージョン、リクエストフック
• 「アプリのレビューを受ける準備はできていますか？」 — Zapier のレビューでインテグレーションが差し戻される一般的な理由をチェックするリンター
• 「バリデーターを実行して」 — プロジェクト独自の zapier validate をラップします

クイックスタート

Claude Code

claude mcp add zapier-dev -- npx -y zapier-dev-mcp

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

{
  "mcpServers": {
    "zapier-dev": {
      "command": "npx",
      "args": ["-y", "zapier-dev-mcp"]
    }
  }
}

次に、「C:\code\my-zapier-app を lint して、エラーの修正方法を順を追って説明して」と指示します。

ツール

ツール	内容
inspect_integration	アプリ定義の構造化された概要
lint_integration	レビュー準備状況レポート：エラー／警告／情報。それぞれコンポーネントのパスに紐付けられます
generate_test_fixtures	すぐに実行できるバンドルモック（型付きの inputData、認証フィールドから生成する authData）と、コンポーネントごとの appTester テストのひな形
validate_integration	プロジェクト独自の zapier validate（スキーマ＋スタイル）を実行します。CLI が見つからない場合はインストール方法を案内します

リンターのチェック内容

• 表示されるアクションで operation.sample が未設定 — 公開アプリでは必須で、レビューで差し戻される最も一般的な理由です
• 存在しないトリガーを参照する動的ドロップダウン（"trigger_key.id.label"）
• display.label／display.description／noun の未設定、ラベルのない入力フィールド
• 定義の version と package.json のバージョンの不一致、platformVersion と zapier-platform-core 依存関係の不一致
• connectionLabel のない認証（ユーザーがアカウントを区別できません）
• キーとマップキーの不一致、キーの重複

hidden コンポーネントは表示チェックの対象外です。リンターは zapier validate を補完します。スキーマ検証では不正な定義を検出し、こちらでは レビュー可能だが不十分な 定義を検出します。

注意事項

• プロジェクトの検査では、子プロセス内でエントリーモジュールを評価します（タイムアウトと出力上限あり）。これは Zapier CLI 自体が行う処理と同じです。信頼できるプロジェクト、つまり自分のプロジェクトのみを指定してください。
• 関数である計算入力フィールドは静的に lint できないため、警告せずにスキップします。
• Zapier との提携や、Zapier による推奨を受けているものではありません。zapier-platform-cli は Zapier のオープンソース SDK です。

開発

npm install
npm test                 # offline tests — synthetic projects written in-suite
npm run build            # tsc → dist/
node scripts/smoke.mjs   # end-to-end: generates a project, drives the server over stdio

アーキテクチャ：src/extract.ts（子プロセスによる定義の抽出）と src/lint.ts（純粋なレビュー用チェック）がロジックを担い、src/index.ts が MCP の配線を行います。

ライセンス

MIT