Disclaimer. SubiektMCP to niezależny wdrożeniowiec. Nie jesteśmy partnerem Anthropic (twórcy Claude Desktop) ani InsERT (twórcy Subiekta GT). Wszystkie kroki opisane w tutorialu są niezależne i otwarte.

Po 30 minutach setup pytasz Claude’a po polsku “ile sprzedaliśmy wczoraj” i dostajesz odpowiedź z konkretnymi nazwami klientów i kwotami z Twojej bazy Subiekta GT. Bez programowania, bez konsultanta, bez maszyn w chmurze. Lokalnie na komputerze z Subiektem.

Ten tutorial pokazuje krok po kroku jak to zrobić: 5 kroków instalacji (pobranie instalatora, setup SQL, aktywacja licencji, pobranie Claude Desktop, konfiguracja config file), pierwsze testowe zapytanie z weryfikacją czy działa, 10 konkretnych promptów na start (per branża), troubleshooting najczęstszych błędów. Plus FAQ dla najczęstszych pytań typu “co jeśli mam Mac” i “ile to kosztuje”.

Audience: właściciel MŚP korzystający z Subiekta GT, gotowy spróbować AI w swojej firmie. Nie wymaga umiejętności programisty. Wymaga 30-60 minut focused setup czasu plus aktywnego Claude Pro (~80 zł netto/mc) lub trialu.

Co to jest Claude Desktop i dlaczego go używamy

Claude Desktop to oficjalna aplikacja od Anthropic na Windows i Mac. Wygląda jak komunikator (boczny panel z konwersacjami, główne okno czatu), pisze po polsku natywnie, obsługuje pliki, obrazy, code samples. Subskrypcja Claude Pro (~80 zł netto/mc) daje dostęp do najnowszych modeli Sonnet i Opus, plus integrację MCP (Model Context Protocol) - kluczową dla połączenia z Subiektem.

Dlaczego Claude Desktop, a nie Claude przez przeglądarkę (claude.ai)? Wersja przeglądarkowa ma ograniczone wsparcie MCP - musisz konfigurować connectors per session, brak persistent state, słabsza integracja z lokalnymi narzędziami. Claude Desktop ma to wbudowane natywnie, instalujesz raz, działa zawsze.

Alternatywa: ChatGPT Codex (część subskrypcji ChatGPT Plus ~80 zł netto/mc, lub Pro 200 zł netto/mc). Codex obsługuje MCP od stycznia 2026, konfiguracja przez plik ~/.codex/config.toml. Workflow podobny do Claude Desktop, ale interface CLI-first (Codex jest narzędziem dla developerów w pierwszej kolejności, chat to dodatek). Jeśli wolisz ChatGPT, pełen przewodnik wyboru w Claude vs ChatGPT dla polskiej firmy.

Ten tutorial skupia się na Claude Desktop (najlepsza ścieżka dla większości polskich MŚP w 2026). Adaptacja do Codex wymaga niewielkich zmian (inny format config, ten sam SubiektMCP).

Prerequisites

Zanim zaczniesz, sprawdź checklist:

1. Subiekt GT 1.50 lub nowszy. Dowolna wersja od 2020 roku. SubiektMCP nie wspiera Subiekta Nexo ani Subiekta 123 (inne produkty InsERT z odmienną architekturą bazy).

2. SQL Server lokalny. Subiekt GT standardowo używa SQL Server Express (darmowy) lub pełnego SQL Server. Sprawdzisz w Subiekcie: Pomoc → Informacje o programie → tam jest serwer i baza. Domyślny serwer to localhost\INSERTGT lub .\INSERTGT.

3. Claude Pro subskrypcja. ~80 zł netto/mc, opłacisz kartą na claude.ai. Trial 5 dni za darmo (bez karty kredytowej w niektórych regionach). Plan Free Claude nie wystarczy - MCP wymaga Pro.

4. Windows 10 lub 11. Subiekt GT jest Windows-only (InsERT nie wydaje na Mac/Linux), więc SubiektMCP też wymaga Windows. Jeśli używasz Maca jako głównego komputera, opcje opisane w FAQ.

