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.
| Client | Setup |
|---|---|
| ChatGPT | Plugins → + → 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 / Desktop | Customize → 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 Code | Run its command in Configuration; open /mcp in Claude Code, select nudgelink, and authenticate in the browser. Official guide. |
| Codex CLI / IDE | Run 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. |
| Cursor | Merge 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 Copilot | Run 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 CLI | Run 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 clients | Add 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.
| Klient | Konfiguracja |
|---|---|
| ChatGPT | Plugins → + → 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 / Desktop | Customize → 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 Code | Uruchom polecenie poniżej, potem wpisz /mcp w Claude Code, wybierz nudgelink i zaloguj się w przeglądarce. |
| Codex CLI / IDE | Uruchom 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. |
| Cursor | Dodaj 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 Copilot | W 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 CLI | Uruchom 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 klient | Dodaj 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). Доступность зависит от версии, тарифа и правил организации. Инструкции
проверены по документации; реальное подключение в каждом клиенте не тестировалось.
| Клиент | Подключение |
|---|---|
| ChatGPT | Plugins → + → Add custom MCP server: введите NudgeLink и адрес, выберите OAuth, создайте и установите плагин. Войдите в NudgeLink; выберите плагин через @ в чате Work. |
| Claude web / Desktop | Customize → 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 for | Tool | Permission |
|---|---|---|
| Your leads, filtered by campaign | list_leads | See your prospects |
| Campaign performance: invites, acceptances, replies, reply rate | get_campaign_stats | See campaign performance |
| Recent replies and who sent them | get_inbox | Read replies |
| Your campaigns and their targeting | list_campaigns | See campaign performance |
| What a Scout run would search for and cost, without running it | preview_web_scout | See search results |
| Find people with Scout (Scale plan): by job title, at a list of companies, or at companies like your examples | start_web_scout | Start searches — spends credits |
| Status and results of a search | get_search_results | See search results |
| Add found people to your leads | add_to_leads | Add 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 lead | draft_message | Write drafts (not saved or sent) |
| Which NudgeLink account this connection uses | get_profile | Included 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 see | Why | Fix |
|---|---|---|
| "This connection was not granted …" | The connection predates a new permission | Disconnect, then connect again |
| "LinkedIn search from an AI assistant is off" | The LinkedIn opt-in is off for this assistant | Turn it on in Settings → Integrations, or ask for a Scout search instead |
| "Scout is not enabled for this account" | Scout is a Scale-plan feature | Upgrade, or use LinkedIn search with the opt-in |
| "A search is already in progress" | One search at a time | Ask for the results of the current run first |
| "Scout isn't available from AI assistants on this connection" | Scout is switched off for assistants | Run Scout in NudgeLink under Leads → Scout |