> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.leadscraper.eu/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.](https://public.deimann.io/img/help-ls/mcp_connect_step-01.png)

### 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.](https://public.deimann.io/img/help-ls/mcp_connect_step-02.png)

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

```json
{
  "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.