5. Stabilne łącze internetowe. SubiektMCP siedzi lokalnie, ale Claude rozmawia z chmurą Anthropic. Bez netu - nie zadasz pytania. Minimum 10 Mbps stabilne wystarcza.

6. Klucz licencyjny SubiektMCP. Trial 14 dni przez Stripe (z kartą, online self-service) lub 7 dni klucz testowy bez karty (po kontakcie mailowym). Pełen flow na /produkt.

Jeśli wszystkie 6 pozycji to tak, jesteś gotowy. Lecimy do instalacji.

Instalacja SubiektMCP. Krok po kroku

Krok 1. Pobranie instalatora

Idź na stronę /pobierz. Ściągnij plik SubiektMCP_Setup_v1.x.x.exe (~60 MB). Nie wymaga uprawnień administratora (instaluje się w katalogu użytkownika).

Uruchom instalator, kreator przeprowadzi przez setup. Kliknij Next przez ekrany informacyjne, zaakceptuj licencję, wybierz katalog instalacji (domyślny OK). Po finalnym Install instalator skopiuje pliki i utworzy ikonkę na pulpicie plus wpis w menu Start.

Po instalacji uruchom SubiektMCP Setup z pulpitu. Otworzy się kreator konfiguracji.

Krok 2. Setup SQL connection

W kreatorze SubiektMCP wpisz dane SQL Server gdzie siedzi baza Subiekta:

  • Server: zazwyczaj localhost\INSERTGT (default Subiekt GT installation) lub .\INSERTGT (alternatywny zapis tego samego)
  • Database: nazwa Twojej bazy podmiotowej, np. Subiekt_dane_KrasinskiBPK (znajdziesz w Subiekcie: Plik → Otwórz Podmiot - tam pełna nazwa)
  • Authentication: Windows Authentication (domyślnie, używa zalogowanego użytkownika Windows) lub SQL Server Authentication (jeśli masz osobne hasło SQL - rzadkie w MŚP)

Kliknij Test Connection. Jeśli zwraca “Connection successful” - super, idź dalej. Jeśli błąd - sprawdź troubleshooting niżej, najczęściej Subiekt nie działa lub SQL Server jest wyłączony.

Krok 3. Aktywacja licencji

W kreatorze wklej klucz licencyjny otrzymany po zakupie (lub klucz testowy z trial 7 dni). Kreator zweryfikuje klucz online (wymaga internetu) i aktywuje. Po aktywacji SubiektMCP startuje jako usługa Windows w tle.

Możesz sprawdzić czy działa: Otwórz Menedżer Zadań → Usługi → szukaj “SubiektMCP”. Status powinien być Running. Jeśli nie - przeczytaj troubleshooting niżej.

Krok 4. Pobranie Claude Desktop

Idź na claude.ai/download (oficjalna strona Anthropic, nie pomylić z fake’ami). Ściągnij wersję Windows. Plik ~150 MB, instalacja standardowa Windows installer.

Po instalacji uruchom Claude Desktop, zaloguj się kontem Claude Pro (utworzonym wcześniej na claude.ai z aktywną subskrypcją Pro). Po zalogowaniu zobaczysz puste okno chatu - to dobry znak, Claude działa.

Krok 5. Konfiguracja claude_desktop_config.json

Ostatni krok. Claude Desktop czyta config z pliku JSON. Lokalizacja na Windows:

%APPDATA%\Claude\claude_desktop_config.json

Pełna ścieżka to typowo C:\Users\TwojaNazwa\AppData\Roaming\Claude\claude_desktop_config.json. Wpisz %APPDATA%\Claude\ w pasek adresu Eksploratora Windows, otworzy się folder.

Jeśli plik claude_desktop_config.json nie istnieje, utwórz go (prawym → Nowy → Dokument tekstowy → zmień nazwę na claude_desktop_config.json z usunięciem .txt). Otwórz w Notatniku.

Wklej zawartość:

{
  "mcpServers": {
    "subiektmcp": {
      "command": "C:\\Program Files\\SubiektMCP\\subiektmcp-server.exe",
      "args": []
    }
  }
}

Sprawdź dokładną ścieżkę do subiektmcp-server.exe w Twojej instalacji (jeśli zmieniłeś domyślną lokalizację). Zapisz plik.

