Marketo Engage MCP サーバー
モデルコンテキストプロトコル(MCP)は、AI ツールを外部サービスに接続するオープンスタンダードです。 Marketo MCP サーバーは、AI アシスタントをMarketoに接続します。 アセット管理、リードデータ、キャンペーンの自動化など、あらゆる業務をサポートします。 例外と可用性の要件については、 サポートされているMCP操作を参照してください。
AI ツールがMCP サーバーを呼び出すと、サーバーはそのリクエストの資格情報を使用して、対応するREST API呼び出しを実行します。 サーバーサイドソフトウェアをインストール、デプロイ、または実行する必要はありません。
Marketo AIとMarketo Engage MCP サーバーでのデータの処理方法について詳しくは、Data Information ページを参照してください。
MCP クライアントまたはサーバーをAdobe製品に接続することは、お客様が選択した設定であり、お客様はMCP統合のセキュリティと適合性を評価する責任があります。 アドビは、設定ミス、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資格情報を作成するための管理者アクセス
- 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 ツールの設定
ツールによって設定が少し異なります。 この節では、一般的なツールの接続例を示します。
marketo-prodとmarketo-stagingを持つ個別のエントリを追加し、それぞれに対応する資格情報を付けます。Claude Desktop claude-desktop
Claude Desktopに接続するには、marketo-mcp-bridge.zipをダウンロードして解凍します。 marketo-mcp-bridge.mjsを既知の場所に配置し、以下の設定でその絶対パスを使用します。
また、サポートされているLTS バージョンのNode.jsがコンピューターにインストールされている必要があります。 ブリッジには追加のnpm パッケージは必要ありません。
- Claude Desktopを開きます。
claude_desktop_config.jsonを開きます。 MacOSでは、ファイルは~/Library/Application Support/Claude/にあります。 Windowsでは、%APPDATA%\Claude\にあります。 開発者設定メニューのバージョンで、設定 > 開発者 > 設定を編集を選択して開きます。- 次のエントリを
mcpServersの下に追加し、既存の設定を保持します。 パスと資格情報のプレースホルダーを値に置き換えます。
| code language-json |
|---|
|
- Claude Desktopを再起動します。
Claude DesktopでNode.jsが見つからない場合は、commandのnodeをNode.js実行可能ファイルへの絶対パスに置き換えます。 詳しくは、 ローカル MCP サーバーへの接続を参照してください。
カーソル cursor
ユーザーアカウントの~/.cursor/mcp.jsonのmcpServersまたはプロジェクトディレクトリの.cursor/mcp.jsonのmarketo エントリを追加します。 既存のサーバーを保持し、資格情報のプレースホルダーを値に置き換えます。
| code language-json |
|---|
|
カーソルで カスタマイズ を開き、サーバーがオンになっていることを確認します。 詳しくは、 カーソル MCP設定を参照してください。
Claude Code (CLI) claude-code
ターミナルで次のコマンドを実行し、資格情報を代入します。
| code language-bash |
|---|
|
このコマンドは、現在のプロジェクトのサーバーとユーザーアカウントを追加します。 プロジェクト全体で使用できるようにするには、--scope userを追加します。 Claude Codeで、/mcpを実行して接続を確認します。 詳しくは、Claude Code MCP configurationを参照してください。
OpenAI Codex codex
次の項目を~/.codex/config.tomlに追加し、既存の設定を保持します。
| code language-toml |
|---|
|
Codexを実行するプロセスの環境でMARKETO_CLIENT_ID、MARKETO_CLIENT_SECRETおよびMARKETO_MUNCHKIN_IDを設定します。 env_http_headersの値は環境変数名で、資格情報ではありません。
新しいCodex セッションを開始し、/mcpを実行して接続を確認します。 詳しくは、Codex MCP設定を参照してください。
Gemini CLI
Gemini CLIにMarketo Engage MCP サーバーを追加するには、次のmcpServers エントリをプロジェクトディレクトリの.gemini/settings.jsonに追加するか、ユーザーアカウントの~/.gemini/settings.jsonに追加します。 既存の設定を保持し、資格情報のプレースホルダーを値に置き換えます。
| code language-json |
|---|
|
または、シェル環境でMARKETO_CLIENT_ID、MARKETO_CLIENT_SECRET、MARKETO_MUNCHKIN_IDを設定し、次のコマンドを実行します。 シェルは、CLIがユーザー設定にヘッダー値を保存する前に変数を展開します。
| code language-bash |
|---|
|
セッションを再起動し、/mcpを実行して接続を確認します。 詳しくは、Gemini CLI MCP設定を参照してください。
VS CodeとGitHub Copilot vscode
最新バージョンのVS Codeには、ポータブルコパイロット設定を使用します。 ~/.copilot/mcp-config.jsonのmcpServersの下に次のエントリを追加するか、COPILOT_HOMEを設定した場合は$COPILOT_HOME/mcp-config.jsonを追加します。 既存のサーバーを保存します。
| code language-json |
|---|
|
VS Codeを実行する環境またはサーバーに接続するリモートホストで3つの環境変数を設定します。 新しいCopilot セッションを開始し、サーバーの信頼プロンプトを確認します。
代わりにガイド付き設定を使用するには、MCP: Add Serverを実行し、HTTP (HTTPまたはServer-Sent Events)を選択し、サーバーURLを入力して、Global > Copilot Globalを選択します。 次に、保存した設定にヘッダーを追加します。
古いバージョンでは、MCP: Open User Configurationまたは.vscode/mcp.jsonもサポートされています。 これらのファイルでは、環境変数にmcpServersおよび${env:MARKETO_CLIENT_ID}構文ではなくserversを使用します。 2つの形式を混在させないでください。 詳細については、VS Code MCP設定を参照してください。
Copilot Studio
MCP ツールを追加する前に、エージェントの生成オーケストレーションをオンにします。 カスタムコネクタを使用して、必要な3つのMarketo ヘッダーをすべて定義します。
エージェントのツール ページで、ツールの追加 > 新しいツール > カスタムコネクタを選択します。 Power Appsで、カスタムコネクタを作成し、Swagger エディターを使用して次の定義を入力します。
| code language-yaml |
|---|
|
コネクタを保存または更新し、Copilot Studioに戻ってエージェントに追加します。 接続を作成し、プロンプトが表示されたら3つのヘッダー値を入力します。 資格情報をOpenAPI定義およびエージェントの命令から除外します。 詳しくは、既存のMCP サーバーへのエージェントの接続を参照してください。
Glean glean
GleanをMarketo Engage MCP サーバーに接続するには、Gleanのリモート MCP設定手順に従ってhttps://marketo-mcp.adobe.io/mcpを追加します。 最初にコネクタ カタログを確認してください。 カスタムサーバーまたは非公開サーバーの場合は、Admin Console > Platform > ツール > MCP サーバーからツールを読み込むを使用します。
Glean サポートチームは、以下のカスタムヘッダーを設定する必要があります。 サポートリクエストにサーバー名、URL、必要なヘッダー名を含め、資格情報の値の安全な処理を調整します。 標準のAPI キー接続だけでは、3つのヘッダーすべてを提供することはできません。
| 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 |
Gleanがヘッダーがアクティブであることを確認したら、他のユーザーがツールを使用できるようにする前に、読み取り専用リクエストで接続をテストします。
他社製品 other-tools
AdobeはMarketo MCP サーバーをホストし、パブリック URLで公開します。 ストリーミング可能なHTTP トランスポート経由でリモートサーバーをサポートするMCP クライアントは、接続できます。
直接リモート HTTP接続をサポートするクライアントには、ブリッジやローカルにインストールされたサーバーソフトウェアは必要ありません。 お使いのツールが上記に記載されていない場合は、以下の接続の詳細を使用して手動で設定します。
接続の詳細:
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| 設定 | 値 |
| 運輸 | HTTP (ストリーミング可能なHTTP) |
| サーバーURL | https://marketo-mcp.adobe.io/mcp |
認証ヘッダー:
各リクエストで3つのヘッダーをすべて送信します。 サーバーのURLとヘッダーを入力する場所は、ツールによって異なりますので、そのMCP ドキュメントを参照してください。
| 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 コード の例から始め、ツールのスキーマに合わせてキーと環境変数の構文を調整します。
接続後、AI アシスタントにMarketo MCP サーバーを使用して、データを変更することなく利用可能なチャネルを一覧表示するように依頼します。 ツール呼び出しとその応答を調べて、リクエストが意図したサーバーを使用し、接続または認証エラーなしでデータを返すことを確認します。
使用可能な操作
接続が完了したら、AI アシスタントに次のカテゴリにわたる操作を実行するように依頼できます。 例外と可用性の要件については、 サポートされている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 ユーザー設定から継承されます。
- 監査とオブザーバビリティ:セキュリティログ、マスキング、モニタリング、アラート機能が有効になっており、調査、サービスの健全性の追跡、運用上の監視に対応できます。