[限定提供]{class="badge informative" title="この機能は、現在、限定ベータ版リリース中です"}

Marketo Engage MCP サーバー

AVAILABILITY
この機能は限定的に利用できます。 アクセスをリクエストするには、このフォーム ​に入力してください。 サブスクリプションのMunchkin IDの準備が整っていることを確認します。

モデルコンテキストプロトコル(MCP)は、AI ツールが外部サービスと通信できるようにするオープンスタンダードです。 Marketo MCP サーバーは、AI アシスタントとMarketoの間のブリッジとして機能します。 フォーム、プログラム、スマートキャンペーン、リード、メール、スニペット、リスト、フォルダーなど、100以上の業務を網羅しています。

AI ツールがMCP サーバーを呼び出すと、サーバーは各リクエストで指定した資格情報を使用して、対応するREST API呼び出しを代わりに実行します。 サーバーサイドソフトウェアをインストールしたり、デプロイしたり、実行したりする必要はありません。

IMPORTANT
Model Context Protocol (MCP)は新しいオープンソースの標準であり、セキュリティや信頼性に関するリスクが生じる可能性があります。Adobe MCP サーバーの統合と関連ドキュメントは、いかなる保証も受けることなく、「現状のまま」提供されます。
MCP クライアントまたはサーバーをAdobe製品に接続することは、お客様が選択した設定であり、お客様はMCP統合のセキュリティと適合性を評価する責任があります。Adobeは、設定ミス、MCPの誤用、サードパーティ実装の脆弱性、またはMCP対応ワークフローを通じて実行された意図しないアクションから生じる問題については責任を負いません。
リスクを軽減するために、Adobeでは、実稼働的に使用する前にサンドボックス環境で統合をテストし、MCPが開始するすべてのアクションと応答を慎重にレビューおよび検証してから、確認または依存することを推奨しています。

MCPの基本

MCPは、AI アプリケーションのUSB-C ポートのようなものだと考えてください。 USB-Cがデバイスをさまざまな周辺機器やアクセサリに接続するための標準化された方法を提供するのと同様に、MCPはAI モデルをデータソースやツールに接続するための標準化された方法を提供します。 — ​ モデル コンテキスト プロトコル ​

MCPでは、AI ツールを複数の外部サービスに同時に接続できます。 例えば、AI アシスタントは次のような能力を備えています。

  • ワードプロセッサーに接続して、AIを活用したドキュメント生成を実現
  • Blenderなどのアニメーションツールに接続して、ビルドのビジュアライゼーションを行います
  • Adobe After Effectsに接続してビデオを編集

MCPは通信プロトコルであり、あらゆるアプリケーションがデータとアクションをAI ツールに公開するために実装できるオープンスタンダードです。

Marketo Engage MCPの機能と機能なし

MCPの範囲を把握することで、AI ツールを導入する前に期待値を設定することができます。

MCP実行:

  • 標準のREST APIを使用して、Marketo個のデータと機能へのアクセスを提供します
  • 各リクエストで指定した資格情報を使用して、API呼び出しを実行します
  • 複数の同時ユーザーをサポートし、それぞれが独自の資格情報で接続されています
  • OAuth トークンの自動更新を処理します。 トークンの有効期限を管理する必要はありません
  • テナントが分離された環境内で運用できるため、データが他のユーザーのセッションと競合することはありません

MCPが次の操作を行っていません:

  • AIまたはマシンラーニングモデルを使用、ホスト、実行します。 AIの処理はすべて、MCPではなくAI ツールで行われます
  • 顧客データを含むあらゆるデータを活用する、または学習する
  • 予測、提案、意思決定の促進: 意思決定は、下流のAI ツールやユーザーの責任です
  • リクエスト間で、資格情報、リクエストデータ、またはセッション状態を保存または保持する
  • サーバーサイドソフトウェアのインストール、デプロイ、管理が必要

MCPは、APIの使用状況に応じて、機密性の高いフィールドを含むデータを送信できますが、B2B データは顧客ビジネスデータを含み、PII データは含まれません。

