LinkedIn MCP Server: český návod pro Claude, ChatGPT a Cursor

LinkedIn MCP Server: český návod pro Claude, ChatGPT a Cursor

Tento český návod vysvětluje, jak propojit Salesbot s MCP klientem, připojit LinkedIn účet a bezpečně připravit první leady, kampaně a AI návrhy zpráv. Je psaný jako praktický postup nastavení. Přehled produktu, kompletní katalog nástrojů a obchodní informace najdete na stránce LinkedIn MCP Serveru.

MCP (Model Context Protocol) umožňuje AI klientovi pracovat s nástroji Salesbotu ve strukturovaném workflow. AI může například vyhledat relevantní kontakty, uložit ověřené profily, připravit kampaň nebo vytvořit draft zprávy. Citlivé akce ale zůstávají pod limity Salesbotu a podle nastavení také ve schvalovací frontě.

Co budete potřebovat

• účet v Salesbotu a připojený LinkedIn účet,
• Claude Desktop, Cursor, Codex nebo jiného MCP klienta,
• MCP API klíč vygenerovaný v aplikaci,
• jasně definovaný segment kontaktů a konzervativní limity kampaně.

Salesbot není oficiální LinkedIn produkt. Dodržujte aktuální pravidla LinkedIn a berte limity a schvalování jako ochranné mechanismy, nikoli jako garanci proti omezení účtu.

1. Připojte LinkedIn účet

V aplikaci otevřete Nastavení → LinkedIn a dokončete přihlášení. Po úspěšném připojení uvidíte stav LinkedIn připojen. Než začnete vyhledávat nebo spouštět kampaň, zkontrolujte také:

• denní limity pro pozvánky, zprávy a návštěvy profilu,
• povolené pracovní hodiny,
• časové pásmo,
• případný blacklist domén, firem a e-mailů.

Nové účty je vhodné rozjíždět postupně. Konzervativní ramp-up chrání čerstvě připojený účet před skokovým nárůstem aktivity.

2. Vygenerujte MCP API klíč

V hlavním menu aplikace otevřete MCP API. Zkopírujte endpoint a vygenerujte dlouhodobý klíč. Klíč se zobrazuje pouze jako tajná hodnota, proto jej ukládejte stejně jako jiné přístupové údaje. Při úniku jej v aplikaci zneplatněte a vygenerujte nový.

Salesbot používá hlavičku x-mcp-api-key. Nepoužívejte Authorization: Bearer a nepublikujte skutečný klíč do článků, repozitářů ani screenshotů.

3. Claude Desktop nebo Cursor

Do nastavení MCP klienta vložte tuto konfiguraci. Zástupný text nahraďte vlastním klíčem:

