Skip to main content

​
Обзор

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

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

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

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

Рабочая конечная точка:
Добавьте ее в клиент с поддержкой OAuth как удаленный HTTP-сервер MCP. Клиент обнаружит сервер авторизации Nudgen через эту конечную точку и откроет в браузере процесс входа и предоставления согласия. Выберите рабочее пространство, к которому клиент должен получить доступ, и подтвердите только необходимые области доступа. Документы обнаружения: Сервер авторизации использует код авторизации с PKCE S256, привязку к ресурсу и ротацию токенов обновления. Он поддерживает документы метаданных Client ID и динамическую регистрацию клиентов. Для Codex CLI используйте:
Если клиент с именем nudgen уже настроен, обновите его запись, указав URL /mcp. Если вам нужно только просматривать данные, запросите campaigns:read. Добавьте campaigns:write, если клиент должен изменять контакты, черновики, настройки бренда или импортированных потенциальных клиентов. Добавляйте campaigns:send, только если клиенту требуется запрашивать подтверждение запуска.
Токены личного доступа используются для аутентификации в 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. Попросите его вызвать prepare_campaign_launch, передав идентификатор кампании и точное время немедленной или запланированной отправки. Инструмент вернет одноразовый URL подтверждения; на этом этапе письма еще не отправляются.
  3. Откройте URL, проверьте рабочее пространство, расчетное количество получателей, содержимое, отправителя и время, затем нажмите Подтвердить запуск.
  4. Вернитесь в клиент, чтобы он вызвал launch_campaign с теми же идентификатором кампании, временем и approvalId.
Подтверждение действует 10 минут и может быть использовано один раз. Если кампания или отправитель изменились, запросите новое подтверждение. При запуске Nudgen повторно проверяет готовность отправителя, подходящих получателей, подписку, квоту и доступность очереди. Доставка начнется только после того, как обработчик кампаний обработает запуск.
Подтверждение и завершение launch_campaign могут привести к отправке реальных писем. Перед подтверждением отправки реальной аудитории используйте функцию тестовой отправки в дашборде, чтобы проверить письмо во входящих.

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

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

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

Для сценариев, использующих 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 остаётся привязанным к разрешённому рабочему пространству. Администрирование, учётные данные, вебхуки, обратные вызовы отслеживания и внутренний помощник исключены. Используйте get_api_capabilities для проверки охвата API. Для тестового письма, активации lifetime или события lifetime сначала запросите одобрение в браузере через prepare_campaign_action. Затем вызовите send_test_email, activate_lifetime_campaign или trigger_lifetime_campaign с теми же аргументами. Одобрение действует десять минут и используется один раз.