Artykuły na: Wyszukiwanie i korzystanie z leadów

Połącz Leadscraper ze swoim AI przez MCP

Możesz połączyć Leadscraper bezpośrednio ze swoim klientem AI – na przykład z Claude (Desktop i Web), ChatGPT (Custom GPTs), Cursor lub własnym agentem. Wtedy uruchamiasz wyszukiwania leadów, sprawdzasz ich status, pobierasz leady i sprawdzasz stan Credits, nawet nie otwierając Leadscraper – po prostu w rozmowie ze swoim AI.


Umożliwia to MCP (Model Context Protocol) – otwarty standard, przez który klienci AI bezpiecznie rozmawiają z zewnętrznymi narzędziami. Leadscraper udostępnia dla tego własny serwer MCP.


Co z tego masz


  • Research bezpośrednio z Twojego workflow AI. „Znajdź mi 10 stolarni w Bawarii" – i Twój AI uruchamia Run w Leadscraper i przynosi Ci wyniki.
  • Brak przełączania narzędzi. Wyszukiwanie, status i leady dzieją się tam, gdzie i tak pracujesz.
  • Twoje konto, Twoje zasady. Credits są rozliczane normalnie (1 Credit za dostarczony lead).


Wymagania


  • Konto Leadscraper.
  • Klient AI obsługujący MCP (np. Claude.ai, Claude Desktop, ChatGPT lub Cursor).


Droga 1 – Połącz Claude.ai (Web) przez OAuth (najszybsza droga)


Dla Claude.ai w przeglądarce nie potrzebujesz żadnego tokena. Cały proces trwa poniżej minuty.


Krok 1 – Otwórz kartę integracji


  1. Zaloguj się na my.leadscraper.de.
  2. Kliknij w prawym górnym rogu swój profil → Ustawienia konta (Account settings) → Integracje (Integrations).
  3. Na karcie Leadscraper as MCP server kliknij Połącz z Claude (Connect to Claude).


Przez „Connect to Claude" uruchamiasz połączenie OAuth – token nie jest potrzebny dla Claude.ai.


Krok 2 – Skopiuj URL serwera i dodaj connector w Claude


Okno pokazuje Ci URL Twojego serwera MCP (https://mcp.leadscraper.eu/mcp) z przyciskiem kopiowania. Następnie:


  1. Kliknij Otwórz connectory Claude ↗ (Open Claude connectors) – albo otwórz bezpośrednio w Claude Ustawienia → Connectors → Dodaj własny connector (Settings → Connectors → Add custom connector).
  2. Wklej URL serwera i potwierdź.
  3. Claude przekieruje Cię na stronę zgody Leadscraper (Allow-Screen) – kliknij Allow.


Jesteś już zalogowany/a w Leadscraper? Wtedy na stronie zgody wystarczy jedno kliknięcie – bez osobnego hasła. Jeśli Claude nie przekieruje Cię automatycznie z powrotem, po prostu przełącz się na swoją kartę Claude – connector zwykle już tam pokazuje się jako połączony.


Krok 3 – Sprawdź połączenie


Zapytaj Claude np.:


  • „List my leadscraper profiles"
  • „What's my leadscraper credit balance?"


Jeśli Claude odpowie Twoimi prawdziwymi danymi konta, połączenie jest aktywne.


Droga 2 – Ręczny token (Claude Desktop, Cursor, własny agent)


Skorzystaj z tej drogi, jeśli wolisz token typu bearer albo Twój klient (jeszcze) nie obsługuje OAuth – np. Claude Desktop, Cursor lub własne SDK agenta.


  1. Na stronie Integracji kliknij obok Połącz z Claude przycisk Generuj token (Generate token).
  2. W oknie Connect an AI client (Połącz klienta AI) wpisz nazwę (np. „Claude Desktop") i kliknij Generuj token (Generate token).


Przez „Generate token" tworzysz nazwany token (np. „Claude Desktop") – jest wyświetlany tylko raz.


  1. Skopiuj token natychmiast i przechowuj go bezpiecznie. Ze względów bezpieczeństwa jest wyświetlany tylko raz.
  2. Wpisz go razem z URL serwera do konfiguracji swojego klienta.


{
  "mcpServers": {
    "leadscraper": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.leadscraper.eu/mcp",
        "--header",
        "Authorization: Bearer <TWÓJ_TOKEN>"
      ]
    }
  }
}


Uruchom ponownie swojego klienta i sprawdź, czy pojawia się ikona narzędzi – wtedy połączenie jest aktywne.


URL serwera: https://mcp.leadscraper.eu/mcp


