[ベータ版]{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とクライアント秘密鍵

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

Munchkin アカウント ID

  1. 管理者 > Munchkin​に移動します。
  2. 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 キーを押します。

NOTE
セキュリティ上の理由から、資格情報を直接貼り付ける代わりに、環境変数の補間を設定ファイルで使用します。 ${MARKETO_CLIENT_SECRET}のような構文を使用して変数を参照し、環境に設定できます。 これにより、バージョン管理にコミットされる可能性のあるファイルに、資格情報がプレーンテキストで保存されるのを防ぎます。

使用可能な操作

接続が完了したら、AI アシスタントに次のカテゴリにわたる操作を実行するように依頼できます。

フォーム

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

プロンプトの例:

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

スマートキャンペーン

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

プロンプトの例:

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

リードとリスト

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

プロンプトの例:

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

プログラム

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

プロンプトの例:

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

メールとスニペット

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

プロンプトの例:

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

インスタンス構造

フォルダー、チャネル、タグタイプおよびアクティビティタイプを参照して、Marketo設定を理解します。

プロンプトの例:

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

一括操作

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

プロンプトの例:

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

トラブルシューティング

エラー
原因
修正
「Marketo エンドポイントが提供されていません」
設定にX-Marketo-Endpoint ヘッダーがありません。
MCP設定を再確認し、4つのヘッダーがすべて存在することを確認します。
「Marketo資格情報が提供されていません」
X-Marketo-Client-IdX-Marketo-Client-SecretまたはX-Marketo-Munchkin-Idのうち1つ以上が見つかりません。
4つのヘッダーがすべて設定に存在することを確認します。
「認証エラー」
資格情報が無効または期限切れです。
Admin > LaunchPoint​でクライアント IDとクライアント シークレットを再確認します。
「403禁止」
Munchkin IDがサーバー許可リストにありません。
Munchkin IDを追加するには、Marketo MCP管理者にお問い合わせください。
接続がタイムアウトしたか、拒否されました
MCP サーバーにネットワークからアクセスできません。
お使いの環境からサーバーのURLにアクセスできることを確認します。 該当する場合は、VPNの要件を確認します。
ツール呼び出しは空の結果を返します
API ユーザーには、リクエストされたアセットタイプに対する権限がありません。
Marketo管理者にAPI ユーザーの役割と権限の確認を依頼します。

よくある質問

自分のデータは安全か?
認証情報は、個々のリクエストごとにHTTP ヘッダーで送信されます。 サーバーはセッション間で資格情報を保存またはキャッシュせず、各リクエストは完全に分離されます。
複数の人が同時に使用できますか?
はい。 サーバーはマルチテナントです。 各ユーザーは自分の資格情報に接続し、リクエストは互いに分離されます。
アクセストークンの有効期限が切れた場合はどうなりますか?
クライアント IDとクライアントシークレットを使用して認証を行うと、サーバーはトークンの更新を自動的に処理します。 アクションを起こす必要はありません。
何かをインストールまたは実行する必要がありますか?
いいえ、できません。 MCP サーバーはAdobeによってホストされます。 AI ツールを接続するために設定するだけです。
API ユーザーに必要なMarketo権限は何ですか?
API ユーザーは、管理するアセットタイプにアクセスする必要があります。 少なくとも、閲覧操作には読み取り専用の役割を割り当て、アセットの作成または変更には読み取り/書き込み役割を割り当てます。 Marketo管理者と協力して、適切な権限を割り当てます。
レートの制限は何ですか?
MCP サーバーは、Marketo インスタンスのAPI レート制限を継承します。 専用のAPI ユーザーを使用して、クォータ消費を追跡、管理します。
サポートされているAI ツールは何ですか?
Claude Desktop、Cursor、Claude Code (CLI)、VS CodeとGitHub Copilotの連携。 HTTP経由でモデルコンテキストプロトコルをサポートするすべてのAI ツールが機能する必要があります。
複数のMarketo インスタンスに接続できますか?
はい。 AI ツールのMCP設定に、それぞれ一意の名前と対応するインスタンスの資格情報を持つ複数のエントリを追加します。 例えば、marketo-prodmarketo-stagingを個別のサーバーとして設定できます。

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

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