Jak dodać MCP do Claude krok po kroku (na przykładzie BaseLinkera)

Ta wtyczka to konektor MCP. Pokażę, jak go dodać do Claude na przykładzie BaseLinkera. Całość zajmuje około 10 minut i robisz to raz. Jeśli wolisz najpierw zrozumieć, czym jest MCP i po co to wszystko, mam o tym osobny wpis: Co to jest MCP i co daje Twojemu sklepowi.

Ważne: te same kroki pasują do każdego konektora MCP. Zmienia się tylko plik wtyczki i klucz, który podajesz. Nauczysz się tego raz i podłączysz potem dowolne narzędzie, które MCP obsługuje.

Nie musisz się na tym znać

To brzmi jak coś dla programistów, ale nie jest. Cała sztuczka polega na tym, że w razie problemu pomaga Ci sama AI. Jeśli coś nie zaskoczy, wklejasz Claude komunikat błędu albo swój plik konfiguracyjny i piszesz „nie działa, pomóż mi to naprawić". Claude czyta, co poszło nie tak, i prowadzi Cię krok po kroku.

Innymi słowy, narzędzie, które instalujesz, jest jednocześnie Twoim wsparciem technicznym. Niżej w artykule daję kilka gotowych promptów, które się przydają przy konfiguracji i testowaniu.

Czego potrzebujesz

• Aplikacja Claude Desktop (Mac lub Windows).
• Token API do narzędzia, które podłączasz. W tym przykładzie token BaseLinkera (tylko do odczytu, pokażę skąd go wziąć).

Instalacja krok po kroku

Krok 1. Zainstaluj „uv" (jednorazowo)

To mały program, dzięki któremu wtyczka uruchamia się na każdym systemie i sama dba o swoje zależności. Robisz to raz, potem masz z głowy przy każdym kolejnym konektorze.

