Skip to content

New in October

Getting started

Connect NudgeLink to your AI assistant

Connect ChatGPT, Claude, Codex, Cursor, VS Code or Gemini CLI with OAuth. Setup in English, Polish and Russian, permissions and disconnect instructions.

Last updated 2026-10-09

English · Polski · Русский

Connect an assistant to check results, read replies, find leads and draft messages. MCP tools cannot send messages, invitations or replies, or approve drafts. Sending follows your campaign and approval settings in NudgeLink.

English setup

Use https://api.nudgelink.co/mcp with Streamable HTTP and OAuth. The URL and connection controls are in Settings → Integrations → Connected AI assistants. Sign in to NudgeLink in the browser and review the permissions. No API key or manually copied token is needed. Choose automatic OAuth client registration (DCR) when offered. Menus and availability depend on the client version, plan and organization policy. These are documented setup paths; a live connection has not been tested in every client.

ClientSetup
ChatGPTPlugins → + → Add custom MCP server: enter NudgeLink and the URL, choose OAuth, create and install the plugin. Complete NudgeLink sign-in; select the plugin with @ in a Work chat. Official guide.
Claude web / DesktopCustomize → Connectors → + Add → Add custom connector: enter the URL, choose Sign in now and Register automatically, then approve consent. Enable + → Connectors in chat. Team/Enterprise requires an authorized owner to add it first via Organization settings → Connectors → Add → Custom → Web. Official guide.
Claude CodeRun its command in Configuration; open /mcp in Claude Code, select nudgelink, and authenticate in the browser. Official guide.
Codex CLI / IDERun both Codex commands below. Alternatively, in the IDE select gear → MCP servers → Add server → Streamable HTTP, enter the URL, save, restart the extension and select Authenticate. Official guide.
CursorMerge the JSON below into ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project). Enable nudgelink and complete browser OAuth. Official guide.
VS Code / GitHub CopilotRun MCP: Add Server → HTTP in the Command Palette. Enter the URL and name nudgelink, save to the offered workspace or user configuration, start/trust the server, and sign in. Enable its tools in Copilot Chat. Setup, OAuth support.
Gemini CLIRun its command below; inside Gemini run /mcp auth nudgelink and complete browser consent. Use a local session that can receive the browser callback. Official guide.
Other MCP clientsAdd a remote Streamable HTTP server with this URL. The client needs OAuth discovery, authorization code with PKCE and automatic registration (DCR). Choose browser sign-in. If the client only supports local servers or lacks OAuth, use one of the clients above.

After connecting, ask “Which NudgeLink account am I connected to?” This checks get_profile without starting a search or spending credits. Manage LinkedIn search access and disconnect in Settings → Integrations → Connected AI assistants. Disconnect blocks new tool calls and token renewal. Work already running may finish. Reconnecting requires fresh consent.

Polski — konfiguracja

Adres: https://api.nudgelink.co/mcp. Wybierz Streamable HTTP i OAuth. Adres oraz zarządzanie połączeniami: Ustawienia → Integracje → Połączeni asystenci AI. Zaloguj się do NudgeLink w przeglądarce i sprawdź uprawnienia. Nie kopiuj tokenu ani klucza API; jeśli klient pyta, wybierz automatyczną rejestrację OAuth (DCR). Dostępność zależy od wersji, planu i zasad organizacji. Instrukcje opierają się na dokumentacji; nie przeprowadzono testu połączenia w każdym kliencie.

