Мгновенный MCP-сервер

MCP-сервер для API Instantly.ai v2 — управление кампаниями по электронной почте, учетными записями, лидами и аналитикой через Claude AI. Идеально подходит для автоматизации электронной почты и холодных кампаний по охвату.

Обзор

Instantly MCP Server — это мощная интеграция, которая переносит возможности автоматизации электронной почты Instantly.ai непосредственно в Claude и других помощников AI через Model Context Protocol. Это позволяет управлять с помощью AI:

• 📧 Email-кампании и последовательности

• 👥 Управление аккаунтом и его разогрев

• 📊 Аналитика и отслеживание эффективности

• 🎯 Управление лидами и сегментация

• ✉️ Отправка и проверка электронной почты

• 🔑 Управление ключами API

Идеально подходит для отделов продаж, маркетологов и разработчиков, желающих автоматизировать свои рабочие процессы по холодному общению с клиентами с помощью ИИ.

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

Использование с npx (установка не требуется)

Добавьте в конфигурацию настроек MCP:

Локальная установка

1. Клонировать и установить:

2. Добавьте в настройки MCP:

Получение вашего API-ключа

1. Войти в Instantly.ai

2. Перейдите в Настройки > Интеграции > API.

3. Сгенерируйте или скопируйте свой ключ API

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

Управление кампанией

• list_campaigns — список всех кампаний с дополнительными фильтрами и разбиением на страницы.

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

• create_campaign — создать новую кампанию по электронной почте

• update_campaign — обновить существующую кампанию

• activate_campaign — Активировать кампанию

Аналитика

• get_campaign_analytics - Получите аналитику для кампаний

• get_campaign_analytics_overview — получить аналитический обзор для всех кампаний

Управление счетом

• list_accounts — список всех отправляющих аккаунтов с разбивкой на страницы

• create_account — создать новую учетную запись отправителя

• update_account — обновление отправляющей учетной записи

• get_warmup_analytics — получить аналитику разогрева для аккаунта

Лид-менеджмент

• list_leads - Список лидов с фильтрами и пагинацией

• create_lead — Создать новый лид

• update_lead — обновить лид

• move_leads — перемещение лидов между кампаниями или списками

Списки свинца

• list_lead_lists — список всех списков лидов с разбивкой на страницы

• create_lead_list — Создать новый список лидов

Операции с электронной почтой

• send_email — отправить одно электронное письмо

• list_emails — список адресов электронной почты с фильтрами и пагинацией

Проверка электронной почты

• verify_email — проверка действительности адреса электронной почты

Управление ключами API

• list_api_keys — список всех ключей API

• create_api_key — Создать новый ключ API

Пример использования

После настройки вы сможете использовать естественный язык для взаимодействия с Instantly:

• «Список всех моих активных кампаний»

• «Покажите мне аналитику для кампании XYZ»

• «Создайте новую кампанию под названием «Летняя распродажа»»

• «Список всех моих отправляющих аккаунтов»

Разработка

Тестирование

Локальное тестирование

1. Протестируйте конечные точки API напрямую:

2. Тест с помощью MCP Inspector:

3. Тест с Claude Desktop: Добавьте в конфигурацию Claude Desktop:

Документация конечной точки

Сервер MCP включает в себя все основные конечные точки API Instantly v2:

• Кампании : создание, перечисление, обновление, активация кампаний

• Аналитика : получите аналитику и обзор кампании

• Учетные записи : управление отправляющими учетными записями и разминка

• Лиды : создание, составление списка, обновление, перемещение лидов

• Списки лидов : создание и управление списками лидов

• Электронная почта : отправка электронных писем и просмотр истории электронной почты

• Проверка электронной почты : проверка адресов электронной почты

• API-ключи : Управление API-ключами

Полную документацию по API можно найти на сайте: https://developer.instantly.ai/

Лицензия

Массачусетский технологический институт

Функции

• 🚀 Полное покрытие API Instantly v2

• 📄 Поддержка пагинации для всех конечных точек списка

• ⚡ Ограничение скорости с помощью информационных сообщений

• 🔧 Комплексная обработка ошибок

• 📝 Поддержка TypeScript

• 🔐 Безопасная обработка ключей API

• 📚 Примеры скриптов включены

Последние обновления

v2.0.13 (последняя)

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

• Добавлена настройка часового пояса и дней для кампаний.

• Расширенное ведение журнала отладки для устранения неполадок

• Механизм отката для различных структур API

Полную историю версий смотрите на сайте CHANGELOG.md .

Известные проблемы

• Создание кампании может потребовать особой настройки учетной записи.

• Некоторые конечные точки возвращают пустые результаты, несмотря ��а то, что данные существуют (работаем над исправлениями)

• Для отправки электронной почты требуются проверенные учетные записи отправителя

Внося вклад

Pull requests приветствуются! Убедитесь, что все тесты пройдены, и следуйте существующему стилю кода.

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

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

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

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

• Проблемы : Проблемы GitHub

• Документация : Документация по API Instantly

• Протокол MCP : Модель контекстного протокола

Издательский

Этот пакет автоматически публикуется в npm при добавлении нового тега версии:

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

• Если у вас возникли проблемы или вопросы, пожалуйста, создайте тему на GitHub

• Документацию по API Instantly можно найти на сайте: https://developer.instantly.ai/

Журнал изменений

Список изменений см. на сайте CHANGELOG.md.

Автор

Создано bcharleson