Zamknij Claude Desktop (Cmd+Q na Mac, prawym na ikonie w tray + Quit na Windows - nie wystarczy zamknąć okno, musi się całkowicie zamknąć). Uruchom Claude Desktop ponownie.

Po uruchomieniu w lewym dolnym rogu okna chatu pojawi się ikona “wtyczki” (mała ikona narzędzi). Kliknij - powinieneś zobaczyć subiektmcp connector z listą dostępnych tools (sprzedaż, magazyn, klienci, faktury, etc.). Jeśli widzisz - gotowe, możesz pytać po polsku.

Pierwsze zapytanie. Test “ile sprzedaliśmy dziś”

W oknie chatu Claude Desktop wpisz:

Pokaż mi podsumowanie wczorajszej sprzedaży: suma utargu netto, ilość faktur, top 3 klientów po wartości.

Claude wywoła odpowiedni tool z SubiektMCP, pobierze dane z bazy Subiekta lokalnie, sformatuje odpowiedź po polsku. Powinieneś dostać coś w stylu:

Wczoraj wystawiono 23 faktury sprzedaży o łącznej wartości netto 12 450 zł.

Top 3 klienci po wartości: 1. Hurtownia ABC Sp. z o.o. - 3 200 zł 2. Sklep Nowak - 2 100 zł 3. Warsztat XYZ - 1 850 zł

Średnia wartość faktury wczoraj: 541 zł.

Jeśli widzisz konkretne nazwy i kwoty z Twojej bazy - gratulacje, działa. Lecimy dalej do 10 promptów na start.

Jeśli Claude odpowiada “nie mam dostępu do takich danych” lub “wykonałem zapytanie ale nie ma wyników” - patrz troubleshooting niżej. Najczęściej brakuje kroku w konfiguracji lub SQL Server nie odpowiada.

Long-term jak wygląda używanie SubiektMCP w realnej firmie pokazuje case study 90 dni.

10 promptów na start

Po pierwszym udanym zapytaniu, oto 10 promptów do skopiowania. Dopasuj nazwy kategorii i klientów do swojej firmy.

1. Daily briefing (CEO, codziennie rano)

Streść mi wczorajszy dzień: utarg netto, ilość faktur, top 3 klienci, zaległości które przekroczyły termin, plus jedno zdanie o tym co wymaga reakcji dzisiaj.

2. Top 10 klientów ostatni miesiąc (B2B)

Top 10 klientów po wartości netto za ostatni miesiąc. Tabela: nazwa, miasto, suma netto, ilość faktur, średnia wartość faktury.

3. Stan magazynu krytyczny (hurtownia)

Lista towarów których stan magazynowy spadł poniżej minimum określonego w kartotece. Tabela: nazwa, aktualny stan, stan minimum, średnia sprzedaż 30 dni, sugerowana ilość do zamówienia.

4. Zaległości po terminie (universal)

Klienci z należnościami przekroczonymi powyżej 30 dni. Tabela: nazwa, suma zaległa netto, ilość niezapłaconych faktur, dni od terminu (najstarsza faktura).

5. Marża per kategoria (retail B2C)

Marża procentowa per kategoria towarowa za ostatni kwartał. Tabela: kategoria, obrót netto, marża kwotowa, marża procentowa. Pod tabelą wskaż które kategorie odchylają się od średniej.

6. Faktury sprzedaży konkretnemu klientowi (biuro rachunkowe)

Pokaż wszystkie faktury sprzedaży dla klienta “[nazwa klienta]” wystawione w 2026 roku. Tabela: numer faktury, data, wartość netto, VAT, status płatności (zapłacona/oczekuje).

7. Dead stock - towary które nie sprzedały się ponad 90 dni

Lista towarów które nie miały żadnej sprzedaży przez ostatnie 90 dni a mają stan magazynowy > 5 sztuk. Tabela: nazwa, aktualny stan, wartość zakupowa (stan × cena zakupu), kategoria.

8. Synchronizacja Allegro (e-commerce)