前提条件

  • REST API アクセスが有効になっているMarketo インスタンス
  • Marketo LaunchPointでAPI資格情報を作成するための管理者アクセス
  • Claude Desktop、Cursor、Codex、Claude Code (CLI)、またはVS Code with GitHub CopilotのいずれかのAI ツール
  • MCP サーバーURLへのネットワーク アクセス:https://marketo-mcp.adobe.io/mcp

Marketo資格情報の取得

Marketo インスタンスには次の値が必要です。

  • クライアント ID
  • クライアント秘密鍵
  • Munchkin アカウント ID

既に使用している場合は、AI ツールの設定にスキップします。

クライアント IDとクライアント秘密鍵

  1. 管理者 > LaunchPoint​に移動します。
  2. API サービスを選択します。 お持ちでない場合は、New > New Service​を選択し、サービスタイプとして​ Custom ​を選択して、専用のAPI ユーザーを割り当てます。
  3. 詳細を表示​を選択し、クライアント ID​および​ クライアント秘密鍵 ​の値をコピーします。

Munchkin アカウント ID

  1. 管理者 > Munchkin​に移動します。
  2. Munchkin アカウント ID​をコピーします。 形式はXXX-XXX-XXXで、インスタンス URLのプレフィックスと一致します。

AI ツールの設定

各AI ツールの設定は少しずつ異なります。 一般的なツールの接続例を示します。

TIP
複数のMarketo インスタンスに接続するには、MCP設定に一意の名前marketo-prodmarketo-stagingを持つ個別のエントリを追加し、それぞれに対応する資格情報を付けます。

Claude Desktop claude-desktop

Claude Desktopに接続するには、marketo-mcp-bridge.zipをダウンロードして解凍します。 marketo-mcp-bridge.mjsを既知の場所に配置して、次の手順で参照できるようにします。

また、次のようなものもあります。

  • Node.js v18+
  • npm
  1. Claude Desktopを開く
  2. 設定/開発者/設定を編集​に移動します
  3. 以下をclaude_desktop_config.jsonに追加します。
{
  "preferences": {
    ...
  },
  "mcpServers": {
    "marketo-mcp": {
      "command": "node",
      "args": ["/path/to/marketo-bridge/bridge.mjs"],
      "env": {
        "MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
        "MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
        "MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
      }
    }
  }
}
  1. Claude Desktopを再起動する

カーソル cursor

カーソル MCP設定に既に他のサーバーが含まれている場合は、mcpServersの下にmarketo エントリを追加します。
次の例は、プロジェクトディレクトリの​Settings > MCP​または.cursor/mcp.jsonの完全なmcpServers ブロックを示しています。

IMS トークン
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Marketo クライアント資格情報
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}

カーソルを再起動します。

Claude Code (CLI) claude-code

ターミナルで次のコマンドを実行し、資格情報を代入します。

IMS トークン
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "Authorization: Bearer YOUR-IMS-TOKEN" \
  --header "x-gw-ims-org-id: YOUR-IMS-ORG-ID"
Marketo クライアント資格情報
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
  --header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
  --header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"

OpenAI Codex codex

  1. 設定 / MCP サーバー/ サーバーの追加に移動します
  2. サーバーURLを追加:https://marketo-mcp.adobe.io/mcp
  3. 認証方法のヘッダーを追加します。
IMS トークン
  • Authorization: “Bearer YOUR-IMS-TOKEN”
  • x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
Marketo クライアント資格情報
  • X-Marketo-Client-Id: “YOUR-CLIENT-ID”
  • X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
  • X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
  1. 「保存」をクリックして、プロセスを完了します。

VS CodeとGitHub Copilot vscode

Ctrl+Shift+P (またはmacOSの​Cmd+Shift+P)を押し、MCP: Open User Configuration​と入力してEnter キーを押します。 mcp.jsonが開きます。 servers オブジェクト内のmarketo エントリを追加します。

