make-mcp

Make.com MCP サーバー — AI で自動化シナリオを構築・デプロイ

⚠️ 免責事項： これは、Make.com の熱心なファンが作成した非公式のコミュニティ主導プロジェクトです。Make.com とは一切提携しておらず、承認や公式サポートも受けていません。

Model Context Protocol（MCP） サーバーです。Claude、GitHub Copilot、Cursor などの AI アシスタントから、Make.com のモジュールドキュメント、シナリオの検証、ワンクリックデプロイをすべて利用できます。40 以上のアプリにまたがる 200 以上の自動化モジュールを検索し、自動修復機能付きのブループリントを作成して、AI チャットから Make.com に直接デプロイできます。

機能

• 🔍 200 以上のモジュール — 200 以上の Make.com モジュール（Slack、Gmail、Google Sheets、Notion、OpenAI、その他 35 以上のアプリ）を全文検索
• 📋 モジュールの詳細 — あらゆるモジュールのパラメーター、型、説明、使用方法のドキュメントを取得
• ✅ ブループリントの検証 — デプロイ前に、シナリオの必須パラメーター不足、未登録モジュール、構造上の問題、ルーターのサブルートを確認
• 🛡️ アカウント対応の互換性チェック — デプロイ前に、モジュール ID を使用中の Make アカウント／リージョンに照らして検証し、「Module not found」エラーを防止
• 🚀 Make.com へのデプロイ — 検証済みのブループリントを API 経由で Make.com に直接送信
• 🩹 自動修復 — LLM が生成したブループリントを自動修正：不足している metadata を挿入し、designer の座標を追加して、ルーターの filter などの未対応プロパティを削除
• 🔀 ルーターのサポート — 複数のルートと再帰的な検証を含む builtin:BasicRouter を完全サポート
• 📚 シナリオテンプレート — よくあるワークフローで再利用できるシナリオテンプレートを参照
• 📖 ガイド付きプロンプト — シナリオの作成やモジュールの探索をガイドする MCP プロンプト
• 📊 リソースカタログ — 利用可能なアプリを参照できる MCP リソース
• 🧪 43 件のテスト — Vitest による単体テストと統合テストのスイート
• ⚡ 高速応答 — FTS5 全文検索を備えた最適化済み SQLite

---

🚀 クイックスタート — セルフホストの方法

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

最も手軽に始める方法です。クローンもビルドも必要ありません。

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

# Run directly — no installation needed!
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 がインストールされていること

# Build the Docker image
docker build -t make-mcp-server .

# Test it works
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"
      ]
    }
  }
}

重要： MCP の stdio 通信には -i フラグが必要です。

---

オプション C：ローカルインストール（開発向け）🛠️

前提条件： Node.js と Git

# 1. Clone and install
git clone https://github.com/danishashko/make-mcp.git
cd make-mcp
npm install

# 2. Build
npm run build

# 3. Populate the module database (already done if using npm package)
npm run scrape:prod

# 4. Test it works
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 の認証情報は省略可能です。認証情報がなくても、すべてのドキュメント、検索、検証ツールを利用できます。認証情報を設定すると、シナリオのデプロイ機能も利用できます。

---

設定ファイルの場所

プラットフォーム	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

設定を更新した後、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 アシスタントに尋ねてください。

「新しいメッセージを監視して Google スプレッドシートに記録する Make のシナリオを作成してください」

「メール送信に使える Make のモジュールには何がありますか？」

「このシナリオのブループリントを検証してください……」

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

利用可能なツール

ツール	説明
tools_documentation	まずはこちら — すべてのツール、プロンプト、リソースに関する包括的なドキュメントを返します
search_modules	200 以上の Make.com モジュールを全文検索します
get_module	モジュールの詳細情報、パラメーター、ドキュメントを取得します
check_account_compatibility	現在の Make アカウント／リージョンでモジュールが利用可能か確認します（候補も提案します）
validate_scenario	デプロイ前にシナリオのブループリントを検証します
create_scenario	API 経由でシナリオを Make.com にデプロイします
search_templates	再利用可能なシナリオテンプレートを検索します
list_apps	モジュール数とともにすべてのアプリを一覧表示します

自動修復

create_scenario ツールは、LLM が生成したブループリントによくある問題を自動的に修正します。

