Сервер Marketo MCP

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

Предпосылки

• Node.js (v14 или выше)

• Учетные данные API Marketo (идентификатор клиента и секретный код клиента)

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

• Установлен Claude Desktop

Related MCP server: Xero MCP Server

Начиная

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

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

2. Перейдите в Администрирование > Интеграция > LaunchPoint.

3. Нажмите «Новый» > «Новая услуга».

4. Заполните данные об услуге:

   • Услуга: Индивидуальная

   • Отображаемое имя: (например, «MCP-сервер»)

5. Сохраните предоставленные идентификатор клиента и секретный код клиента.

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

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

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

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

1. Открыть рабочий стол Клода

2. Перейти к настройкам разработчика

3. Вставьте параметры конфигурации , которые были выведены в процессе сборки.

4. Сохранить конфигурацию

5. Перезагрузить рабочий стол Клода

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

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

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

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

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

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

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

1. Ошибки аутентификации

   • Проверьте правильность вашего идентификатора клиента и секретного кода клиента.

   • Проверьте, включен ли ваш API-доступ в Marketo

   • Убедитесь, что URL-адрес вашего экземпляра правильный.

2. Ошибки разрешения

   • Убедитесь, что у вашего пользователя API есть достаточные разрешения.

   • Проверьте права доступа к папке для операций с формами

3. Ограничение скорости

   • Сервер автоматически обрабатывает обновление токенов.

   • Рассмотрите возможность внедрения логики повторных попыток для запросов с ограниченной частотой

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

1. Управление окружающей средой

   • Никогда не передавайте файлы .env в систему контроля версий

   • Используйте разные учетные данные для разработки и производства

   • Регулярно меняйте свои учетные данные API

2. Безопасность

   • Безопасное хранение учетных данных

   • Используйте переменные среды для конфиденциальных данных

   • Мониторинг журналов доступа API

3. Производительность

   • Кэшируйте данные формы, когда это необходимо

   • Используйте пагинацию для больших списков форм

   • Правильно управляйте ограничениями ставок

Разработка

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

Вы можете запустить MCP inspector на этом сервере с помощью следующей команды: npx @modelcontextprotocol/inspector node build/index.js

Внося вклад

1. Форк репозитория

2. Создать ветку функций

3. Внесите изменения

4. Отправить запрос на извлечение

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

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

1. Проверьте документацию Marketo REST API

2. Ознакомьтесь с типичными сценариями ошибок выше.

3. Отправить проблему в репозиторий