KlientKonfiguracja
ChatGPTPlugins → + → Add custom MCP server: wpisz NudgeLink i adres, wybierz OAuth, utwórz i zainstaluj wtyczkę. Zaloguj się do NudgeLink; wybierz wtyczkę przez @ w czacie Work.
Claude web / DesktopCustomize → Connectors → + Add → Add custom connector: wpisz adres, wybierz Sign in now i Register automatically, zatwierdź uprawnienia. W czacie włącz + → Connectors. W Team/Enterprise uprawniony właściciel najpierw dodaje serwer przez Organization settings → Connectors → Add → Custom → Web.
Claude CodeUruchom polecenie poniżej, potem wpisz /mcp w Claude Code, wybierz nudgelink i zaloguj się w przeglądarce.
Codex CLI / IDEUruchom oba polecenia Codex poniżej. W IDE możesz też wybrać gear → MCP servers → Add server → Streamable HTTP, podać adres, zapisać, uruchomić rozszerzenie ponownie i wybrać Authenticate.
CursorDodaj JSON poniżej do ~/.cursor/mcp.json lub projektowego .cursor/mcp.json, zachowując istniejące wpisy. Włącz nudgelink i zaloguj się przez OAuth w przeglądarce.
VS Code / GitHub CopilotW palecie poleceń wybierz MCP: Add Server → HTTP, wpisz adres i nazwę nudgelink, zapisz. Uruchom serwer, potwierdź zaufanie i zaloguj się. Włącz narzędzia w Copilot Chat.
Gemini CLIUruchom polecenie poniżej; w Gemini wpisz /mcp auth nudgelink i zatwierdź połączenie w przeglądarce. Potrzebna jest lokalna sesja obsługująca powrót z przeglądarki.
Inny klientDodaj zdalny serwer Streamable HTTP z tym samym adresem. Potrzebne są OAuth discovery, authorization code z PKCE i DCR. Wybierz automatyczną rejestrację i logowanie w przeglądarce. Jeśli klient nie obsługuje OAuth, użyj jednego z powyższych.

Polecenia i JSON w sekcji Configuration są wspólne dla wszystkich języków. Oficjalne źródła są podlinkowane w angielskiej tabeli. Po połączeniu zapytaj: „Z którym kontem NudgeLink jestem połączony?” — bez wyszukiwania i zużywania kredytów. Dostęp do wyszukiwania LinkedIn i odłączenie: Ustawienia → Integracje → Połączeni asystenci AI. Odłączenie blokuje nowe wywołania narzędzi i odnowienie tokenu. Już rozpoczęte zadania mogą się zakończyć. Ponowne połączenie wymaga nowej zgody. MCP nie wysyła wiadomości ani zaproszeń i nie zatwierdza szkiców. Wysyłka odbywa się zgodnie z ustawieniami kampanii i zatwierdzania w NudgeLink.

Русский — подключение

Адрес: https://api.nudgelink.co/mcp. Выберите Streamable HTTP и OAuth. Адрес и управление подключениями: Настройки → Интеграции → Подключённые AI-ассистенты. Войдите в NudgeLink в браузере и проверьте разрешения. Копировать токен или API-ключ не нужно; если клиент предлагает выбор, используйте автоматическую регистрацию OAuth (DCR). Доступность зависит от версии, тарифа и правил организации. Инструкции проверены по документации; реальное подключение в каждом клиенте не тестировалось.

КлиентПодключение
ChatGPTPlugins → + → Add custom MCP server: введите NudgeLink и адрес, выберите OAuth, создайте и установите плагин. Войдите в NudgeLink; выберите плагин через @ в чате Work.
Claude web / DesktopCustomize → Connectors → + Add → Add custom connector: введите адрес, выберите Sign in now и Register automatically, подтвердите разрешения. В чате включите + → Connectors. В Team/Enterprise уполномоченный владелец сначала добавляет сервер через Organization settings → Connectors → Add → Custom → Web.
Claude CodeВыполните команду ниже, затем в Claude Code откройте /mcp, выберите nudgelink и войдите в браузере.
Codex CLI / IDEВыполните обе команды Codex ниже. В IDE также можно выбрать gear → MCP servers → Add server → Streamable HTTP, ввести адрес, сохранить, перезапустить расширение и нажать Authenticate.
CursorДобавьте JSON ниже в ~/.cursor/mcp.json или проектный .cursor/mcp.json, сохранив существующие записи. Включите nudgelink и пройдите OAuth-вход в браузере.
VS Code / GitHub CopilotВ палитре команд выберите MCP: Add Server → HTTP, введите адрес и имя nudgelink, сохраните. Запустите сервер, подтвердите доверие и войдите в браузере. Включите инструменты в Copilot Chat.
Gemini CLIВыполните команду ниже; внутри Gemini введите /mcp auth nudgelink и подтвердите подключение в браузере. Нужна локальная сессия, принимающая перенаправление из браузера.
Другой клиентДобавьте удалённый сервер Streamable HTTP с тем же адресом. Нужны OAuth discovery, authorization code с PKCE и DCR. Выберите автоматическую регистрацию и вход в браузере. Если OAuth не поддерживается, используйте один из клиентов выше.

