Обзор
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 не выбирает замену автоматически.
Почему это важно
Ассистент может просматривать контакты, искать компании и создавать черновики кампаний. Разрешите отправку или планирование в чате: ассистент выполнит действие напрямую, без ссылки подтверждения в браузере.Подключение клиента
Рабочая конечная точка:
Сервер авторизации использует код авторизации с 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:
Поиск и импорт потенциальных клиентов с карты
- Попросите ассистента вызвать
search_map_leads, указав местоположение и ключевые слова для поиска компаний, например город иmarketing agency. - Дополнительные фильтры:
radiusKm(1–100),lat,lngиemailOnly, чтобы оставить только компании с опубликованным email-адресом. - Если результат содержит
nextPageToken, передайте его какpageToken, чтобы загрузить следующую страницу. - Попросите ассистента вызвать
import_map_leadsс теми же местоположением и ключевыми словами, а также объектами потенциальных клиентов, которые нужно сохранить. Один вызов принимает до 200 потенциальных клиентов.
Запуск черновика кампании
- Проверьте название, тему, содержимое, фактического отправителя, оценку числа получателей и время через
get_campaign. - Разрешите действие в чате. Ассистент напрямую вызывает
launch_campaignс ID кампании иsendNow: trueдля немедленной отправки либоscheduledAtс будущим временем и часовым поясом. Не передавайте противоречивые параметры времени. Уже данное разрешение не требует повторного подтверждения. - Проверьте возвращённые статус, время отправки и ссылку на панель. Постановка в очередь или планирование не означают доставку. При неопределённом результате проверьте
get_campaignиget_campaign_statsперед повтором.
Управление доступом
Откройте Настройки → Ключи 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 подтверждения не нужны. При неопределённом результате проверьте статус или историю выполнения перед повтором.