Sequenzy MCP Server
официальныйИнструмент email-маркетинга для SaaS
Документация
Sequenzy MCP Server
Официальный MCP-сервер для Sequenzy — платформы email-маркетинга на базе ИИ.
Подключите Sequenzy к Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw и другим MCP-клиентам, чтобы ваш ИИ-ассистент мог управлять email-операциями с помощью структурированных инструментов вместо ручного написания API-вызовов.
Что можно делать
- Управлять подписчиками, тегами, списками и динамическими сегментами.
- Синхронизировать сегменты с пользовательскими аудиториями Meta для ретаргетинга в Facebook и Instagram.
- Управлять товарами и прикреплять файлы для цифровой доставки в автоматизациях покупок.
- Создавать черновики, обновлять, планировать и проверять кампании.
- Создавать и редактировать цепочки писем, включая автоматизации по событиям и входу в сегмент.
- Отменять, приостанавливать, возобновлять, дублировать или удалять кампании и добавлять контакты в цепочки.
- Управлять шаблонами транзакционных писем и отправлять отдельные транзакционные письма.
- Создавать, редактировать, публиковать, снимать с публикации и удалять целевые страницы.
- Подключать и проверять пользовательские домены для опубликованных целевых страниц.
- Управлять приглашениями в команду, беседами во входящих и исходящими конечными точками вебхуков.
- Генерировать текст писем, темы и многошаговые цепочки.
- Просматривать аналитику, активность подписчиков, состояние доставляемости и URL-адреса панелей управления.
- Настраивать информацию о продукте компании, веб-сайты отправителей и примеры интеграций для распространённых фреймворков.
Каждый опубликованный MCP-инструмент включает явные аннотации readOnlyHint, destructiveHint и openWorldHint, чтобы совместимые клиенты могли отображать точные возможности использования инструментов. Инструменты также публикуют определения outputSchema и возвращают structuredContent, предоставляя клиентам и моделям машиночитаемые формы результатов для последующих вызовов.
Быстрая настройка
Самый простой способ настройки — мастер Sequenzy:
npx @sequenzy/setup
Мастер открывает браузерный процесс входа, создаёт персональный API-ключ, определяет поддерживаемые ИИ-клиенты и настраивает их автоматически, где это возможно.
Размещённый удалённый MCP
Для клиентов, поддерживающих Streamable HTTP MCP, используйте размещённую конечную точку Sequenzy вместо запуска локального процесса stdio:
https://api.sequenzy.com/v1/mcp
Удалённые клиенты должны проходить аутентификацию через OAuth-процесс Sequenzy, если он поддерживается. Локальные и автоматизированные клиенты по-прежнему могут использовать пакет stdio ниже с SEQUENZY_API_KEY.
Машиночитаемые файлы обнаружения:
- Манифест MCP-сервера:
server.json - Карточка агента:
.well-known/agent-card.json - Манифест возможностей агента:
agent-capability.json - Метаданные навыков OpenClaw:
openclaw/skill.json
Ручная настройка
Все клиенты stdio MCP используют одну и ту же команду:
- Команда:
npx - Аргументы:
-y @sequenzy/mcp - Обязательная переменная окружения:
SEQUENZY_API_KEY=seq_user_your_key_here
Необязательные переменные окружения:
SEQUENZY_API_URL— базовый URL API Sequenzy. По умолчаниюhttps://api.sequenzy.com.SEQUENZY_APP_URL— базовый URL панели управления Sequenzy, используемый помощниками URL приложений. По умолчаниюhttps://sequenzy.com.
Claude Desktop
Добавьте это в конфигурацию Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sequenzy": {
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Перезапустите Claude Desktop после редактирования конфигурации.
Claude Code
claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- npx -y @sequenzy/mcp
На нативной Windows оберните npx в cmd /c:
claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- cmd /c npx -y @sequenzy/mcp
Для общей конфигурации проекта используйте .mcp.json:
{
"mcpServers": {
"sequenzy": {
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Codex
codex mcp add sequenzy --env SEQUENZY_API_KEY=seq_user_your_key_here -- npx -y @sequenzy/mcp
codex mcp list
Ручная конфигурация Codex в ~/.codex/config.toml:
[mcp_servers.sequenzy]
command = "npx"
args = ["-y", "@sequenzy/mcp"]
[mcp_servers.sequenzy.env]
SEQUENZY_API_KEY = "seq_user_your_key_here"
Cursor
Добавьте это в ~/.cursor/mcp.json:
{
"mcpServers": {
"sequenzy": {
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Windsurf
Используйте ту же JSON-структуру, что и для Cursor.
- macOS:
~/Library/Application Support/Windsurf/mcp.json - Windows:
%APPDATA%\Windsurf\mcp.json
VS Code Copilot
VS Code использует объект servers:
{
"servers": {
"sequenzy": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@sequenzy/mcp"],
"env": {
"SEQUENZY_API_KEY": "seq_user_your_key_here"
}
}
}
}
Другие MCP-клиенты
Для OpenClaw, Hermes и других MCP-совместимых клиентов укажите клиенту npx -y @sequenzy/mcp и установите SEQUENZY_API_KEY.
Получение API-ключа
- Откройте панель управления Sequenzy.
- Перейдите в Настройки -> API-ключи.
- Создайте персональный ключ.
- Добавьте ключ в конфигурацию вашего MCP-клиента.
Персональные ключи начинаются с seq_user_. Вы можете отозвать их в любое время в панели управления.
Инструменты
Этот сервер в настоящее время предоставляет 120 инструментов MCP.
Аккаунт, компании, настройка
| Инструмент | Описание |
|---|---|
get_account | Получить информацию об аккаунте, доступных компаниях и текущей компании. |
select_company | Установить активную компанию для последующих вызовов инструментов. |
get_app_urls | Создать URL-адреса панели управления для кампаний, целевых страниц, цепочек, писем, настроек, доменов и деталей отправленных писем. |
create_company | Создать новую компанию или бренд. |
get_company | Прочитать детали компании, информацию о продукте, цвета бренда, контекст написания ИИ и настройки локализации. |
update_company | Редактировать информацию о продукте и контекст бренда, используемый ИИ для генерации писем. |
create_api_key | Создать API-ключ для компании. |
list_websites | Список настроенных веб-сайтов и доменов отправителей. |
add_website | Добавить веб-сайт отправителя. Обработка может занять около 30 секунд. |
check_website | Проверить, обработан ли веб-сайт и готов ли он. |
get_integration_guide | Получить примеры интеграций для конкретных фреймворков. |
Подписчики
| Инструмент | Описание |
|---|---|
add_subscriber | Добавить подписчика с атрибутами, тегами, статусом, режимом подписки и необязательными ID списков. |
update_subscriber | Обновить атрибуты, добавить теги или удалить теги. |
remove_subscriber | Отписать подписчика или полностью удалить его. |
get_subscriber | Получить детали подписчика по email или внешнему ID. |
search_subscribers | Поиск по запросу, тегам, списку, статусу, сегменту или с пагинацией. |
Товары и цифровая доставка
| Инструмент | Описание |
|---|---|
list_products | Список синхронизированных товаров из Stripe, Shopify, WooCommerce, вручную или данных Commerce API. |
upsert_products | Создать или обновить до 100 товаров Commerce API, идентифицируемых вашим ID товара. |
delete_product | Удалить товар, ранее добавленный через Commerce API. |
attach_product_file | Прикрепить размещённый или локально загруженный файл доставки к товару. |
remove_product_file | Удалить прикреплённый файл доставки товара. |
sync_products | Поставить в очередь синхронизацию каталога товаров Stripe. |
После прикрепления файла доставки товара соответствующие события покупки включают download.url и download.name, поэтому письма, инициируемые покупкой, могут использовать теги слияния, такие как {{event.download.url}}.
Списки, теги, сегменты
| Инструмент | Описание |
|---|---|
list_tags | Список всех тегов. |
create_tag | Создать определение тега с необязательным цветом. |
update_tag | Обновить цвет тега. |
delete_tag | Удалить тег и удалить его у подписчиков. |
list_lists | Список списков подписчиков. |
create_list | Создать список подписчиков. |
update_list | Переименовать или описать список подписчиков. |
delete_list | Удалить список подписчиков. |
add_subscribers_to_list | Добавить до 500 подписчиков в список из массива email. |
remove_subscribers_from_list | Удалить до 500 подписчиков из списка. |
list_segments | Список сохранённых сегментов и их размеров. |
create_segment | Создать сохранённые сегменты из фильтров или вложенных групп AND/OR. |
update_segment | Обновить имя сегмента, фильтры, корневую группу или оператор соединения. |
delete_segment | Удалить сохранённый сегмент. |
get_segment_count | Предварительный просмотр количества активных подписчиков в сегменте. |
Для экспорта подписчиков search_subscribers принимает listId, точный listName или list (сначала ID, затем точное имя). Если limit опущен, инструмент извлекает всех подходящих подписчиков, используя страницы API по 100 строк.
Для массового заполнения списка используйте add_subscribers_to_list; базовой конечной точкой API является POST /api/v1/lists/{listId}/subscribers без суффикса /bulk:
{
"emails": ["[email protected]", "[email protected]"],
"duplicateStrategy": "skip",
"enrollInSequences": false,
"optInMode": "default"
}
Отправляйте не более 500 email за один запрос. Стандартные ограничения скорости API по-прежнему применяются: 100 запросов в минуту на ключ API и 20 запросов в секунду при пиковой нагрузке. Для импорта из CSV через CLI допустимые заголовки email включают email, e-mail, email address и mail; если распознанный заголовок отсутствует, CLI читает первый столбец.
Фильтры сегментов поддерживают атрибуты, события, членство в сохранённых сегментах, события вовлечённости, правила покупки товаров Stripe и правила покупки товаров commerce. Используйте filterJoinOperator: "or" для сегментов с совпадением по любому условию или передайте группу v2 root для вложенной логики.
Каждое поле фильтра сегмента проверяет свои операторы:
status,segment:is,is_nottag:contains,not_contains,is_empty,is_not_emptyemail:contains,not_containsemailProvider,list:is,is_not,is_empty,is_not_emptyfirstName,lastName:contains,not_contains,is_empty,is_not_emptyadded:less_than,more_thanattribute:is,is_not,is_empty,is_not_empty,gte,lte,gt,lt,contains,not_containsevent, поля вовлечённости email:is,is_not,at_least,less_than_countemailBounced: также поддерживаетis_temporary_bounce,is_permanent_bouncestripeProduct:is,is_not,at_least,less_than_countstripeCurrentProduct,stripeTrialProduct:is,is_not,gte,lte,gt,ltcommerceProduct:is,is_not,at_least,less_than_count
Примеры фильтров товаров Stripe:
{ "field": "stripeProduct", "operator": "is", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "is_not", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "at_least", "value": "prod_pro:3" }
{ "field": "stripeProduct", "operator": "less_than_count", "value": "prod_pro:3" }
Фильтры товаров коммерции сопоставляют товары, приобретённые через заказы коммерции. Значения могут быть provider:productId для идентификаторов с областью провайдера (shopify, woocommerce или api), простым идентификатором товара для сопоставления с любым провайдером или provider:productId:count для пороговых операторов:
{ "field": "commerceProduct", "operator": "is", "value": "api:starter-kit" }
{ "field": "commerceProduct", "operator": "at_least", "value": "shopify:42:2" }
Поля вовлечённости, такие как emailSent, emailDelivered, emailOpened, emailClicked, emailBounced и emailComplained, принимают скользящие окна, например 7d, 30d, 90d, 180d, all, пороговые значения, например 5:30d, или область кампании, например campaign:cmp_123.
Синхронизации аудиторий (Meta Ads)
| Инструмент | Описание |
|---|---|
list_audience_syncs | Список синхронизаций сегментов с аудиториями с расписанием и статусом последней синхронизации. |
list_ad_accounts | Список рекламных аккаунтов Meta, доступных для синхронизации. |
create_audience_sync | Отправка сегмента в пользовательскую аудиторию Meta по расписанию. |
update_audience_sync | Изменение частоты синхронизации (hourly, daily, weekly) или приостановка/возобновление. |
delete_audience_sync | Удаление сопоставления синхронизации; сама аудитория Meta сохраняется. |
sync_audience_now | Запуск немедленной выгрузки вне обычного расписания. |
Требуется подключённая интеграция Meta Ads в панели управления Sequenzy (Настройки -> Интеграции). create_audience_sync принимает существующий сегмент (segmentId) или готовый шаблон (predefinedSegmentId, например zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged) — сегмент шаблона создаётся автоматически при первом использовании, и первая выгрузка запускается немедленно.
Аудитории работают только на добавление: подписчики, которые позже покидают сегмент, остаются в аудитории Meta. Meta требует 100+ совпавших людей, прежде чем аудиторию можно будет использовать для показа рекламы.
Шаблоны
| Инструмент | Описание |
|---|---|
list_templates | Список шаблонов со статусом локализации. |
get_template | Чтение деталей шаблона, содержимого и локализованных вариантов. |
create_template | Создание шаблонов из HTML или блоков Sequenzy. |
update_template | Обновление метаданных шаблона, меток, HTML или блоков. |
delete_template | Удаление шаблона. |
A/B-тесты
| Инструмент | Описание |
|---|---|
list_ab_tests | Список A/B-тестов и вариантов, опционально с фильтром по последовательности. |
get_ab_test | Получение вариантов, содержимого и статуса локализации. |
get_ab_test_stats | Получение агрегированной и повариантной статистики. |
restart_ab_test | Перезапуск остановленного или завершённого A/B-теста. |
update_ab_test_variant | Обновление темы, текста предпросмотра, HTML или блоков чернового варианта. |
create_ab_test | Создание A/B-теста для кампании или последовательности. |
add_ab_test_variant | Добавление варианта в существующий A/B-тест. |
delete_ab_test_variant | Удаление чернового варианта A/B-теста. |
delete_ab_test | Удаление A/B-теста. |
Используйте get_ab_test для обнаружения идентификаторов вариантов перед редактированием. Обновления вариантов принимают либо html, либо blocks, но не оба одновременно.
Кампании
| Инструмент | Описание |
|---|---|
list_campaigns | Список кампаний, опционально с фильтром по статусу. |
get_campaign | Получение деталей и статистики кампании. |
get_email_send | Просмотр детальной записи отправленного письма. |
create_campaign | Создание черновой кампании из HTML, блоков, шаблона или данных кампании. |
update_campaign | Обновление черновой кампании, включая данные кампании и вычисляемые списки. |
schedule_campaign | Планирование черновика или перенос существующей запланированной кампании. |
send_test_email | Отправка тестового письма на один адрес. |
cancel_campaign | Отмена запланированной или отправляемой кампании. |
pause_campaign | Приостановка отправляемой кампании. |
resume_campaign | Возобновление приостановленной кампании, опционально с распределением доставки по времени. |
delete_campaign | Удаление кампании. |
duplicate_campaign | Дублирование кампании в новый черновик. |
resend_campaign_to_non_openers | Создание черновой повторной отправки для исходных участников аудитории, не открывших отправленную кампанию. |
Посадочные страницы
| Инструмент | Описание |
|---|---|
list_landing_pages | Список посадочных страниц со статусом, метриками, содержимым и URL-адресами. |
get_landing_page | Получение деталей посадочной страницы, содержимого конструктора, метрик и публичных URL. |
create_landing_page | Создание черновой посадочной страницы из содержимого шаблона по умолчанию или JSON. |
update_landing_page | Редактирование имени, слага или полного содержимого, совместимого с редактором. |
publish_landing_page | Публикация посадочной страницы, опционально с предварительным сохранением изменений. |
unpublish_landing_page | Возврат посадочной страницы в статус черновика, опционально с предварительным сохранением изменений. |
delete_landing_page | Удаление неопубликованной посадочной страницы. |
connect_landing_page_domain | Подключение пользовательского домена посадочной страницы и возврат деталей настройки DNS. |
update_landing_page_domain_settings | Замена или проверка настроек пользовательского домена посадочной страницы. |
Содержимое посадочной страницы использует JSON-схему, совместимую с редактором Sequenzy, с version, template, seo, theme и blocks. Пользовательские домены посадочных страниц требуют CNAME-запись, указывающую на pages.sequenzydns.com; вызовите update_landing_page_domain_settings с verify: true после распространения изменений DNS.
Последовательности
| Инструмент | Описание |
|---|---|
list_sequences | Список email-последовательностей и статуса автоматизации. |
get_sequence | Получение деталей последовательности, включая шаг nodeId, связанный emailId, тему, текст предпросмотра и блоки. |
create_sequence | Создание последовательностей, сгенерированных ИИ, или с явными шагами. |
update_sequence | Обновление настроек последовательности, поведения зачисления, существующих шагов, логики ветвления или вставка линейных шагов. |
insert_sequence_step | Вставка одного нового email-шага, опционально с узлом задержки перед ним. |
enable_sequence | Активация последовательности. |
disable_sequence | Заморозка последовательности, блокировка новых зачислений и удержание текущих получателей. |
pause_sequence_enrollments | Остановка новых зачислений для активной последовательности, пока текущие получатели продолжают. |
resume_sequence_enrollments | Повторное открытие новых зачислений для активной последовательности без изменения текущих получателей. |
enroll_subscribers_in_sequence | Зачисление до 500 подписчиков по email, идентификатору подписчика или обоим, опционально в целевой узел. |
cancel_sequence_enrollments | Остановка активных или ожидающих зачислений по значениям полей подписчика или события входа. |
delete_sequence | Удаление последовательности. |
Создание последовательности поддерживает:
trigger: "segment_entered"плюсsegmentIdдля автоматизаций входа в сохранённый сегмент.trigger: "event_received"плюс{{event.*}}теги слияния в темах или содержимом тела письма.trigger: "inactivity"плюсeventName,inactiveDaysи опциональныйinactivityBaseline(sequence_created_atилиsubscriber_created_at).goalдля содержимого email, сгенерированного ИИ.- Явный
stepsсblocksSequenzy. - Явный
stepsс HTML, который Sequenzy преобразует в редактируемые блоки. - Фиксированные ожидания через
delay/delayMsили динамические ожидания по полю даты черезwaitUntilдля напоминаний о продлении, последующих действий после встреч, уведомлений об истечении пробного периода и других дат, привязанных к событиям. - Шаги действий со скидкой, которые раскрывают теги слияния, такие как
{{discount.code}}и{{discount.percentOff}}. enrollmentMode: "matching_field"иenrollmentFieldPathдля автоматизаций событий, специфичных для товара, варианта, заказа или подписки.
Обновления последовательности поддерживают insertSteps для добавления новых линейных шагов после nodeId, возвращённого get_sequence. Не указывайте afterNodeId только при добавлении к последовательности ровно с одним линейным хвостом. insertSteps поддерживает добавляемые шаги, не требующие сопутствующих записей, такие как email, задержка, действия с тегами/списками, обновления атрибутов, скидки, условия, шаги ожидания события и вебхуки. Используйте branch для многопутевых ветвлений if/else; укажите либо branch, либо insertSteps, но не оба. Условия ветвления поддерживают проверки наличия и отсутствия тегов с has_tag и does_not_have_tag, а также списки, сохранённые сегменты, события, переходы по ссылкам и сравнения полей. Массивы emails и steps редактируют только существующие email-шаги по nodeId, emailId или порядку в массиве; используйте insertSteps для создания новых шагов и включите delay, delayMs или waitUntil на уровне шага, когда вставляемому email нужен таймер. waitUntil принимает поле даты из события-триггера плюс опциональные offset, direction (before или after) и missingAction (continue или exit). Для активных последовательностей передавайте confirmStructuralChange: true с insertSteps или branch только после подтверждения влияния на живой поток.
Запустите cancel_sequence_enrollments с dryRun: true перед применением массовой отмены.
Стилизация блоков email
Инструменты, принимающие blocks, сохраняют визуальное оформление отдельных блоков в объекте styles блока:
{
"type": "card",
"title": "Your update",
"content": "Everything is ready.",
"variant": "default",
"styles": {
"backgroundColor": "#f8fafc",
"backgroundOpacity": 85,
"borderColor": "#cbd5e1",
"borderWidth": 1,
"borderRadius": 12
}
}
Для совместимости со старыми промптами агентов также принимаются ключи стиля верхнего уровня, такие как backgroundColor, backgroundOpacity, borderColor, borderWidth и borderRadius, и сохраняются в styles.
Транзакционные письма
| Инструмент | Описание |
|---|---|
list_transactional_emails | Список транзакционных шаблонов и API-слагов. |
get_transactional_email | Чтение транзакционного письма по ID или слагу. |
create_transactional_email | Создание шаблона транзакционного письма. |
update_transactional_email | Обновление метаданных или содержимого транзакционного письма. |
send_email | Отправка одного транзакционного письма по шаблону или HTML. |
Переменные send_email поддерживают вложенные массивы для повторяющихся блоков, например { "event": { "items": [...] } }.
Аналитика
| Инструмент | Описание |
|---|---|
get_stats | Получение общей статистики для 7d, 30d или 90d. |
get_campaign_stats | Детальная эффективность кампании. |
get_sequence_stats | Эффективность последовательности. |
list_campaign_events | Постраничный список сырых событий писем для кампании. |
list_sequence_events | Постраничный список сырых событий писем для последовательности. |
get_subscriber_activity | Статистика писем подписчика, активность и зачисления. |
Инструменты аналитики по умолчанию исключают обнаруженных ботов, сканеры, предпросмотры ссылок и отслеживаемые открытия/клики по ресурсам. Передавайте includeMachineEngagement: true в get_stats, get_campaign_stats, get_sequence_stats, get_ab_test_stats, get_subscriber или get_subscriber_activity, когда вам нужна сырая диагностика вовлеченности; включенные строки активности открытий/кликов раскрывают поля machine, engagementQuality и classificationReasons, где API возвращает активность на уровне событий.
Команда, Входящие, Вебхуки
| Инструмент | Описание |
|---|---|
list_team_members | Список участников команды и ожидающих приглашений. |
invite_team_member | Приглашение коллеги как администратора или наблюдателя, с опциональным доступом к биллингу. |
cancel_team_invitation | Отмена ожидающего приглашения в команду. |
list_conversations | Список переписок с ответами подписчиков с фильтрами по статусу и непрочитанным. |
get_conversation | Чтение переписки и истории её сообщений. |
reply_to_conversation | Отправка исходящего ответа или добавление внутренней заметки. |
update_conversation_status | Открытие или закрытие переписки. |
mark_conversation_read | Отметить все сообщения в переписке как прочитанные. |
list_webhooks | Список конечных точек исходящих вебхуков. |
create_webhook | Создание исходящего вебхука и возврат его одноразового секрета подписи. |
update_webhook | Обновление имени, URL, событий или статуса вебхука. |
delete_webhook | Безвозвратное удаление конечной точки вебхука и истории доставки. |
test_webhook | Отправка тестового события на конечную точку вебхука. |
list_webhook_deliveries | Список последних попыток доставки для вебхука. |
replay_webhook_delivery | Повторная отправка доставки вебхука. |
Генерация с помощью ИИ
| Инструмент | Описание |
|---|---|
generate_email | Генерация блоков письма из промпта. |
generate_sequence | Генерация многоэтапной последовательности писем из цели. |
generate_subject_lines | Генерация вариантов тем для A/B-тестирования. |
Сгенерированный контент возвращается как черновик для проверки.
Ресурсы
Сервер также предоставляет ресурсы MCP только для чтения.
| Ресурс | Описание |
|---|---|
sequenzy://dashboard | Обзорная статистика в реальном времени за последние 7 дней. |
sequenzy://company | Текущие настройки компании и локализации. |
sequenzy://campaigns/recent | Последние 10 кампаний со статусом и базовой статистикой. |
sequenzy://subscribers/recent | Недавно добавленные подписчики. |
sequenzy://subscribers/engaged | Самые активные или вовлеченные подписчики. |
sequenzy://sequences | Все последовательности со статусом. |
sequenzy://templates | Шаблоны со статусом локализации. |
sequenzy://segments | Сохраненные сегменты с количеством подписчиков. |
sequenzy://tags | Теги с количеством использований. |
sequenzy://health | Метрики доставляемости и состояние здоровья. |
sequenzy://app-routes | Шаблоны маршрутов панели управления и вкладки настроек. |
Примеры промптов
Add [email protected] with tags "vip" and "developer", then put them on the beta list.
Create a 4-email churn prevention sequence for users whose subscription expires soon. Leave it in draft mode.
Create a segment for subscribers who bought Stripe product prod_pro at least 3 times.
Draft a campaign about our new analytics dashboard, target the Pro users segment, and send a test to me.
How did the last campaign perform compared with the one before it?
Безопасность
- Используйте персональные API-ключи, а не общие секреты команды.
- Ключи предоставляют доступ только к тем компаниям, к которым имеет доступ ваш пользователь Sequenzy.
- Отзывайте ключи в Настройках -> API-ключи, когда доступ больше не нужен.
- Оставляйте включенными запросы на подтверждение клиента для отправок, планирования, удалений и массовых изменений.
- Предпочитайте рабочие процессы с черновиками для кампаний и последовательностей, затем проверяйте в Sequenzy перед запуском.
Устранение неполадок
SEQUENZY_API_KEY environment variable is required
Установите SEQUENZY_API_KEY в конфигурации MCP-клиента или выполните:
npx @sequenzy/setup
Неверный API-ключ
Создайте новый персональный ключ в Настройках -> API-ключи, обновите конфигурацию MCP и перезапустите клиент.
Дублирующиеся ресурсы
Если вызов инструмента может создать дублирующееся имя сегмента или домен отправки, сервер возвращает стабильный code, удобный для агента description, конкретный resolution и docsUrl. Для сегментов вызовите list_segments и повторно используйте существующий ID сегмента или выберите другое имя. Для веб-сайтов вызовите list_websites; если домен не указан для выбранной компании, он принадлежит другой компании или аккаунту и должен быть удален, переназначен или заменен другим доменом отправки.
Инструменты не отображаются
- Убедитесь, что
npxдоступен в среде, используемой клиентом. - Перезапустите MCP-клиент после редактирования конфигурации.
- Проверьте, что конфигурация находится в правильном расположении, специфичном для клиента.
Проблемы с сетью или URL API
Сервер по умолчанию использует https://api.sequenzy.com. Если вы переопределяете его, убедитесь, что SEQUENZY_API_URL указывает на достижимый базовый URL Sequenzy API.
Разработка
bun install
bun test
bun run type-check
bun run build
Схемы инструментов MCP должны оставаться совместимыми со строгими клиентами:
- Корни
inputSchemaинструментов должны быть простыми схемамиtype: "object". - Не публикуйте
anyOfнигде в схемах инструментов. - Не размещайте
oneOf,allOf,enumилиnotв корне схемы инструмента. - Обеспечивайте соблюдение условных требований в обработчиках и покрывайте их тестами.
Этот автономный репозиторий зеркалирует пакет MCP, поддерживаемый в основном монорепозитории Sequenzy. См. AGENTS.md для правил синхронизации.
Лицензия
MIT
Нативное обнаружение агентами
Sequenzy публикует машиночитаемые манифесты для агентских сетей и обнаружения в стиле A2A:
- Удаленная конечная точка MCP:
https://api.sequenzy.com/v1/mcp - Манифест возможностей агента:
agent-capability.json - Карточка агента в стиле A2A:
.well-known/agent-card.json - Метаданные навыков OpenClaw/Moltbot:
openclaw/skill.json - Руководство по эксплуатации OpenClaw/Moltbot:
openclaw/SKILL.md
Эти файлы описывают Sequenzy как авторизованную возможность автоматизации электронной почты для агентов. Они явно исключают сценарии использования, связанные со скрапингом, спамом и нежелательными холодными рассылками.