Make MCP

🚀 Make.com MCP Server — AIによる自動化シナリオの構築とデプロイ

⚠️ 免責事項: これはMake.comの熱心なファンによって作成された非公式のコミュニティ主導のプロジェクトです。Make.comとは関係がなく、承認もされておらず、公式にサポートされていません。

モデルコンテキストプロトコル (MCP) サーバーで、Claude、GitHub Copilot、Cursor などのAIアシスタントがMake.comのモジュールドキュメント、シナリオ検証、ワンクリックデプロイに完全にアクセスできるようになります。40以上のアプリにまたがる200以上の自動化モジュールを検索し、自動修復機能を備えたブループリントを構築し、AIチャットから直接Make.comにデプロイできます。

✨ 主な機能

• 🔍 200以上のモジュール — 200以上のMake.comモジュール（Slack、Gmail、Google Sheets、Notion、OpenAIなど35以上のアプリ）を全文検索できます。
• 📋 モジュールの詳細 — 任意のモジュールのパラメータ、タイプ、説明、使用ドキュメントを取得できます。
• ✅ ブループリントの検証 — デプロイ前に、シナリオの欠落したパラメータ、未知のモジュール、構造上の問題、ルーターのサブルートをチェックできます。
• 🛡️ アカウント対応互換性 — デプロイ前に、ライブのMakeアカウント/リージョンに対してモジュールIDを検証し、「モジュールが見つかりません」のシナリオを防ぎます。
• 🚀 Make.comへのデプロイ — APIを介して検証済みのブループリントを直接Make.comにプッシュできます。
• 🩹 自動修復 — LLMによって生成されたブループリントを自動的に修正します。欠落した metadata を挿入し、designer 座標を追加し、ルーターの filter などのサポートされていないプロパティを削除します。
• 🔀 ルーターサポート — 複数のルートと再帰的検証を備えた builtin:BasicRouter を完全にサポートします。
• 📚 シナリオテンプレート — 一般的なワークフローの再利用可能なシナリオテンプレートを閲覧できます。
• 📖 ガイド付きプロンプト — ガイド付きシナリオ構築とモジュール探索のためのMCPプロンプトが用意されています。
• 📊 リソースカタログ — 利用可能なアプリを閲覧するためのMCPリソースがあります。
• 🧪 43のテスト — Vitestを使用したユニット+統合テストスイートがあります。
• ⚡ 高速応答 — FTS5全文検索を備えた最適化されたSQLiteを使用しています。

🚀 クイックスタート — セルフホスティングオプション

オプションA: npx（インストール不要！）🚀

最速の開始方法で、クローンもビルドも必要ありません。

前提条件: システムに Node.js がインストールされていること

# 直接実行 — インストール不要！
npx -y make-mcp-server

このパッケージには、200以上のすべてのMake.comモジュールが含まれる事前構築済みのデータベースが含まれています。MCPクライアント構成に追加するだけで使用できます。

Claude Desktop構成 (claude_desktop_config.json):

基本構成（ドキュメントツールのみ）:

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "npx",
      "args": ["-y", "make-mcp-server"],
      "env": {
        "LOG_LEVEL": "error"
      }
    }
  }
}

完全構成（Make.comデプロイを含む）:

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "npx",
      "args": ["-y", "make-mcp-server"],
      "env": {
        "LOG_LEVEL": "error",
        "MAKE_API_KEY": "your_api_key_here",
        "MAKE_TEAM_ID": "your_team_id",
        "MAKE_API_URL": "https://eu1.make.com/api/v2"
      }
    }
  }
}

注意: npxは自動的に最新バージョンをダウンロードしてキャッシュします。パッケージにはすべてのMake.comモジュール情報が含まれる事前構築済みのデータベースが含まれており、セットアップは必要ありません。

オプションB: Docker（分離された再現可能な環境）🐳

前提条件: システムにDockerがインストールされていること

# Dockerイメージをビルド
docker build -t make-mcp-server .

# 動作をテスト
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}},"id":1}' | docker run -i --rm make-mcp-server

Claude Desktop構成:

基本構成（ドキュメントツールのみ）:

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "-e", "LOG_LEVEL=error",
        "make-mcp-server"
      ]
    }
  }
}

完全構成（Make.comデプロイを含む）:

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "-e", "LOG_LEVEL=error",
        "-e", "MAKE_API_KEY=your_api_key_here",
        "-e", "MAKE_TEAM_ID=your_team_id",
        "-e", "MAKE_API_URL=https://eu1.make.com/api/v2",
        "make-mcp-server"
      ]
    }
  }
}

重要: -i フラグはMCPの標準入出力通信に必要です。

オプションC: ローカルインストール（開発用）🛠️

前提条件: Node.js とGit

# 1. クローンしてインストール
git clone https://github.com/danishashko/make-mcp.git
cd make-mcp
npm install

# 2. ビルド
npm run build

# 3. モジュールデータベースを作成（npmパッケージを使用する場合はすでに完了しています）
npm run scrape:prod

# 4. 動作をテスト
npm start

Claude Desktop構成:

{
  "mcpServers": {
    "make-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/make-mcp/dist/mcp/server.js"],
      "env": {
        "LOG_LEVEL": "error",
        "MAKE_API_KEY": "your_api_key_here",
        "MAKE_TEAM_ID": "your_team_id"
      }
    }
  }
}

注意: Make.comのAPI資格情報はオプションです。指定しない場合、すべてのドキュメント、検索、検証ツールにアクセスできます。指定すると、シナリオのデプロイ機能も利用できます。

設定ファイルの場所

設定を更新したら、Claude Desktopを再起動してください。

💻 IDEの接続

make-mcp-serverは、任意のMCP互換クライアントで動作します。