IMS トークン
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
Marketo クライアント資格情報
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}
NOTE
セキュリティ上の理由から、資格情報を直接貼り付ける代わりに、環境変数の補間を設定ファイルで使用します。 ${MARKETO_CLIENT_SECRET}のような構文を使用して変数を参照し、環境に設定できます。 これにより、資格情報がバージョン管理ファイルのプレーンテキストに保存されるのを防ぎます。

他社製品 other-tools

Marketo MCP サーバーはAdobeによってホストされ、パブリック URLで公開されます。ストリーミング可能なHTTP トランスポート経由でリモートサーバーをサポートするMCP クライアントは、接続できます。
ツール固有のブリッジやローカルにインストールされたソフトウェアは必要ありません。お使いのツールが上記に記載されていない場合は、以下の接続の詳細を使用して手動で設定します。

接続の詳細:

設定
運輸
HTTP (ストリーミング可能なHTTP)
サーバーURL
https://marketo-mcp.adobe.io/mcp

認証ヘッダー:

リクエストごとに、次のいずれかの認証方法のヘッダーを送信します。 サーバーのURLとヘッダーを入力する場所は、ツールによって異なりますので、そのMCP ドキュメントを参照してください。

IMS トークン
table 0-row-2 1-row-2 2-row-2
ヘッダー
Authorization Bearer YOUR-IMS-TOKEN
x-gw-ims-org-id あなたのIMS組織ID
Marketo クライアント資格情報
table 0-row-2 1-row-2 2-row-2 3-row-2
ヘッダー
X-Marketo-Client-Id クライアント ID
X-Marketo-Client-Secret クライアント秘密鍵
X-Marketo-Munchkin-Id Munchkin アカウント ID

ツールがJSON設定を受け入れる場合は、​ カーソル ​またはVS コード ​の例から始め、ツールのスキーマに合わせてキー(mcpServersservers)を調整します。

使用可能な操作

接続が完了したら、AI アシスタントに次のカテゴリにわたる操作を実行するように依頼できます。 API参照でサポートされている操作の一覧については、​ サポートされているMCP操作を参照してください。

フォーム

フォームの参照、作成、複製、承認ができます。 フィールドの追加または削除、フィールドの表示ルールの設定、フォームの埋め込み先の特定を行います。

プロンプトの例:

  • 「承認済みのすべてのフォームを表示」
  • 「問い合わせフォームをQ2 キャンペーンフォルダーに複製」
  • 「デモリクエストフォームに会社フィールドを追加」

スマートキャンペーン

スマートキャンペーンの作成、スマートリストフィルターの設定、フローステップの追加、キャンペーンのアクティブ化または非アクティブ化を行うことができます。

プロンプトの例:

  • 「現在アクティブなスマートキャンペーンはどれですか?」
  • 「操作フォルダーのリードスコアリングアップデートと呼ばれる新しいスマートキャンペーンの作成」
  • 「ウェルカムメールキャンペーンのフローステップを表示する」

リードとリスト

メールアドレスでリードを検索し、リードレコードを作成または更新して、静的リストのメンバーシップを管理できます。

プロンプトの例:

  • 「電子メールでリードを探すjane@example.com」
  • 「第2四半期MQL リストにリード ID12345を追加」
  • 「サマーイベント参加者」という新しい静的リストの作成

プログラム

プログラムの作成、複製、タグ付けをおこなえます。 タイプ、チャネル、日付範囲ごとにプログラムを参照できます。

プロンプトの例:

  • 「Q4 ウェビナープログラムを2026年イベントフォルダーに複製」
  • 「Campaigns フォルダーのサマーセールという新しいメールプログラムを作成する」
  • 「ウェビナーとしてタグ付けされたすべてのプログラムを表示する」

メールとスニペット

メールの閲覧、テンプレートからのメール作成、コンテンツセクションの更新、再利用可能なスニペットの管理などをおこなえます。

