Перейти к основному содержанию

Обзор

Nudgen размещает сервер MCP на /mcp домена приложения. Он поддерживает MCP 2026-07-28 через Streamable HTTP и требует OAuth 2.1. Войдите через браузер и подтвердите запрошенные разрешения. Если функция доступна, выберите одно рабочее пространство или явно разрешите доступ ко всем текущим и будущим пространствам, участником которых вы являетесь. Переключение в панели не меняет пространство MCP по умолчанию.

Работа с несколькими пространствами

Существующие подключения ограничены исходным пространством до повторного подключения с расширенным согласием. При доступе ко всем пространствам новые членства становятся доступны автоматически. Потеря членства блокирует последующие действия в этом пространстве. Роли, подписки и квоты применяются отдельно к каждому пространству. Используйте list_workspaces с page и pageSize, чтобы узнать идентификаторы, названия, slug, роли и пространство по умолчанию. Требуется teams:read. Передайте workspaceId инструменту, чтобы выбрать пространство только для данного действия. Без него используется значение по умолчанию для подключения. Для проверки и отправки кампании передавайте один и тот же явный идентификатор. Выберите пространство по умолчанию при согласии OAuth. Измените его в Настройки → Ключи API → Подключённые приложения MCP или вызовите set_default_workspace с workspaceId и разрешением teams:write. Изменение действует во всех чатах с этим подключением. Выбор для отдельного вызова не меняет значение по умолчанию. Если пространство удалено или недоступно, укажите другое явно или обновите настройку. Nudgen не выбирает замену автоматически.
Существующие URI ресурсов используют пространство по умолчанию. Эти шаблоны явно выбирают пространство:

Почему это важно

Ассистент может просматривать контакты, искать компании и создавать черновики кампаний. Разрешите отправку или планирование в чате: ассистент выполнит действие напрямую, без ссылки подтверждения в браузере.

Подключение клиента

Рабочая конечная точка:
Добавьте ее в клиент с поддержкой OAuth как удаленный HTTP-сервер MCP. Клиент обнаружит сервер авторизации Nudgen через эту конечную точку и откроет в браузере процесс входа и предоставления согласия. Выберите рабочее пространство, к которому клиент должен получить доступ, и подтвердите только необходимые области доступа. Документы обнаружения: Сервер авторизации использует код авторизации с PKCE S256, привязку к ресурсу и ротацию токенов обновления. Он поддерживает документы метаданных Client ID и динамическую регистрацию клиентов. Для Codex CLI используйте:
Если клиент с именем nudgen уже настроен, обновите его запись, указав URL /mcp. Используйте campaigns:read для чтения, campaigns:write для черновиков и изменений, campaigns:send для разрешённых действий отправки. Согласие OAuth по-прежнему необходимо.
Токены личного доступа используются для аутентификации в API разработчика, но не подходят для /mcp. Клиент MCP должен пройти вход через OAuth.

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

create_campaign сохраняет черновик кампании (one-time, drip или lifetime). Этот инструмент не может напрямую отправить или запланировать кампанию. С помощью get_campaign можно проверить тему, содержимое, ссылку, аудиторию и отправителя перед запуском. Сервер также предоставляет ресурсы только для чтения в области доступа campaigns:read:

Поиск и импорт потенциальных клиентов с карты

  1. Попросите ассистента вызвать search_map_leads, указав местоположение и ключевые слова для поиска компаний, например город и marketing agency.
  2. Дополнительные фильтры: radiusKm (1–100), lat, lng и emailOnly, чтобы оставить только компании с опубликованным email-адресом.
  3. Если результат содержит nextPageToken, передайте его как pageToken, чтобы загрузить следующую страницу.
  4. Попросите ассистента вызвать import_map_leads с теми же местоположением и ключевыми словами, а также объектами потенциальных клиентов, которые нужно сохранить. Один вызов принимает до 200 потенциальных клиентов.
При импорте контакты записываются в подключенное рабочее пространство. Потенциальные клиенты без email-адреса пропускаются. Если такой потенциальный клиент уже существует, его данные обновляются.

Запуск черновика кампании

  1. Проверьте название, тему, содержимое, фактического отправителя, оценку числа получателей и время через get_campaign.
  2. Разрешите действие в чате. Ассистент напрямую вызывает launch_campaign с ID кампании и sendNow: true для немедленной отправки либо scheduledAt с будущим временем и часовым поясом. Не передавайте противоречивые параметры времени. Уже данное разрешение не требует повторного подтверждения.
  3. Проверьте возвращённые статус, время отправки и ссылку на панель. Постановка в очередь или планирование не означают доставку. При неопределённом результате проверьте get_campaign и get_campaign_stats перед повтором.
Nudgen продолжает проверять права рабочего пространства, готовность отправителя, допустимых получателей, подписку, квоту, версию кампании и очередь. Создание и редактирование сохраняют только черновики; для доставки нужен обработчик кампаний.

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

Откройте Настройки → Ключи API → Подключённые приложения MCP, чтобы проверить доступ, изменить пространство по умолчанию или отключить приложение. Отключение подключения к нескольким пространствам отзывает его токены и ожидающие коды авторизации во всех пространствах, не затрагивая отдельные REST-подключения. REST OAuth и встроенный помощник сохраняют существующие границы доступа.

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

Для сценариев, использующих bearer-токены и прямые конечные точки REST, см. API разработчика.

Радиус поиска и обогащение

API и MCP используют 5 км по умолчанию и принимают целое radiusKm от 1 до 100 без диалога подтверждения панели. Сохраняйте параметры при передаче nextPageToken как pageToken. Даже пустая страница может иметь следующую. enrichmentPending означает незавершённое исследование сайта. Проверяйте доступные businessSummary и businessSources. Импортированный контекст помогает персонализировать вступления кампаний. Отсутствующий email может ещё находиться в процессе поиска. При наличии enrichmentRetryToken вызовите retry_map_leads_enrichment с token и правом campaigns:read. Токен привязан к подключённому workspace, действует 15 минут и используется один раз. Перед импортом объедините результаты по placeId. emailOnly фильтрует текущий ответ; лиды могут появиться после повтора.

Редактирование черновиков и охват функций

Используйте update_campaign для редактирования существующего черновика и delete_campaign для его удаления. Обоим инструментам требуется campaigns:write; они не отправляют и не планируют письма. Новым разделам продукта нужны отдельные разрешения OAuth. При запросе подключитесь заново и подтвердите эти разрешения. Список инструментов показывает доступные инструменты и аргументы. Переход в браузер не выполняет действие. Используйте браузер для платежей, авторизации провайдеров, приглашений, создания/удаления/вступления в пространства и конфиденциальных реквизитов выплат. Выбор пространства MCP и изменение значения по умолчанию не переключают пространство панели. Администрирование, учётные данные, вебхуки, обратные вызовы отслеживания и внутренний помощник исключены. Проверяйте охват API через get_api_capabilities. После разрешения в чате напрямую вызывайте send_test_email, activate_lifetime_campaign или trigger_lifetime_campaign. Тесты отправляются только на почту аккаунта. Активация lifetime разрешает будущие автоматические отправки. Подтверждение в браузере и ID подтверждения не нужны. При неопределённом результате проверьте статус или историю выполнения перед повтором.