Na Macu otwórz Terminal (Cmd + Spacja, wpisz „Terminal"), wklej i naciśnij Enter:

curl -LsSf https://astral.sh/uv/install.sh | sh

Na Windowsie otwórz PowerShell (menu Start, wpisz „PowerShell"), wklej i naciśnij Enter:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Krok 2. Skopiuj token z BaseLinkera

Zaloguj się do BaseLinkera, wejdź w Moje konto → API i skopiuj albo wygeneruj token. Trzymaj go pod ręką, wkleisz go za chwilę przy konfiguracji wtyczki.

Krok 3. Pobierz plik wtyczki

Pobierz plik baselinker-mcp.mcpb ze strony projektu (sekcja Releases): github.com/NorbertSo/baselinker-mcp.

Krok 4. Zainstaluj w Claude

Otwórz Claude Desktop, wejdź w Settings → Extensions i przeciągnij pobrany plik .mcpb (albo kliknij „Install Extension").

Zobaczysz opis wtyczki i przycisk Install. Pojawi się też ostrzeżenie, że rozszerzenie nie jest weryfikowane przez Anthropic. Przy własnych rozszerzeniach spoza oficjalnego katalogu to normalne. Instalujesz, bo znasz źródło.

Potwierdź instalację.

Krok 5. Wklej token i włącz

Kliknij Configure, wklej token z kroku 2 i zapisz. Następnie przestaw przełącznik na Enabled.

Krok 6. Zrestartuj Claude i zapytaj

Zamknij Claude całkowicie (Mac: Cmd + Q) i otwórz ponownie. Potem zapytaj zwykłym językiem, na przykład „Ile mam dziś zamówień?". Jeśli wróci odpowiedź z danymi z Twojego sklepu, gotowe.

Prompty, które pomogą przy konfiguracji

Te zdania możesz wkleić Claude wprost. Pierwsze trzy sprawdzają, czy połączenie żyje. Ostatnie ratują Cię, gdy coś nie działa.

• Test połączenia: „Połącz się z moim BaseLinkerem i pokaż liczbę zamówień z dzisiaj."
• Sprawdzenie możliwości: „Co potrafisz odczytać z mojego BaseLinkera? Wypisz dostępne dane."
• Pierwszy sensowny raport: „Pokaż statusy moich zamówień z tego tygodnia w rozbiciu na kanały sprzedaży."
• Gdy wyskoczy błąd: skopiuj treść błędu z Terminala albo z Claude i wklej z dopiskiem „to mi wyskoczyło przy instalacji wtyczki BaseLinker, wytłumacz po ludzku, co zrobić."
• Gdy nie wiesz, co dalej: „Zainstalowałem konektor MCP do BaseLinkera, ale Claude go nie widzi. Przeprowadź mnie po kolei, co sprawdzić."

Z tym podejściem nie musisz znać żadnych komend. Opisujesz problem własnymi słowami, a Claude tłumaczy następny ruch.

Dobre pierwsze pytania do sklepu

Jak już działa, warto od razu zobaczyć, co to daje. Kilka przykładów:

• „Które bestsellery zaraz się skończą na stanie?"
• „Pokaż zamówienia, które najdłużej czekają na wysyłkę."
• „Jaki miałem przychód w zeszłym miesiącu i co schodziło najlepiej?"
• „Wypisz zamówienia w trakcie zwrotu albo reklamacji."

Ograniczenia, o których warto wiedzieć

Żeby było uczciwie, kilka rzeczy z góry, bo wynikają z tego, jak działa samo API BaseLinkera.

Zamówienia przez API sięgają około 90 dni wstecz. Starsze trafiają do archiwum BaseLinkera i tą drogą nie da się ich pobrać. Do bieżącej pracy (co się dzieje teraz, co wymaga uwagi, ostatni kwartał) to wystarcza, ale historii sprzed kwartału z samych zamówień nie wyciągniesz.

Dokumenty (faktury i paragony) sięgają dalej wstecz, więc historyczny przychód liczę właśnie z nich. Jest tu jednak drugie ograniczenie, tym razem po stronie AI: im większy zakres danych pobierasz naraz, tym więcej zajmuje to czasu i pamięci modelu. Bardzo długie okresy lepiej dzielić na mniejsze (np. miesiąc po miesiącu), zamiast prosić o wszystko jednym pytaniem.

To wersja tylko do odczytu (i co, jeśli chcesz więcej)

Mój konektor BaseLinkera jest celowo tylko do odczytu. AI może Twoje dane czytać, ale niczego w sklepie nie zmieni. Do bezpiecznego pytania o sklep i raportów to właściwy wybór, bo nic nie ruszy przez pomyłkę.

Czasem jednak chcesz, żeby AI nie tylko czytała, ale i pracowała na danych. Na przykład masowo poprawiła opisy ofert, podmieniła fragment w setkach produktów naraz, zaktualizowała ceny albo statusy. To wymaga wersji z zapisem, przygotowanej pod konkretny przypadek i z zabezpieczeniami (potwierdzanie zmian, dziennik tego, co zostało zmienione). Jeśli tego potrzebujesz, napisz do mnie, ustawię to pod Twój sklep.

Bezpieczeństwo w skrócie

Token podajesz raz, przy konfiguracji, i zostaje na Twoim komputerze. Konektor czyta dane przez oficjalne API BaseLinkera, nic nie wysyła na zewnątrz. Instaluj wtyczki tylko ze źródeł, które znasz. Kod mojego konektora jest jawny na GitHubie, możesz go sprawdzić albo dać komuś do sprawdzenia.

Najczęstsze pytania

Na koniec

Sam konektor to początek. Buduję na nim agenta operacyjnego dla sklepów: codzienny brief „co wymaga uwagi dziś", alerty o przepalanych reklamach czy kończących się bestsellerach i raporty łączące BaseLinkera z reklamą, kosztami i ruchem na stronie.

Źródła i narzędzia