問題	自動修正
metadata セクションがない	version、scenario 設定、designer を含む完全なメタデータを挿入します
モジュールに metadata.designer がない	{ x: 0, y: 0 } の座標を追加します
route オブジェクト内の Router filter	サポートされていない filter プロパティを削除します（フィルターは Make.com の UI で設定してください）
モジュールに version がない	設定しません — Make.com がインストール済みの最新バージョンを自動的に解決します
カタログの不一致（IM007、モジュールが利用不可）	アカウント／リージョンで利用可能なモジュールを確認し、近い候補に自動的に置き換えて、デプロイを 1 回再試行します

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

MCP プロンプト

プロンプト	説明
build_scenario	自然言語の説明から Make.com のシナリオを作成するためのガイド付きワークフロー
explain_module	任意の Make.com モジュールについて、使用例を含む詳細な説明を取得します

MCP リソース

リソース URI	説明
make://apps	利用可能なすべてのアプリをモジュール数とともに一覧表示します

CLI の使用方法

make-mcp-server              # Start the MCP server (stdio transport)
make-mcp-server --scrape     # Populate/refresh the module database
make-mcp-server --version    # Print version
make-mcp-server --help       # Show help

環境変数

変数	必須	デフォルト	説明
MAKE_API_KEY	デプロイ時	—	Make.com API キー
MAKE_API_URL	いいえ	https://eu1.make.com/api/v2	Make.com API のベース URL
MAKE_TEAM_ID	デプロイ時	—	シナリオのデプロイに使用するデフォルトのチーム ID
DATABASE_PATH	いいえ	<package>/data/make-modules.db	SQLite データベースファイルのパス
LOG_LEVEL	いいえ	info	ログレベル：debug、info、warn、error、silent
MAKE_MODULE_CACHE_TTL_MS	いいえ	300000	ライブモジュールカタログの確認に使用するキャッシュ TTL（ミリ秒）

開発

npm run build         # Compile TypeScript + copy schema + add shebang
npm run build:tsc     # TypeScript only (no packaging)
npm run start:dev     # Start with tsx (no build needed)
npm run dev           # Start with file watching
npm run scrape        # Populate DB with tsx (dev)
npm run scrape:prod   # Populate DB from compiled JS
npm run smoke:compat  # One-command account compatibility + validation smoke check
npm test              # Run all 43 tests
npm run test:watch    # Run tests in watch mode

npm への公開

npm run prepublishOnly   # Build + populate DB + verify (runs automatically on npm publish)
npm publish              # Publish to npm registry

テスト

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

• データベーステスト（14 件） — 挿入、検索、テンプレート操作、FTS5 クエリ
• ロガーテスト（7 件） — 標準エラー出力のみへの出力、ログレベル、データのシリアライズ
• サーバー統合テスト（22 件） — SDK クライアントによる MCP プロトコルの完全な準拠

npm test

高速検証（2～3分）

検証やデプロイのロジックを変更した直後に、手早く動作を確認したい場合に使用します。

# 1) Fast regression check
npm test

# 2) One-command smoke check (compatibility + validation)
npm run smoke:compat

# 3) (Optional) Manual MCP exploration
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 server with tools, prompts, resources
├── database/
│   ├── schema.sql         # SQLite + FTS5 schema
│   └── db.ts              # Database access layer (npx-safe path resolution)
├── scrapers/
│   └── scrape-modules.ts  # Module data population (224 modules)
└── utils/
    └── logger.ts          # Structured stderr-only logger
bin/
├── make-mcp.js            # CLI entry point (npx, --help, --version, --scrape)
└── postinstall.js         # Post-install verification
scripts/
├── build.js               # Build: tsc + copy schema + add shebang
├── prepublish.js          # Publish prep: build + populate DB + verify
└── smoke-compat.js        # Fast local smoke test for module compatibility + validation
data/
└── make-modules.db        # Pre-built SQLite database (bundled in npm package)
tests/
├── database.test.ts       # Database unit tests (14)
├── logger.test.ts         # Logger unit tests (7)
└── server.test.ts         # MCP integration tests (22)
Dockerfile                 # Multi-stage Docker image

技術スタック

• 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 — 詳細は LICENSE を参照してください。