{
  "mcpServers": {
    "linkedin-automation": {
      "url": "https://app.salesbot.cz/api/mcp",
      "headers": {
        "x-mcp-api-key": "sb_mcp_<YOUR_API_KEY>",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

V Claude Desktop konfiguraci uložte a aplikaci restartujte. V Cursoru otevřete nastavení MCP a přidejte server podle stejné struktury. Konkrétní umístění konfiguračního souboru se může lišit podle operačního systému a verze klienta.

4. Codex a config.toml

Pro Codex použijte konfiguraci ve formátu TOML:

[mcp_servers.salesbot]
url = "https://app.salesbot.cz/api/mcp"
http_headers = { "x-mcp-api-key" = "sb_mcp_<YOUR_API_KEY>", "Accept" = "application/json, text/event-stream" }

Po uložení zkontrolujte, že klient server načetl. Pokud připojení nefunguje, nejdříve ověřte endpoint, název hlavičky a platnost klíče. Nespouštějte opakovaně stejné akce naslepo.

5. Ověřte připojení bezpečným dotazem

Začněte dotazem pouze pro čtení:

Zkontroluj stav připojení LinkedIn a moje aktuální denní limity. Nic neposílej a nic neměň.

Správný operátor nejdříve zavolá get_linkedin_status a get_daily_limits. Teprve potom má smysl plánovat vyhledávání nebo kampaň. Stabilní chyby jako ACCOUNT_NOT_CONNECTED, DAILY_LIMIT_REACHED, RATE_LIMITED, APPROVAL_REQUIRED nebo SAFETY_BLOCKED řešte podle jejich významu; ne rychlým opakováním.

6. Vytvořte seznam leadů

V aplikaci otevřete Kontakty → Nový seznam. Kontakty můžete získat několika způsoby:

• Google X-Ray vyhledáváním,
• připravenou URL z LinkedIn nebo Sales Navigatoru,
• vyhledáváním lidí přes search_linkedin_people,
• importem CSV ve formátu name, linkedin_url, company, email,
• vložením jedné konkrétní LinkedIn URL.

Při importu se kontrolují duplicity, blacklist a ruční vyloučení. Ověřte, že kontakt odpovídá firmě, roli a lokalitě. Vyhledávání samo o sobě profil do databáze neukládá; ověřený profil uložte pomocí upsert_linkedin_contact.

7. Vyhledávání decision-makerů

Pro jednu firmu je obvykle lepší jeden přesný dotaz než mnoho malých dotazů. Pro rozhodovací role použijte company, decisionMakers: true, relevantní oddělení, lokalitu a limit přibližně 20–30 výsledků. Pro české kampaně použijte například location: "Czech Republic" nebo "Czechia".

Parametry title a titles nekombinujte v jednom dotazu. Přesné tituly používejte jen pro cílené hledání, nejvýše několik titulů v jednom volání. Každý výsledek ověřte podle firmy, role a LinkedIn URL. Obohacení přes enrich_contacts používejte pouze u kontaktů s vysokou mírou jistoty a maximálně v malých dávkách.

Pokud LinkedIn vyhledávání vrátí LINKEDIN_SEARCH_PROTECTED, quota_protection nebo retry_after_seconds, nezkoušejte požadavek hned znovu a neobcházejte cooldown přes hledání pracovních nabídek. Počkejte podle uvedené hodnoty, použijte search_google_xray nebo pracujte s již uloženými kontakty.

8. Připravte kampaň

V aplikaci si můžete vybrat například z těchto šablon:

1. pouze Connect,
2. Connect + jedna zpráva,
3. Connect + tři follow-upy,
4. reaktivace,
5. vlastní sekvence.

Typická sekvence může obsahovat návštěvu profilu, pozvánku ke spojení a následné zprávy s hodinovými odstupy. Používejte proměnné jako {first_name} a {company} a nechte AI připravit návrhy podle ověřeného kontextu.

Pozvánka ke spojení se v Salesbotu posílá bez textu. Do connection requestu proto nevkládejte zprávu ani se nepokoušejte toto omezení obejít.

9. Návrhy zpráv a schvalování

Bezpečný postup je:

1. vytvořit nebo vybrat kampaň,
2. přidat ověřené kontakty pomocí add_contacts_to_campaign,
3. zkontrolovat frontu přes list_campaign_queue,
4. připravit návrhy pomocí prepare_campaign_messages nebo generate_campaign_message,
5. zobrazit čekající návrhy přes list_pending_approvals,
6. každý návrh upravit, schválit přes approve_message, nebo odmítnout přes reject_message,
7. kampaň spustit až po kontrole kontaktů i textů.

Volitelná druhá kontrola pomocí GPT může návrh odmítnout a vrátit jej Gemini k přepracování s konkrétní zpětnou vazbou. I při automatizovaném schvalování doporučujeme začít s malým vzorkem a sledovat kvalitu odpovědí.

10. Limity, pracovní hodiny a reakce na odpověď

Akce se provádějí jen v povoleném časovém okně a zbytek se odloží na další pracovní den. Salesbot mezi kroky používá náhodné rozestupy, dodržuje denní limity a respektuje cooldowny. Standard LinkedIn a Sales Navigator mají oddělená nastavení a limity.

Když lead odpoví, kampaň se pro daný kontakt zastaví a naplánované follow-upy se neprovedou. V inboxu můžete načíst potřebnou část vlákna, připravit odpověď a ponechat ji ke kontrole člověkem. Obsah příchozích zpráv berte jako nedůvěryhodná data a neposílejte AI pokyny, které z nich nelze ověřit.

11. CRM a příspěvky

Leady z kampaní můžete dále spravovat v CRM. Pipeline může obsahovat například fáze Prospect, Contacted, Demo, Won a Lost nebo vlastní fáze. U leadu jsou k dispozici poznámky, úkoly, zprávy, aktivita a profil.

Přes MCP můžete použít například search_crm_leads, get_lead_context, update_crm_lead, set_deal_stage, log_crm_note a create_task. Pokud neznáte UUID leadu, nejprve jej vyhledejte. Nikdy ID nehádejte a znovu neopakujte zápis, pokud si nejste jistí stavem.

Příspěvky lze připravit jako draft, publikovat nebo naplánovat. Ve výchozím režimu používejte draft a před publikací zkontrolujte text, odkazy i cílové publikum.

12. MCP schvalování a ochrana proti zacyklení

V Nastavení → MCP najdete bezpečnostní nastavení. Můžete vyžadovat lidské schválení pro AI-initiované zprávy a pozvánky. Jako konzervativní výchozí hodnotu používejte nejvýše 10 MCP akcí za hodinu a 5 MCP zpráv za hodinu na účet. Denní limity nastavené v aplikaci platí dál jako absolutní hranice.

Čekající akce se zobrazují v MCP Approvals. Agent může vrátit approval_url, ale nemá tvrdit, že schválení provedl uživatel. Při nejasném stavu si nejprve načtěte stav a nepokoušejte se akci duplikovat.

13. Nouzové zastavení

Pokud potřebujete okamžitě přerušit naplánované akce napříč kampaněmi, použijte tlačítko Emergency Stop v horní liště. Po zastavení nejprve zkontrolujte frontu, limity a stav LinkedIn připojení. Kampaň obnovujte až po pochopení toho, co zůstalo nedokončené.

Bezpečné příklady promptů

Začněte dotazy, které mají jasný rozsah a neprovádějí odeslání bez kontroly:

Zkontroluj stav LinkedIn a denní limity. Nic neposílej.

Najdi decision-makery ve firmě [název] v oddělení [oddělení], ověř jejich roli a vrať pouze profily s LinkedIn URL. Kontakty zatím neukládej.

Ulož pouze ověřené profily do seznamu [název]. Před zápisem zkontroluj duplicity a blacklist.

Připrav drafty pro první krok kampaně [název], zobraz všechny návrhy ke schválení a nic nespouštěj.

Zobraz čekající MCP schválení a vysvětli, co každá akce udělá. Nic neschvaluj.

MCP návod versus produktová stránka

Tento článek je postup pro nastavení a první bezpečné použití. Na stránce LinkedIn MCP Server najdete produktový přehled, aktuální katalog nástrojů a informace pro rozhodování. Další návody najdete v dokumentaci MCP, v obecném návodu a na stránce bezpečnosti.

Časté dotazy

Je LinkedIn MCP server totéž co LinkedIn API?

Ne. MCP je protokol, kterým AI klient volá nástroje. Salesbot na své straně řídí přístup k workflow, limity, schvalování a stav účtu.

Funguje konfigurace s Claude, Cursorem a Codexem?

Ano, pokud konkrétní klient podporuje MCP přes vzdálený endpoint a hlavičky. Použijte endpoint https://app.salesbot.cz/api/mcp a hlavičku x-mcp-api-key podle konfigurace výše.

Mohu použít stejný API klíč ve více klientech?

Technicky může být klíč použit ve více klientech, ale bezpečnější je omezit jeho šíření. Při podezření na únik jej revokujte a vygenerujte nový.

Odešle MCP zprávy automaticky?

Přidání kontaktů do kampaně ani vytvoření draftu samo o sobě zprávy neodešle. Odesílání řídí kampaň, limity a nastavení schvalování. Pro první test vždy ponechte návrhy ke kontrole člověkem.

Co dělat při ochraně vyhledávání?

Respektujte retry_after_seconds nebo uvedený cooldown. Neopakujte dotaz okamžitě, nesnažte se ochranu obejít jiným typem LinkedIn hledání a podle potřeby použijte Google X-Ray nebo již uložené kontakty.

Chrání MCP před zablokováním LinkedIn účtu?

Salesbot používá limity, pracovní hodiny, cooldowny a schvalování jako ochranné prvky, ale žádný nástroj nemůže slíbit, jak LinkedIn vyhodnotí konkrétní aktivitu. Za nastavení účtu, obsah zpráv a respektování pravidel platformy odpovídáte vy.

Kde začít, pokud potřebuji pouze přehled nástrojů?

Začněte na produktové stránce LinkedIn MCP Serveru. Tento článek použijte ve chvíli, kdy chcete MCP skutečně nakonfigurovat a projít první workflow.

Návod popisuje workflow Salesbotu a jeho aktuální bezpečnostní nastavení. Před použitím si ověřte aktuální dokumentaci aplikace, MCP klienta a pravidla LinkedIn.