Marketo MCP サーバー

Adobe Marketo Engage 用の Model Context Protocol サーバーです。 Claude Desktop、Cursor、その他の MCP 対応クライアントから Marketo REST API への直接的かつ認証されたアクセスを提供します。自然言語を使用して、フォーム、スマートリスト、チャネル、リード、アクティビティ、リストの読み書きが可能です。

目的

マーケティング運用、グロース、RevOps チームは、フォームの複製、アセットの承認、リードの検索、スマートリストの監査などのために、Marketo UI を何時間もクリックして操作しています。Marketo MCP サーバーは、それらの REST API 操作を LLM エージェントに接続するため、以下のように指示できます：

• 「フォーム 1234 を Q2 Webinars フォルダに複製して承認して。」

• 「alex@example.com の最近のアクティビティを表示して。」

• 「'Lifecycle Nurture' という新しいメールチャネルを作成して。」

…すると、モデルがあなたに代わって実際の Marketo API 呼び出しを実行します。

Related MCP server: Dynamic Form MCP

目次

• 機能

• クイックスタート

• 前提条件

• 設定

• 利用可能なツール

• Claude Desktop での使用

• Cursor / その他の MCP クライアントでの使用

• トラブルシューティング

• 開発

• 貢献

機能

• フォーム管理 — Marketo Asset API を介したフォームのリスト表示、検査、複製、承認

• スマートリスト操作 — スマートリストのリスト表示と検査

• チャネル CRUD — チャネルの作成、読み取り、更新、削除

• リードデータベース — ID またはメールアドレスによるリードの取得、リードの一括作成または更新、リードの削除

• アクティビティと変更ログ — リードのアクティビティとフィールド変更の取得

• リストメンバーシップ — 静的リストへのリードの追加または削除

• プログラム管理 — プログラムのリスト表示、検査、複製、およびプログラムメンバーの取得

• メール操作 — QA 用のメールのリスト表示、検査、サンプルメールの送信

• 自動認証 — トークンのキャッシュと更新を行う OAuth 2.0 クライアント資格情報フロー

• Stdio トランスポート — Claude Desktop、Cursor、および stdio をサポートするあらゆる MCP クライアントでそのまま動作

クイックスタート

オプション A — Smithery (推奨)

npx -y @smithery/cli install @alexleventer/marketo-mcp --client claude

プロンプトに従って、Marketo のベース URL、クライアント ID、クライアントシークレットを入力してください。

オプション B — npx (インストール不要)

MCP クライアントの設定 (例: claude_desktop_config.json) に以下を追加します：

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": {
        "MARKETO_BASE_URL": "https://123-ABC-456.mktorest.com/rest",
        "MARKETO_CLIENT_ID": "your-client-id",
        "MARKETO_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

オプション C — ソースからビルド

git clone https://github.com/alexleventer/marketo-mcp.git
cd marketo-mcp
npm install
npm run build

ビルドによって出力された設定ブロックを MCP クライアントにコピーしてください。

前提条件

• Node.js 18 以上

• Marketo API 資格情報 (LaunchPoint サービスからのクライアント ID とクライアントシークレット)

• REST API アクセスが有効な Marketo インスタンス

• MCP 対応クライアント — Claude Desktop、Cursor、Cline など

Marketo API 資格情報の取得

1. Marketo 管理画面にログイン

2. 管理 → インテグレーション → LaunchPoint

3. 新規 → 新規サービス、サービスタイプを カスタム に設定し、表示名を選択 (例: MCP Server)

4. 必要な権限 (読み取り専用アセット、読み取り/書き込みリードなど) を持つ API 専用ユーザーを割り当て

5. クライアント ID と クライアントシークレット を保存

6. ベース URL は 管理 → インテグレーション → Web サービス → REST API エンドポイントにあります (/rest/v1/* を取り除き、https://<munchkin>.mktorest.com/rest の部分のみを使用)

設定

すべての設定は環境変数を通じて行います：

ローカル開発用に .env.example を .env にコピーしてください。

利用可能なツール

各ツールは zod で検証された型付き引数を受け取り、生の Marketo JSON レスポンスを返します。フィールドレベルの詳細については、Adobe Marketo REST API リファレンスを参照してください。

Claude Desktop での使用

1. Claude Desktop をインストール

2. ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) の設定を開く

3. クイックスタート から mcpServers ブロックを貼り付け

4. Claude Desktop を再起動

Cursor / その他の MCP クライアントでの使用

stdio サーバーをサポートするあらゆる MCP クライアントが動作します。ビルドされたバイナリを指定してください：

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": { "MARKETO_BASE_URL": "...", "MARKETO_CLIENT_ID": "...", "MARKETO_CLIENT_SECRET": "..." }
    }
  }
}

レート制限

Marketo はいくつかの API レート制限を設けています。バッチ操作を実行する際はこれらに留意してください：

606 Max rate limit reached が発生した場合は、20 秒待ってから再試行してください。Marketo REST API は、場合によって Retry-After ヘッダーを返します。

トラブルシューティング

MCP インスペクターを使用して、ツール呼び出しをローカルで検査できます：

npm run inspector

開発

src/
├── index.ts       # MCP server + all tool registrations
├── auth.ts        # OAuth token manager (caches until expiry)
└── constants.ts   # Env var bindings

npm run dev          # Run with ts-node + .env
npm run typecheck    # Type-check without emit
npm run lint         # ESLint
npm run format       # Prettier
npm run build        # Compile to build/

貢献

問題やプルリクエストは github.com/alexleventer/marketo-mcp で歓迎します。

1. リポジトリをフォーク

2. フィーチャーブランチを作成

3. npm run lint && npm run typecheck を実行

4. PR をオープン

ライセンス

ISC — LICENSE を参照してください。

キーワード: marketo mcp server, marketo model context protocol, marketo claude, marketo ai, adobe marketo mcp, marketo api claude desktop, marketo automation llm, marketo engage mcp