Pokaż top 20 SKU które miały sprzedaż w ostatnich 7 dniach z wyróżnieniem ile zostało, ile sprzedanych, kiedy ostatnia sprzedaż. To pomaga sprawdzić czy sync z Allegro działa - jeśli stan w bazie mocno odbiega od stanu w Allegro, problem.

Głębszy use case multi-channel sync w Claude do BaseLinker + Subiekt.

9. KSeF status faktur (compliance)

Pokaż wszystkie faktury sprzedaży wystawione w maju 2026 z podziałem na status KSeF: wysłane do KSeF (z numerem KSeF), oczekujące wysyłki, błędy wysyłki.

10. Co domówić w tym tygodniu (zatowarowanie)

Wygeneruj listę zakupową na ten tydzień. Logika: towary z (1) stanem poniżej minimum, lub (2) sprzedażą >10 sztuk w ostatnich 30 dniach a stanem < 20 sztuk. Per towar: nazwa, aktualny stan, średnia sprzedaż 30 dni, rekomendowana ilość do zamówienia, główny dostawca.

Więcej promptów per branża w 7 pytań do Subiekta przez Claude.

Troubleshooting. Najczęstsze błędy i fixe

Najczęstsze problemy w pierwszych 7 dniach używania SubiektMCP:

Symptom Przyczyna Fix
Claude nie widzi subiektmcp w tools panel Brak restart Claude Desktop po config edit Cmd+Q (Mac) lub prawym → Quit (Windows tray), uruchom ponownie
“Permission denied” SQL error Credentials niewłaściwe lub Windows Auth blokowane Sprawdź w Subiekcie czy zalogowany użytkownik ma dostęp do bazy
Polskie znaki krzaczki w odpowiedziach Encoding mismatch w SubiektMCP config Ustaw encoding UTF-8 w config SubiektMCP
“Connection timeout” przy każdym zapytaniu SQL Server nie odpowiada lub firewall blokuje Sprawdź czy SQL Server Service działa (Menedżer Zadań → Usługi → SQL Server (INSERTGT))
MCP server nie startuje Klucz licencyjny błędny lub plik exe nieobecny Re-aktywacja licencji przez panel, weryfikacja ścieżki w config
Claude pyta “nie mam dostępu do takich danych” Server widoczny ale tool nie wywołany Sprawdź docstring tool, czasem trzeba bardziej specyficzne pytanie (np. “z bazy Subiekta” w prompt)
Long zapytania (>30 sek) Zakres dat zbyt duży, brak indeksów SQL Zmniejsz zakres dat lub limit wyników
Błąd “Tool execution failed” SQL syntax error w generated query Spróbuj inne sformułowanie pytania, prześlij feedback do support

Jeśli Twój problem nie pasuje do tabeli, napisz na kontakt SubiektMCP z opisem (screenshot helpful) - odpowiadamy w 24h w Basic, 1h w Premium.

Wskazówki na pierwsze 2 tygodnie używania

Pierwsze 30 minut setup to dopiero start. Realny payoff przychodzi gdy zbudujesz nawyk codziennego używania. Czego nauczyliśmy się od pierwszych 50 klientów SubiektMCP:

Tydzień 1. Budowa rutyny “morning briefing”. Co rano przed sprawdzeniem maila zapytaj Claude’a “streść mi wczorajszy dzień + co wymaga reakcji dzisiaj”. To 30 sekund które zastępują 25 minut klikania po raportach. Po 7 dniach jest automatyczne jak kawa.

Tydzień 1. Eksperymentuj z 3-5 promptami z listy 10. Nie próbuj wszystkich od razu. Wybierz 3 najbliższe Twoim potrzebom, używaj codziennie przez tydzień. Naturalnie zauważysz patterns - “ten prompt zawsze daje to czego potrzebuję”, “tamten muszę dopasować bo mam inną strukturę kategorii”.

Tydzień 2. Buduj własne prompty. Kiedy juz znasz mechanikę Claude’a, zacznij łączyć tools. Przykład: “pokaż top 10 klientów ostatni miesiąc, dla każdego sprawdź czy ma jakieś zaległe faktury, posortuj malejąco po marży kwotowej”. Jeden prompt zastępuje 3 raporty plus pivot table.

