make-mcp-reference

Make MCP サーバーのリファレンス

Make.com MCP サーバーの技術リファレンスです。AI クライアントがシナリオを実行し、Make アカウントを管理できるようにします。

既知の Make モジュール ID：Make Code モジュールは "module": "code:ExecuteCode" です。

接続方法

Codex のクイックセットアップ

Codex プラグインをインストールしても codex mcp list に Make MCP サーバーが表示されない場合は、手動で追加します。

codex mcp add make --url https://mcp.make.com
codex mcp login make

ログイン後、ツールをテストする前に Codex セッションを再接続するか、新しいセッションを開始してください。

OAuth（デフォルト）

OAuth の同意フローで接続します。認証中に組織とスコープを選択します。

エンドポイント： https://mcp.make.com

URL の種類：

トランスポート	URL
ステートレス Streamable HTTP（デフォルト）	https://mcp.make.com
Streamable HTTP	https://mcp.make.com/stream
SSE	https://mcp.make.com/sse

SSE に対応していないクライアントでは、Cloudflare の mcp-remote プロキシラッパーを使用するレガシートランスポートを利用できます：npx -y mcp-remote https://mcp.make.com/sse。

Claude Code の設定：

{
  "mcpServers": {
    "make": {
      "type": "http",
      "url": "https://mcp.make.com"
    }
  }
}

アクセス制御： OAuth の同意時に、特定の組織にアクセスを制限できます。Teams プラン以上では、チームレベルの制限が有効になります。

MCP トークン

Make のプロフィール → API access タブ → Add token でトークンを生成します。

エンドポイント： https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>/stateless

URL の種類：

トランスポート	URL
ステートレス Streamable HTTP	https://<ZONE>/mcp/u/<TOKEN>/stateless
Streamable HTTP	https://<ZONE>/mcp/u/<TOKEN>/stream
SSE	https://<ZONE>/mcp/u/<TOKEN>/sse
ヘッダー認証	https://<ZONE>/mcp/stateless + Authorization: Bearer <TOKEN>

Claude Code の設定：

{
  "mcpServers": {
    "make": {
      "type": "http",
      "url": "https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>"
    }
  }
}

<MAKE_ZONE> は、組織のホスティングゾーン（例：eu1.make.com、eu2.make.com、us1.make.com）に置き換えてください。

セキュリティ： MCP トークンは秘密情報として扱ってください。バージョン管理にコミットしないでください。

スコープ

シナリオ実行スコープ

AI クライアントがアクティブなオンデマンドシナリオを表示して実行できるようにします。

• OAuth スコープ：「シナリオを実行」
• トークンスコープ： mcp:use
• 利用可能なプラン： すべてのプラン

管理スコープ

AI クライアントがアカウントのコンテンツ（シナリオ、接続、Webhook、データストア、チーム）を表示および変更できるようにします。

• 利用可能なプラン： 有料プランのみ
• Make アカウント管理をきめ細かく制御できます

シナリオを MCP ツールとして設定する

シナリオを MCP ツールとして表示するには：

1. シナリオのステータスをアクティブに設定します
2. スケジュールをオンデマンドに設定します
3. 適切なスコープを選択します（トークンの場合は mcp:use、OAuth の場合は「シナリオを実行」）
4. シナリオの入力を設定します。これらはツールのパラメーターになります
5. シナリオの出力を設定します。これらはツールの戻り値になります
6. 詳細なシナリオの説明を追加します。AI がツールの目的を理解し、見つけやすくなるため、強く推奨します

入出力のベストプラクティス：

• 明確でわかりやすい名前を付けます（AI エージェントはこれらを参照します）
• 想定されるデータを説明する詳細な説明を追加します
• Any より具体的なデータ型を使用します
• タイムアウト制限内に実行が完了するようにします

アクセス制御（トークン認証）

URL クエリパラメーターを使用して、利用可能なシナリオを制限します。

組織レベル：

?organizationId=<id>

チームレベル：

?teamId=<id>

シナリオレベル（単一）：

?scenarioId=<id>

複数のシナリオ：

?scenarioId[]=<id1>&scenarioId[]=<id2>

各レベルは相互に排他的です。組織、チーム、シナリオのフィルターは組み合わせられません。

タイムアウト

ツールの種類	OAuth	トークン（ステートレス）	トークン（SSE/ストリーム）
シナリオ実行	25s	40s	40s
管理	30s	60s	320s

シナリオの実行がタイムアウトを超えると、レスポンスに executionId が含まれます。シナリオは Make で最大 40 分間実行され続けます。その ID を使って executions_get を呼び出し、結果を確認してください。

詳細設定

ツール名の長さ

クエリパラメーターを使ってツール名の最大長をカスタマイズできます：

?maxToolNameLength=<32-160>

デフォルト：56 文字。

トラブルシューティング

問題	解決策
シナリオがツールとして表示されない	アクティブな状態であること、オンデマンドスケジュールが設定されていること、スコープが正しいことを確認してください
タイムアウトエラー	タイムアウト時間を延長するには、https://mcp.make.com からゾーン固有の https://<MAKE_ZONE>/mcp/<TRANSPORT> URL に切り替えてください。または、シナリオの複雑さを軽減するか、SSE トランスポートを使用してください
アクセスが拒否される	トークンのスコープとアクセス制御パラメーターを確認してください
接続が拒否される	ゾーン URL とトークンの有効性を確認してください
ツール一覧が古い	利用可能なツールを更新するため、MCP クライアントを再接続してください

リソース

• references/transport-details.md — トランスポートの詳細な比較、URL の構築、ゾーン一覧
• Make MCP Server のドキュメント — 公式ドキュメント
• make-scenario-building スキル — シナリオの構築：ルーティング、フィルタリング、反復、集計、エラー処理、ブループリントの構築
• make-module-configuring スキル — モジュールの設定：パラメーター、接続、マッピング、Webhook、データストア