[限定提供]{class="badge informative" title="この機能は、現在、限定ベータ版リリース中です"}
Marketo Engage MCP サーバー
モデルコンテキストプロトコル(MCP)は、AI ツールが外部サービスと通信できるようにするオープンスタンダードです。 Marketo MCP サーバーは、AI アシスタントとMarketoの間のブリッジとして機能します。 フォーム、プログラム、スマートキャンペーン、リード、メール、スニペット、リスト、フォルダーなど、100以上の業務を網羅しています。
AI ツールがMCP サーバーを呼び出すと、サーバーは各リクエストで指定した資格情報を使用して、対応するREST API呼び出しを代わりに実行します。 サーバーサイドソフトウェアをインストールしたり、デプロイしたり、実行したりする必要はありません。
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とクライアント秘密鍵
- 管理者 > LaunchPointに移動します。
- API サービスを選択します。 お持ちでない場合は、New > New Serviceを選択し、サービスタイプとして Custom を選択して、専用のAPI ユーザーを割り当てます。
- 詳細を表示を選択し、クライアント IDおよび クライアント秘密鍵 の値をコピーします。
Munchkin アカウント ID
- 管理者 > Munchkinに移動します。
- Munchkin アカウント IDをコピーします。 形式は
XXX-XXX-XXXで、インスタンス URLのプレフィックスと一致します。
AI ツールの設定
各AI ツールの設定は少しずつ異なります。 一般的なツールの接続例を示します。
marketo-prodとmarketo-stagingを持つ個別のエントリを追加し、それぞれに対応する資格情報を付けます。Claude Desktop claude-desktop
Claude Desktopに接続するには、marketo-mcp-bridge.zipをダウンロードして解凍します。 marketo-mcp-bridge.mjsを既知の場所に配置して、次の手順で参照できるようにします。
また、次のようなものもあります。
- Node.js v18+
- npm
- Claude Desktopを開く
- 設定/開発者/設定を編集に移動します
- 以下を
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>"
}
}
}
}
- Claude Desktopを再起動する
カーソル cursor
カーソル MCP設定に既に他のサーバーが含まれている場合は、mcpServersの下にmarketo エントリを追加します。
次の例は、プロジェクトディレクトリのSettings > MCPまたは.cursor/mcp.jsonの完全なmcpServers ブロックを示しています。
| code language-json |
|---|
|
| code language-json |
|---|
|
カーソルを再起動します。
Claude Code (CLI) claude-code
ターミナルで次のコマンドを実行し、資格情報を代入します。
| code language-bash |
|---|
|
| code language-bash |
|---|
|
OpenAI Codex codex
- 設定 / MCP サーバー/ サーバーの追加に移動します
- サーバーURLを追加:
https://marketo-mcp.adobe.io/mcp - 認証方法のヘッダーを追加します。
- Authorization: “Bearer YOUR-IMS-TOKEN”
- x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
- X-Marketo-Client-Id: “YOUR-CLIENT-ID”
- X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
- X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
- 「保存」をクリックして、プロセスを完了します。
VS CodeとGitHub Copilot vscode
Ctrl+Shift+P (またはmacOSのCmd+Shift+P)を押し、MCP: Open User Configurationと入力してEnter キーを押します。 mcp.jsonが開きます。 servers オブジェクト内のmarketo エントリを追加します。
| code language-json |
|---|
|
| code language-json |
|---|
|
${MARKETO_CLIENT_SECRET}のような構文を使用して変数を参照し、環境に設定できます。 これにより、資格情報がバージョン管理ファイルのプレーンテキストに保存されるのを防ぎます。他社製品 other-tools
Marketo MCP サーバーはAdobeによってホストされ、パブリック URLで公開されます。ストリーミング可能なHTTP トランスポート経由でリモートサーバーをサポートするMCP クライアントは、接続できます。
ツール固有のブリッジやローカルにインストールされたソフトウェアは必要ありません。お使いのツールが上記に記載されていない場合は、以下の接続の詳細を使用して手動で設定します。
接続の詳細:
https://marketo-mcp.adobe.io/mcp認証ヘッダー:
リクエストごとに、次のいずれかの認証方法のヘッダーを送信します。 サーバーのURLとヘッダーを入力する場所は、ツールによって異なりますので、そのMCP ドキュメントを参照してください。
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| ヘッダー | 値 |
Authorization |
Bearer YOUR-IMS-TOKEN |
x-gw-ims-org-id |
あなたのIMS組織ID |
| 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 コード の例から始め、ツールのスキーマに合わせてキー(mcpServers、servers)を調整します。
使用可能な操作
接続が完了したら、AI アシスタントに次のカテゴリにわたる操作を実行するように依頼できます。 API参照でサポートされている操作の一覧については、 サポートされているMCP操作を参照してください。
フォーム
フォームの参照、作成、複製、承認ができます。 フィールドの追加または削除、フィールドの表示ルールの設定、フォームの埋め込み先の特定を行います。
プロンプトの例:
- 「承認済みのすべてのフォームを表示」
- 「問い合わせフォームをQ2 キャンペーンフォルダーに複製」
- 「デモリクエストフォームに会社フィールドを追加」
スマートキャンペーン
スマートキャンペーンの作成、スマートリストフィルターの設定、フローステップの追加、キャンペーンのアクティブ化または非アクティブ化を行うことができます。
プロンプトの例:
- 「現在アクティブなスマートキャンペーンはどれですか?」
- 「操作フォルダーのリードスコアリングアップデートと呼ばれる新しいスマートキャンペーンの作成」
- 「ウェルカムメールキャンペーンのフローステップを表示する」
リードとリスト
メールアドレスでリードを検索し、リードレコードを作成または更新して、静的リストのメンバーシップを管理できます。
プロンプトの例:
- 「電子メールでリードを探すjane@example.com」
- 「第2四半期MQL リストにリード ID12345を追加」
- 「サマーイベント参加者」という新しい静的リストの作成
プログラム
プログラムの作成、複製、タグ付けをおこなえます。 タイプ、チャネル、日付範囲ごとにプログラムを参照できます。
プロンプトの例:
- 「Q4 ウェビナープログラムを2026年イベントフォルダーに複製」
- 「Campaigns フォルダーのサマーセールという新しいメールプログラムを作成する」
- 「ウェビナーとしてタグ付けされたすべてのプログラムを表示する」
メールとスニペット
メールの閲覧、テンプレートからのメール作成、コンテンツセクションの更新、再利用可能なスニペットの管理などをおこなえます。
プロンプトの例:
- 「すべての下書きメールを表示」
- 「ウェルカムメールのヘッダーセクションの更新」
- 「どのようなアセットがホリデープロモーションスニペットを使用しますか?」
インスタンス構造
Marketoの設定を理解するには、フォルダー、チャネル、タグタイプ、アクティビティタイプを参照します。
プロンプトの例:
- 「Marketoのすべてのフォルダーを一覧表示」
- 「使用可能なすべてのチャネルを表示」
- 「設定されているタグタイプは何ですか?」
一括操作
リードデータを一括エクスポートし、ジョブステータスのインポートまたはエクスポートをチェックします。
プロンプトの例:
- 「過去30日間に作成されたリードの一括書き出しを作成」
- 「書き出しジョブ xxのステータスを確認」
トラブルシューティング
X-Marketo-Client-Id、X-Marketo-Client-SecretまたはX-Marketo-Munchkin-Idのうち1つ以上が見つかりません。Authorization ヘッダーを更新します。セキュリティに関する検討事項
- リクエストごとの資格情報。 クライアント ID、クライアントシークレット、Munchkin ID、およびREST API エンドポイントは、各リクエストでHTTP ヘッダーで送信されます。 サーバーはそれらを保存またはキャッシュしません。
- マルチテナント分離。 各リクエストは、独自の資格情報セットを使用します。 このデータは、他のユーザーのセッションと相互作用しません。
- Munchkin IDが許可リストに加えるしました。 サーバーは、承認済みのMarketo インスタンスに対するリクエストのみを受け付けます。 権限のないMunchkin IDを使用したリクエストは、403 エラーで拒否されます。
- API レート制限。 MCP サーバーは、Marketo インスタンスのAPI レート制限を継承します。 専用のAPI ユーザーを使用して、クォータ消費を追跡、管理します。
- 資格情報をバージョン管理から除外します。 AI ツールでサポートされている場合は、環境変数の補間(
${MARKETO_CLIENT_SECRET})を使用します。そのため、資格情報はリポジトリーファイルのプレーンテキストに保存されません。