• Claude Desktop — 上記の構成を参照してください
• VS Code (GitHub Copilot) — .vscode/mcp.json に追加してください
• Cursor — MCP設定に追加してください
• Claude Code — claude mcp add コマンドを使用してください
• Windsurf — MCP構成に追加してください

📚 ドキュメント

使用方法

次に、AIアシスタントに以下のような質問をします。

"Slackチャンネルの新しいメッセージを監視し、Googleシートに記録するMakeシナリオを作成して"

"Makeにはメール送信用のモジュールがありますか？"

"このシナリオブループリントを検証して..."

ヒント: AIは最初に tools_documentation を自動的に呼び出し、サーバーを効果的に使用する方法を理解します。

利用可能なツール

自動修復

create_scenario ツールは、LLMによって生成されたブループリントの一般的な問題を自動的に修正します。

ヒント: モジュールに "version": 1 をハードコードしないでください。一部のアプリ（例：HTTP）はv4以上であり、間違ったバージョンを指定すると「モジュールが見つかりません」のエラーが発生します。

MCPプロンプト

MCPリソース

CLIの使用方法

make-mcp-server              # MCPサーバーを起動（標準入出力トランスポート）
make-mcp-server --scrape     # モジュールデータベースを作成/更新
make-mcp-server --version    # バージョンを表示
make-mcp-server --help       # ヘルプを表示

環境変数

🔧 技術詳細

開発

npm run build         # TypeScriptをコンパイル + スキーマをコピー + シェバングを追加
npm run build:tsc     # TypeScriptのみ（パッケージングなし）
npm run start:dev     # tsxで起動（ビルド不要）
npm run dev           # ファイル監視で起動
npm run scrape        # tsxでDBを作成（開発用）
npm run scrape:prod   # コンパイルされたJSからDBを作成
npm run smoke:compat  # 1コマンドでアカウント互換性 + 検証のスモークテスト
npm test              # すべての43のテストを実行
npm run test:watch    # 監視モードでテストを実行

npmへの公開

npm run prepublishOnly   # ビルド + DBを作成 + 検証（npm publishで自動的に実行されます）
npm publish              # npmレジストリに公開

テスト

テストスイートには、3つのファイルにまたがる43のテストが含まれています。

• データベーステスト (14のテスト) — 挿入、検索、テンプレート操作、FTS5クエリ
• ロガーテスト (7のテスト) — 標準エラー出力のみの出力、ログレベル、データシリアル化
• サーバー統合テスト (22のテスト) — SDKクライアントを介した完全なMCPプロトコル準拠

npm test

高速検証（2 - 3分）

検証/デプロイロジックを変更した直後に、すぐに確信を得たい場合に使用します。

# 1) 高速回帰チェック
npm test

# 2) 1コマンドでのスモークテスト（互換性 + 検証）
npm run smoke:compat

# 3) (オプション) 手動でのMCP探索
npm run start:dev

次に、MCPクライアント（Claude/Cursor/Copilot）で以下のシーケンスを実行します。

1. 既知のモジュール（例：gateway:CustomWebHook）で check_account_compatibility を実行する。
2. ブループリントで validate_scenario を実行する。
3. 互換性が良好な場合のみ、create_scenario を実行する。

ステップ1で互換性のないモジュールが報告された場合は、デプロイする前に提案された置換IDを使用してください。

アーキテクチャ

src/
├── mcp/
│   └── server.ts          # ツール、プロンプト、リソースを備えたMCPサーバー
├── database/
│   ├── schema.sql         # SQLite + FTS5スキーマ
│   └── db.ts              # データベースアクセス層（npx安全なパス解決）
├── scrapers/
│   └── scrape-modules.ts  # モジュールデータの作成（224のモジュール）
└── utils/
    └── logger.ts          # 構造化された標準エラー出力のみのロガー
bin/
├── make-mcp.js            # CLIエントリポイント（npx、--help、--version、--scrape）
└── postinstall.js         # インストール後の検証
scripts/
├── build.js               # ビルド: tsc + スキーマをコピー + シェバングを追加
├── prepublish.js          # 公開前の準備: ビルド + DBを作成 + 検証
└── smoke-compat.js        # モジュール互換性 + 検証の高速ローカルスモークテスト
data/
└── make-modules.db        # 事前構築済みのSQLiteデータベース（npmパッケージに含まれる）
tests/
├── database.test.ts       # データベースユニットテスト（14）
├── logger.test.ts         # ロガーユニットテスト（7）
└── server.test.ts         # MCP統合テスト（22）
Dockerfile                 # マルチステージDockerイメージ

テクノロジースタック

• TypeScript + Node.js (ESM)
• @modelcontextprotocol/sdk v1.26.0 — MCPプロトコルの実装
• better-sqlite3 — FTS5全文検索を備えた同期型SQLite
• zod — ツールパラメータのスキーマ検証
• axios — Make.com API用のHTTPクライアント
• vitest — テストフレームワーク

サポートされているアプリ（40以上）

Google Sheets、Slack、OpenAI、Google Drive、Notion、Telegram Bot、HubSpot CRM、Gmail、Airtable、Tools、Flow Control、Google Calendar、Jira、Trello、Shopify、Google Docs、Microsoft Teams、Microsoft Outlook、Discord、Asana、monday.com、Salesforce、Stripe、GitHub、HTTP、Mailchimp、WordPress、Dropbox、Data Store、JSON、Twilio、Google Gemini AI、WhatsApp Business、Text Parser、Webhooks、Anthropic Claude、CSV、RSS、Email、Schedule

作者

Daniel Shashko によって構築されました。

📄 ライセンス

MITライセンス — 詳細については LICENSE を参照してください。