プロンプトの例:

  • 「すべての下書きメールを表示」
  • 「ウェルカムメールのヘッダーセクションの更新」
  • 「どのようなアセットがホリデープロモーションスニペットを使用しますか?」

インスタンス構造

Marketoの設定を理解するには、フォルダー、チャネル、タグタイプ、アクティビティタイプを参照します。

プロンプトの例:

  • 「Marketoのすべてのフォルダーを一覧表示」
  • 「使用可能なすべてのチャネルを表示」
  • 「設定されているタグタイプは何ですか?」

一括操作

リードデータを一括エクスポートし、ジョブステータスのインポートまたはエクスポートをチェックします。

プロンプトの例:

  • 「過去30日間に作成されたリードの一括書き出しを作成」
  • 「書き出しジョブ xxのステータスを確認」

トラブルシューティング

エラー
原因
修正
「Marketo資格情報が提供されていません」
X-Marketo-Client-IdX-Marketo-Client-SecretまたはX-Marketo-Munchkin-Idのうち1つ以上が見つかりません。
すべてのMarketo クライアント資格情報ヘッダーが設定に存在することを確認します。
「401 Unauthorized」
資格情報が見つからないか、無効であるか、有効期限が切れています。 Marketo クライアント資格情報を使用すると、クライアント IDまたはクライアントシークレットが正しくありません。 IMS トークンを使用すると、トークンが無効または期限切れになります。
認証方法の資格情報を確認します。 クライアント資格情報については、管理者 > LaunchPoint​の​ クライアント ID ​と​ クライアントシークレット ​を再確認してください。 IMS トークンの場合は、新しいトークンを生成し、Authorization ヘッダーを更新します。
「403禁止」
資格情報は有効ですが、Marketo インスタンスでMCP アクセスが有効になっていません。
Munchkin アカウント IDのMCP アクセスを有効にするには、Marketo MCP管理者にお問い合わせください。
「リクエストが多すぎます」(レート制限)
短時間に送信したリクエストが多すぎるか、同時に送信したリクエストが多すぎるため、Marketo インスタンスのAPI制限に達しました。
一度に送信するリクエストの数と頻度を減らし、再試行するまでに少し待ちます。 専用のAPI ユーザーを使用して、割り当て量を追跡、管理します。
接続がタイムアウトしたか、拒否されました
MCP サーバーにネットワークからアクセスできません。
お使いの環境からサーバーのURLにアクセスできることを確認します。 該当する場合は、VPNの要件を確認します。
ツール呼び出しは空の結果を返します
API ユーザーには、リクエストされたアセットタイプに対する権限がありません。
Marketo管理者にAPI ユーザーの役割と権限の確認を依頼します。

セキュリティに関する検討事項

IMPORTANT
作業に必要な権限のみを持つMarketoの専用API ユーザーを使用してください。 API アクセスに管理者資格情報を再利用しないでください。
  • リクエストごとの資格情報。 クライアント ID、クライアントシークレット、Munchkin ID、およびREST API エンドポイントは、各リクエストでHTTP ヘッダーで送信されます。 サーバーはそれらを保存またはキャッシュしません。
  • マルチテナント分離。 各リクエストは、独自の資格情報セットを使用します。 このデータは、他のユーザーのセッションと相互作用しません。
  • Munchkin IDが許可リストに加えるしました。 サーバーは、承認済みのMarketo インスタンスに対するリクエストのみを受け付けます。 権限のないMunchkin IDを使用したリクエストは、403 エラーで拒否されます。
  • API レート制限。 MCP サーバーは、Marketo インスタンスのAPI レート制限を継承します。 専用のAPI ユーザーを使用して、クォータ消費を追跡、管理します。
  • 資格情報をバージョン管理から除外します。 AI ツールでサポートされている場合は、環境変数の補間(${MARKETO_CLIENT_SECRET})を使用します。そのため、資格情報はリポジトリーファイルのプレーンテキストに保存されません。
recommendation-more-help
marketo-developer-help