[ベータ版]{class="badge informative" title="この機能は現在、早期ベータリリースです"}
Marketo MCP サーバー
モデルコンテキストプロトコル(MCP)は、AI ツールが外部サービスと通信できるようにするオープンスタンダードです。 Marketo MCP サーバーは、AI アシスタントとMarketoの間のブリッジとして機能します。 フォーム、プログラム、スマートキャンペーン、リード、メール、スニペット、リスト、フォルダーなど、100以上の業務を網羅しています。
AI ツールがMCP サーバーを呼び出すと、サーバーは各リクエストで指定した資格情報を使用して、対応するREST API呼び出しを代わりに実行します。 サーバーサイドソフトウェアをインストールしたり、デプロイしたり、実行したりする必要はありません。
前提条件
- REST API アクセスが有効になっているMarketo インスタンス
- Marketo LaunchPointでAPI資格情報を作成するための管理者アクセス
- 次のいずれかのAI ツール:Claude Desktop、Cursor、Claude Code (CLI)、またはVS Code with GitHub Copilot
- 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 ツールは、異なる場所からMCP サーバー設定を読み取ります。 以下のツールを見つけ、手順に従ってMarketo MCP サーバーを追加します。
Claude Desktop
設定ファイルはclaude_desktop_config.jsonです。 次のいずれかの場所から開きます。
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
ファイルに他のMCP サーバーが既に含まれている場合は、mcpServersの下にmarketo エントリを追加します。 次の例は、完全なmcpServers ブロックを示しています。
{
"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 Desktopを終了して再度開きます。
カーソル
カーソル MCP設定に既に他のサーバーが含まれている場合は、mcpServersの下にmarketo エントリを追加します。 次の例は、プロジェクトディレクトリのSettings > MCPまたは.cursor/mcp.jsonの完全なmcpServers ブロックを示しています。
{
"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 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"
VS CodeとGitHub Copilot
MacOSで Ctrl+Shift+P または Cmd+Shift+P を押し、Preferences: Open User Settings (JSON)を選択して、VS Code settings.jsonを開きます。 次の例を追加します。
{
"mcp": {
"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"
}
}
}
}
}
Ctrl+Shift+P (またはmacOSのCmd+Shift+P)を押し、ウィンドウをリロードと入力してEnter キーを押します。
${MARKETO_CLIENT_SECRET}のような構文を使用して変数を参照し、環境に設定できます。 これにより、バージョン管理にコミットされる可能性のあるファイルに、資格情報がプレーンテキストで保存されるのを防ぎます。使用可能な操作
接続が完了したら、AI アシスタントに次のカテゴリにわたる操作を実行するように依頼できます。
フォーム
フォームの参照、作成、複製、承認ができます。 フィールドの追加または削除、フィールドの表示ルールの設定、フォームの埋め込み先の特定を行います。
プロンプトの例:
- 「承認済みのすべてのフォームを表示」
- 「問い合わせフォームをQ2 キャンペーンフォルダーに複製」
- 「デモリクエストフォームに会社フィールドを追加」
スマートキャンペーン
スマートキャンペーンの作成、スマートリストフィルターの設定、フローステップの追加、キャンペーンのアクティブ化または非アクティブ化を行うことができます。
プロンプトの例:
- 「現在アクティブなスマートキャンペーンはどれですか?」
- 「操作フォルダーのリードスコアリングアップデートと呼ばれる新しいスマートキャンペーンの作成」
- 「ウェルカムメールキャンペーンのフローステップを表示する」
リードとリスト
メールアドレスでリードを検索し、リードレコードを作成または更新して、静的リストのメンバーシップを管理できます。
プロンプトの例:
- 「電子メールでリードを探すjane@example.com」
- 「第2四半期MQL リストにリード ID12345を追加」
- 「サマーイベント参加者」という新しい静的リストの作成
プログラム
プログラムの作成、複製、タグ付けをおこなえます。 タイプ、チャネル、日付範囲ごとにプログラムを参照できます。
プロンプトの例:
- 「Q4 ウェビナープログラムを2026年イベントフォルダーに複製」
- 「Campaigns フォルダーのサマーセールという新しいメールプログラムを作成する」
- 「ウェビナーとしてタグ付けされたすべてのプログラムを表示する」
メールとスニペット
メールの閲覧、テンプレートからのメール作成、コンテンツセクションの更新、再利用可能なスニペットの管理などをおこなえます。
プロンプトの例:
- 「すべての下書きメールを表示」
- 「ウェルカムメールのヘッダーセクションの更新」
- 「どのようなアセットがホリデープロモーションスニペットを使用しますか?」
インスタンス構造
フォルダー、チャネル、タグタイプおよびアクティビティタイプを参照して、Marketo設定を理解します。
プロンプトの例:
- 「Marketoのすべてのフォルダーを一覧表示」
- 「使用可能なすべてのチャネルを表示」
- 「設定されているタグタイプは何ですか?」
一括操作
リードデータを一括エクスポートし、ジョブステータスのインポートまたはエクスポートをチェックします。
プロンプトの例:
- 「過去30日間に作成されたリードの一括書き出しを作成」
- 「書き出しジョブ xxのステータスを確認」
トラブルシューティング
X-Marketo-Endpoint ヘッダーがありません。X-Marketo-Client-Id、X-Marketo-Client-SecretまたはX-Marketo-Munchkin-Idのうち1つ以上が見つかりません。よくある質問
marketo-prodとmarketo-stagingを個別のサーバーとして設定できます。セキュリティに関する検討事項
- リクエストごとの資格情報。 クライアント ID、クライアントシークレット、Munchkin ID、およびREST API エンドポイントは、各リクエストでHTTP ヘッダーで送信されます。 サーバーはそれらを保存またはキャッシュしません。
- マルチテナント分離。 各リクエストは、独自の資格情報セットを使用します。 このデータは、他のユーザーのセッションと相互作用しません。
- Munchkin IDが許可リストに加えるしました。 サーバーは、承認済みのMarketo インスタンスに対するリクエストのみを受け付けます。 権限のないMunchkin IDを使用したリクエストは、403 エラーで拒否されます。
- 資格情報をバージョン管理から除外します。 AI ツールでサポートされている場合は、環境変数の補間(
${MARKETO_CLIENT_SECRET})を使用します。そのため、資格情報はリポジトリにコミットされたファイル内のプレーンテキストに保存されません。