[限定提供]{class="badge informative" title="この機能は、現在、限定ベータ版リリース中です"}
Marketo Engage MCP サーバー
モデルコンテキストプロトコル(MCP)は、AI ツールを外部サービスに接続するオープンスタンダードです。 Marketo MCP サーバーは、AI アシスタントをMarketoに接続します。 フォーム、プログラム、スマートキャンペーン、リード、メール、スニペット、リスト、フォルダーなど、100以上の処理を実行できます。
AI ツールがMCP サーバーを呼び出すと、サーバーはそのリクエストの資格情報を使用して、対応するREST API呼び出しを実行します。 サーバーサイドソフトウェアをインストール、デプロイ、または実行する必要はありません。
Marketo AIとMarketo Engage MCP サーバーでのデータの処理方法について詳しくは、Data Information ページを参照してください。
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}のような構文を使用して変数を参照し、環境に設定できます。 これにより、バージョン管理ファイルに資格情報をプレーンテキストで保存できなくなります。Glean glean
GleanをMarketo Engage MCP Serverに接続するには、Glean サポートチーム が次のカスタムヘッダーを設定する必要があります。
X-Marketo-Client-IdX-Marketo-Client-SecretX-Marketo-Munchkin-Id他社製品 other-tools
AdobeはMarketo MCP サーバーをホストし、パブリック 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})を使用します。そのため、資格情報はリポジトリーファイルのプレーンテキストに保存されません。
ガバナンスとデータ保持
資格情報の処理
- 顧客資格情報はサーバーサイドで永続化されず、リクエストごとにクライアントから提供されるため、サービス内での資格情報公開を制限するのに役立ちます。
API インタラクションモデル
- エージェントの使用:エージェントは、サポートされているMarketo APIを呼び出すためにMCP Serverを使用できます。
- 認証モデルの調整:サービスは、Marketo APIに関して文書化されているのと同じ外部API認証モデルを使用します。
認証と認証
- 最小権限:効果的な権限は、お客様のLaunchPoint サービスに割り当てられたMarketo APIのみのユーザーから継承され、お客様のMarketo設定内で最小権限の管理が可能になります。
- サーバーサイドトークンの永続性なし:サービスは、引き続き、顧客資格情報またはトークンのサーバーサイドの保存を回避します。
ログと監視
- セキュリティログ:構造化されたJSON ログは、コンプライアンス要件をサポートする機密データマスキングと追加のフィルタリングを使用して、Fluent Bitを介してSplunkにルーティングされます。
- 監査サポート:これらの制御は、サービスの可用性、セキュリティ関連イベント、運用品質の継続的な監視をサポートします。
- サーバーサイドの秘密鍵ストレージなし:お客様の資格情報はMCP デプロイメントによって保存されないため、リクエストごとにクライアントから提供する必要があります。
- トークンの処理:アクセストークンは短期間有効で、トークン応答はストアなしでマークされ、トークンはクエリ文字列送信ではなく標準的な認証メカニズムを通じて受け入れられます。
- ロールベースの運用アクセス:管理デプロイメントアクセスは、Adobe インフラストラクチャのロールとグループベースの制御によって管理されますが、データプレーンの権限はお客様のMarketo API ユーザー設定から継承されます。
- 監査とオブザーバビリティ:セキュリティログ、マスキング、モニタリング、アラート機能が有効になっており、調査、サービスの健全性の追跡、運用上の監視に対応できます。