Команды и JSON общие для всех языков: Configuration. Ссылки на официальную документацию находятся в английской таблице. После подключения спросите: «К какому аккаунту NudgeLink я подключён?» — без запуска поиска и расхода кредитов. Доступ к поиску LinkedIn и отключение: Настройки → Интеграции → Подключённые AI-ассистенты. Отключение блокирует новые вызовы инструментов и обновление токена. Уже запущенные задачи могут завершиться. Повторное подключение требует нового согласия. MCP не отправляет сообщения и приглашения и не одобряет черновики. Отправка выполняется по настройкам кампании и одобрения в NudgeLink.

Configuration

Claude Code

claude mcp add --transport http nudgelink https://api.nudgelink.co/mcp

Codex CLI

codex mcp add nudgelink --url https://api.nudgelink.co/mcp
codex mcp login nudgelink

Cursor — merge with existing mcpServers entries:

{
  "mcpServers": {
    "nudgelink": {
      "url": "https://api.nudgelink.co/mcp"
    }
  }
}

Gemini CLI

gemini mcp add --transport http nudgelink https://api.nudgelink.co/mcp

What it can do

Ask forToolPermission
Your leads, filtered by campaignlist_leadsSee your prospects
Campaign performance: invites, acceptances, replies, reply rateget_campaign_statsSee campaign performance
Recent replies and who sent themget_inboxRead replies
Your campaigns and their targetinglist_campaignsSee campaign performance
What a Scout run would search for and cost, without running itpreview_web_scoutSee search results
Find people with Scout (Scale plan): by job title, at a list of companies, or at companies like your examplesstart_web_scoutStart searches — spends credits
Status and results of a searchget_search_resultsSee search results
Add found people to your leadsadd_to_leadsAdd people to your leads (sends nothing; a Scout find you have not paid for yet uses 3 credits)
A connection note or first message for a leaddraft_messageWrite drafts (not saved or sent)
Which NudgeLink account this connection usesget_profileIncluded with any permission

Scout from an assistant (preview_web_scout, start_web_scout) can be switched off for assistants. When it is, the assistant tells you so, and you can run Scout in NudgeLink under Leads → Scout.

Searches cost the same credits as in the app, and the same limits apply: one search at a time, your plan, and your credit balance. An assistant can also start at most 10 Scout runs, 15 LinkedIn searches and 30 drafts an hour. People you add go into the campaign of the search that found them. Outreach only starts when you start that campaign in NudgeLink.

LinkedIn searches from an assistant are off by default

Two things use your connected LinkedIn account and are off for every assistant until you turn them on:

  • LinkedIn lead search (start_lead_search);
  • confirming Scout's web finds against LinkedIn.

To allow them for one assistant, go to Settings → Integrations → Connected AI assistants and tick Allow LinkedIn searches from this assistant. They use your account's daily limits and your credits. Scout still works without this: people found directly as LinkedIn profiles are ready to add, and the rest wait in "Check by hand" for you to check.

Disconnect

Go to Settings → Integrations → Connected AI assistants and press Disconnect. New tool calls and token renewal are blocked after disconnect completes. Work already running may finish. Reconnecting requires fresh consent and does not restore access for old tokens.

Privacy

What the assistant can see, and who processes it, is covered in section 4 of our Privacy Policy. In short: tool results go to your assistant's provider (for example, Anthropic, OpenAI, Google or your editor’s provider), and NudgeLink never stores your conversations.

Troubleshooting

You seeWhyFix
"This connection was not granted …"The connection predates a new permissionDisconnect, then connect again
"LinkedIn search from an AI assistant is off"The LinkedIn opt-in is off for this assistantTurn it on in Settings → Integrations, or ask for a Scout search instead
"Scout is not enabled for this account"Scout is a Scale-plan featureUpgrade, or use LinkedIn search with the opt-in
"A search is already in progress"One search at a timeAsk for the results of the current run first
"Scout isn't available from AI assistants on this connection"Scout is switched off for assistantsRun Scout in NudgeLink under Leads → Scout