Tydzień 2. Zapisz najlepsze prompty. Claude Desktop ma “Projects” feature - utwórz projekt “Subiekt - codzienne”, trzymaj tam ulubione prompty. Kopiuj-wklejaj zamiast pisać od zera. Pełna integracja Projects z MCP od marca 2026 (Anthropic upgrade).

Tydzień 2. Eksperymentuj z time horizons. “Sprzedaż dziś” to oczywiste. Spróbuj “porównaj tygodnie 19 i 20 - co spadło, co wzrosło, dlaczego”. AI dobry w trend detection na danych historycznych Subiekta.

Anti-pattern do unikania. Nie próbuj zmusić Claude’a do robienia raportów które idą do organu zewnętrznego (JPK, deklaracje VAT). To rola natywnych raportów Subiekta + audytor. AI dla decyzji wewnętrznych, audyt formalny zostawia natywnemu narzędziu.

FAQ

Czy SubiektMCP działa na Macu?

Subiekt GT jest aplikacją Windows-only (InsERT nie wydaje wersji na Mac/Linux), więc SubiektMCP musi siedzieć obok bazy Subiekta na Windowsie. Jeśli pracujesz głównie na Macu, dwie opcje. (1) Windows VPS w chmurze (Azure, AWS, OVH ~150-300 zł netto/mc) - Subiekt GT plus SubiektMCP tam, Claude Desktop na Macu łączy się przez VPN. Setup advanced, polecam Custom deployment. (2) Boot Camp / Parallels na Macu z lokalnym Windowsem - prościej technicznie, ale wymaga osobnej licencji Windows.

Ile kosztuje Claude Pro?

Claude Pro to ~20 USD miesięcznie (około 80 zł netto). Cena może się zmieniać per region i platforma płatności (Apple Store dolicza ~25% prowizji vs strona web). Najtaniej kupisz bezpośrednio na claude.ai kartą firmową. Dla zespołu kilku osób rozważ Claude Team plan (~$25 per user).

Czy mogę użyć ChatGPT zamiast Claude?

Tak. ChatGPT Plus (~80 zł netto/mc) lub Pro (200 zł netto/mc) zawiera Codex - command-line interface z natywnym wsparciem MCP od stycznia 2026. Konfiguracja przez plik ~/.codex/config.toml w podobnym formacie do claude_desktop_config.json. Workflow podobny, interface inne. Pełen breakdown w Claude vs ChatGPT dla polskiej firmy.

Co jeśli mam wiele baz Subiekta (oddziały, firmy)?

Domyślny SubiektMCP obsługuje 1 bazę per instalacja. Multi-firmy wymagają Custom deployment - stawiamy dedicated MCP server per baza plus router który rozumie kontekst zapytania. Wycena indywidualna od 12 000 zł netto za pierwsze 2-3 bazy, +2-3 tys netto za każdą kolejną. Skontaktuj się przez /wdrozenia dla wyceny.

Czy mogę testować bez podawania karty?

Tak, 7 dni klucz testowy. Napisz na nikodem@subiektgt.chat z opisem firmy (branża, ile użytkowników, główny use case), wystawiamy ręcznie klucz testowy. Bez karty, bez ryzyka auto-pobrania. Po 7 dniach klucz wygasa, albo przechodzisz na płatną subskrypcję, albo zostaje bez konsekwencji.

Alternatywnie trial 14 dni przez Stripe (z kartą, online self-service) - dłuższy ale wymaga karty z auto-pobraniem po 14 dniach (chyba że anulujesz wcześniej). Pełen flow w AI agent dla Subiekta GT.

Co dalej po pomyślnym setup?

Trzy następne kroki. (1) Przejrzyj 10 promptów wyżej, używaj 3-5 najczęściej przez pierwsze 2 tygodnie żeby zbudować nawyk. (2) Czytaj case study 90 dni - jak wygląda używanie SubiektMCP po 3 miesiącach. (3) Eksperymentuj z własnymi promptami - SubiektMCP ma 13 tools, Claude jest dobry w łączeniu ich w sequence (np. “pokaż top klientów ostatni miesiąc, dla każdego sprawdź czy ma jakieś zaległe faktury, posortuj malejąco po marży”).

Pogłębiamy temat