Сервер Marketo MCP

Сервер Model Context Protocol для взаимодействия с API Marketo. Этот сервер предоставляет инструменты для управления формами Marketo, включая листинг, клонирование и утверждение форм.

Предпосылки

Node.js (v14 или выше)
Учетные данные API Marketo (идентификатор клиента и секретный код клиента)
Экземпляр Marketo с включенным доступом API
Установлен Claude Desktop

Начиная

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

Войдите в свою панель администратора Marketo.
Перейдите в Администрирование > Интеграция > LaunchPoint.
Нажмите «Новый» > «Новая услуга».
Заполните данные об услуге:
- Услуга: Индивидуальная
- Отображаемое имя: (например, «MCP-сервер»)
Сохраните предоставленные идентификатор клиента и секретный код клиента.

2. Настройте переменные среды

Создайте файл .env в корневом каталоге:

# Your Marketo instance URL (required)
# Example: https://123-ABC-456.mktorest.com/rest
MARKETO_BASE_URL=your-marketo-instance-url

# Your API credentials (required)
MARKETO_CLIENT_ID=your-client-id
MARKETO_CLIENT_SECRET=your-client-secret

3. Установка и настройка

# Install dependencies
npm install

# Build the project
npm run build

# The build process will output configuration settings in your console
# Copy these settings into your Claude Desktop developer configuration

4. Конфигурация рабочего стола Клода

Открыть рабочий стол Клода
Перейти к настройкам разработчика
Вставьте параметры конфигурации , которые были выведены в процессе сборки.
Сохранить конфигурацию
Перезагрузить рабочий стол Клода

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

Получить список форм

marketo_get_forms({
  maxReturn: 200,  // optional, default: 200
  offset: 0,       // optional, default: 0
  status: 'draft'  // optional, 'draft' or 'approved'
})

Получить форму по идентификатору

marketo_get_form_by_id({
  formId: 1234
})

Форма клонирования

marketo_clone_form({
  formId: 1234,           // ID of form to clone
  name: "New Form Name",  // Name for the cloned form
  description: "Form description",  // optional
  folderId: 5678         // optional, destination folder ID
})

Утвердить форму

marketo_approve_form({
  formId: 1234,
  comment: "Approved by MCP server"  // optional
})

Обработка ошибок

Распространенные сценарии ошибок и решения:

Ошибки аутентификации
- Проверьте правильность вашего идентификатора клиента и секретного кода клиента.
- Проверьте, включен ли ваш API-доступ в Marketo
- Убедитесь, что URL-адрес вашего экземпляра правильный.
Ошибки разрешения
- Убедитесь, что у вашего пользователя API есть достаточные разрешения.
- Проверьте права доступа к папке для операций с формами
Ограничение скорости
- Сервер автоматически обрабатывает обновление токенов.
- Рассмотрите возможность внедрения логики повторных попыток для запросов с ограниченной частотой

Лучшие практики

Управление окружающей средой
- Никогда не передавайте файлы .env в систему контроля версий
- Используйте разные учетные данные для разработки и производства
- Регулярно меняйте свои учетные данные API
Безопасность
- Безопасное хранение учетных данных
- Используйте переменные среды для конфиденциальных данных
- Мониторинг журналов доступа API
Производительность
- Кэшируйте данные формы, когда это необходимо
- Используйте пагинацию для больших списков форм
- Правильно управляйте ограничениями ставок

Разработка

Структура проекта

├── src/
│   ├── index.ts        # Server entry point
│   ├── auth.ts         # Token management
│   └── constants.ts    # Configuration
├── .env                # Environment variables (not in git)
├── .env.example        # Example environment file
└── .gitignore         # Git ignore rules

Внося вклад

Форк репозитория
Создать ветку функций
Внесите изменения
Отправить запрос на извлечение

Поддерживать

По вопросам и проблемам:

Проверьте документацию Marketo REST API
Ознакомьтесь с типичными сценариями ошибок выше.
Отправить проблему в репозиторий

Marketo MCP Server

Integrations