Ważność tokena: Ręczne tokeny wygasają automatycznie po 90 dniach. Na stronie Integracji przy każdym tokenie widzisz link Revoke, żeby odwołać go wcześniej – np. gdy już go nie potrzebujesz albo mógł zostać skompromitowany.


Co możesz robić przez AI


Aktualnie dostępnych jest sześć narzędzi:


Narzędzie

Co robi

list_profiles

Wyświetla listę Twoich profili wyszukiwania.

create_profile

Tworzy nowy profil wyszukiwania.

create_lead_search

Uruchamia nowe wyszukiwanie leadów dla istniejącego profilu.

get_search_status

Pokazuje, czy bieżący Run jest już gotowy.

list_leads

Pobiera leady profilu – z tymi samymi danymi, które widzisz też w produkcie.

get_credit_balance

Pokazuje Twój aktualny stan Credits.


W praktyce po prostu rozmawiasz ze swoim AI – np. „Uruchom wyszukiwanie elektryków w Hamburgu i pokaż mi wyniki, gdy tylko będą gotowe." AI w tle wywołuje właściwe narzędzia.


Aktualnie tylko odczyt + wyszukiwanie: Akcje, które zużywają dodatkowe Credits na research kontaktów albo przesyłają dane do CRM (np. połączenie z Pipedrive/HubSpot, tworzenie e-maili outreach), są celowo jeszcze zablokowane, dopóki nie pojawi się osobny krok potwierdzenia wydatków. Te narzędzia zostaną odblokowane bez konieczności ponownego konfigurowania połączenia.


Credits i bezpieczeństwo


  • Credits: Wyszukiwanie zużywa Credits jak zwykle – jeden Credit za dostarczony lead. Bez względu na to, jak zachowuje się Twój AI: na token lub połączenie obowiązują limity ochronne, żeby nic niechcący nie przeszło.
  • Dostęp: Połączenie ma dostęp wyłącznie do Twojego konta, jest przechowywane zaszyfrowane i można je odwołać w każdej chwili (Revoke).
  • Ważność: Połączenia OAuth (Claude.ai) trwają ~30 dni i są automatycznie odnawiane przez Claude. Ręczne tokeny wygasają po 90 dniach.
  • Komunikaty błędów: Jeśli wywołanie narzędzia się nie powiedzie, Claude pokazuje konkretny powód (np. za mało Credits, nieprawidłowe zapytanie) zamiast ogólnego błędu.
  • Twój normalny login pozostaje nienaruszony – połączenie MCP działa zupełnie równolegle do niego.


Rozwiązywanie problemów


„Add custom connector" nie akceptuje pola na token?
To normalne – flow connectorów Claude dla własnych connectorów działa wyłącznie przez OAuth. Po prostu wklej URL serwera i potwierdź na stronie Allow, token nie jest potrzebny.


Brakuje mi narzędzi w porównaniu z wcześniej?
Jeśli wcześniej byłeś/aś połączony/a przez token, możesz widzieć tylko sześć narzędzi wymienionych powyżej. Narzędzia zużywające więcej Credits i przesyłające dane do CRM są celowo wyłączone, dopóki krok potwierdzenia wydatków nie zostanie uruchomiony.


Connector rozłącza się po jednym dniu?
To był znany problem z krótkotrwałymi tokenami i został naprawiony – połączenia OAuth trwają teraz ~30 dni. Jeśli u Ciebie nadal zdarza się to codziennie, zgłoś się po prostu przez czat w aplikacji.


Najczęstsze pytania


Czy potrzebuję wiedzy programistycznej?
Dla Claude.ai nie: wystarczy kliknięcie „Połącz z Claude", token nie jest potrzebny. Dla innych klientów tworzysz token i wpisujesz go razem z URL serwera do konfiguracji klienta.


Co jeśli straciłem/am token?
Żaden problem: odwołaj stary przez Revoke i utwórz nowy. Ze względów bezpieczeństwa istniejącego tokena nie można ponownie wyświetlić.


Czy samo połączenie już kosztuje Credits?
Nie. Credits kosztuje tylko rzeczywiście uruchomione wyszukiwanie lub research kontaktów – dokładnie jak w produkcie.


Które klienty AI są obsługiwane?
Claude (Desktop i Web), ChatGPT (Custom GPTs), Cursor i każdy inny klient obsługujący MCP, m.in. przez własne SDK agenta.


Czy mogę nadal normalnie korzystać z Leadscraper w przeglądarce?
Tak, bez ograniczeń. MCP to dodatkowa droga, nie zastępstwo.

Aktualizowane na: 31/07/2026

Czy ten artykuł był pomocny?

Podziel się swoją opinią

Anuluj

Dziękuję!