Marketo MCP Server

Сервер Model Context Protocol для Adobe Marketo Engage. Предоставьте Claude Desktop, Cursor и другим MCP-совместимым клиентам прямой аутентифицированный доступ к REST API Marketo — читайте и изменяйте формы, смарт-списки, каналы, лиды, активности и списки с помощью естественного языка.

Зачем это нужно

Команды маркетинговых операций, роста и RevOps тратят часы на клики по интерфейсу Marketo, чтобы клонировать форму, утвердить активы, найти лид или проверить смарт-список. Marketo MCP Server подключает те же операции REST API к LLM-агенту, чтобы вы могли сказать:

• "Клонируй форму 1234 в папку Q2 Webinars и утверди её."

• "Покажи мне недавние активности для лида alex@example.com."

• "Создай новый email-канал под названием 'Lifecycle Nurture'."

…и модель выполнит реальные вызовы API Marketo от вашего имени.

Related MCP server: Dynamic Form MCP

Содержание

• Возможности

• Быстрый старт

• Предварительные требования

• Конфигурация

• Доступные инструменты

• Использование с Claude Desktop

• Использование с Cursor / другими MCP-клиентами

• Устранение неполадок

• Разработка

• Вклад в проект

Возможности

• Управление формами — перечисление, просмотр, клонирование и утверждение форм через Asset API Marketo

• Операции со смарт-списками — перечисление и просмотр смарт-списков

• CRUD каналов — создание, чтение, обновление и удаление каналов

• База данных лидов — получение лидов по ID или email, массовое создание или обновление лидов, удаление лидов

• Журналы активностей и изменений — получение активностей и истории изменений полей для любого лида

• Членство в списках — добавление или удаление лидов из статических списков

• Управление программами — перечисление, просмотр, клонирование программ и получение участников программ

• Email-операции — перечисление, просмотр и отправка тестовых писем для контроля качества

• Автоматическая аутентификация — поток OAuth 2.0 client-credentials с кэшированием и обновлением токенов

• Транспорт Stdio — работает «из коробки» с Claude Desktop, Cursor и любым MCP-клиентом, поддерживающим stdio

Быстрый старт

Вариант А — Smithery (рекомендуется)

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

Следуйте инструкциям, чтобы вставить базовый URL Marketo, ID клиента и секрет клиента.

Вариант Б — 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"
      }
    }
  }
}

Вариант В — из исходного кода

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

Скопируйте блок конфигурации, выведенный при сборке, в ваш MCP-клиент.

Предварительные требования

• Node.js 18 или выше

• Учетные данные API Marketo (ID клиента и секрет клиента из службы LaunchPoint)

• Экземпляр Marketo с включенным доступом к REST API

• MCP-совместимый клиент — Claude Desktop, Cursor, Cline или любой другой

Получение учетных данных API Marketo

1. Войдите в панель администратора Marketo

2. Admin → Integration → LaunchPoint

3. New → New Service, установите тип службы на Custom и выберите отображаемое имя (например, MCP Server)

4. Назначьте пользователя только для API с необходимыми разрешениями (Read-Only Assets, Read-Write Lead и т.д.)

5. Сохраните Client ID и Client Secret

6. Ваш базовый URL находится в разделе Admin → Integration → Web Services → REST API Endpoint (удалите /rest/v1/* — оставьте только https://<munchkin>.mktorest.com/rest)

Конфигурация

Вся конфигурация осуществляется через переменные окружения:

Скопируйте .env.example в .env для локальной разработки.

Доступные инструменты

Каждый инструмент принимает типизированные аргументы, проверяемые с помощью zod, и возвращает необработанный JSON-ответ Marketo. См. справочник 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-клиентами

Любой MCP-клиент, поддерживающий stdio-серверы, будет работать. Укажите путь к собранному бинарному файлу:

{
  "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 секунд перед повторной попыткой. REST API Marketo в некоторых случаях возвращает заголовок 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