Instrukcja instalacji

Od pobrania instalatora do pierwszego pytania AI — krok po kroku, w 5 minut.

Wymagania systemowe

Upewnij sie, ze Twoj komputer spelnia ponizsze wymagania przed rozpoczeciem instalacji:

  • Windows 10 lub 11 (64-bit)
  • Subiekt GT (wersja 1.50 lub nowsza) z baza MS SQL Server
  • ODBC Driver 17 lub 18 for SQL Server
  • Polaczenie z internetem (do aktywacji licencji)
Brak ODBC Driver? Pobierz go bezposrednio od Microsoftu: Pobierz ODBC Driver for SQL Server
1

Pobierz instalator

Pobierz najnowsza wersje instalatora SubiektMCP ze strony z wydaniami:

Pobierz SubiektMCP_Setup.exe

Rozmiar: okolo 60 MB. Plik to standardowy instalator Windows (.exe).
2

Uruchom instalator

Po pobraniu uruchom plik SubiektMCP_Setup.exe. Kreator instalacji przeprowadzi Cie przez konfiguracje:

  • Wybor folderu instalacji
  • Konfiguracja polaczenia z SQL Server
  • Wpisanie klucza licencyjnego
  • Automatyczna konfiguracja Claude Desktop
Windows SmartScreen: Jesli Windows SmartScreen wyswietli ostrzezenie, kliknij "Wiecej informacji", a nastepnie "Uruchom mimo to". Instalator jest bezpieczny — ostrzezenie wynika z tego, ze plik jest nowy i nie zostal jeszcze rozpoznany przez Microsoft.
3

Konfiguracja SQL Server

Podczas instalacji musisz podac dane polaczenia z baza danych Subiekta GT:

Serwer SQL

Nazwa instancji SQL Server, na ktorej dziala baza Subiekta GT. Najczesciej jest to:

-- Typowe wartosci:
localhost
localhost\SQLEXPRESS
NAZWA-KOMPUTERA\INSERTGT

Nazwa bazy danych

Nazwa bazy danych Subiekta GT. Mozesz ja sprawdzic w konfiguracji Subiekta GT:

Subiekt GT → Narzedzia → Opcje → Baza danych

Login i haslo SQL

Dane logowania do SQL Server — nie do systemu Windows! Najczesciej jest to uzytkownik sa z haslem ustawionym podczas instalacji SQL Server.

Nie znasz danych SQL? Zapytaj administratora IT w Twojej firmie lub sprawdz konfiguracje Subiekta GT w ustawieniach bazy danych.
4

Klucz licencyjny

Wklej klucz licencyjny, ktory otrzymales na adres e-mail po zakupie subskrypcji. Klucz wygladal tak:

XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Klucz jest przypisany do jednego komputera (node-locked). Licencja jest weryfikowana online przy uruchomieniu, a nastepnie cachowana lokalnie.

Nie masz klucza? Kup subskrypcje na stronie z cennikiem — klucz otrzymasz natychmiast na e-mail. Pierwsze 14 dni za darmo.
5

Podlacz Claude Desktop

Instalator automatycznie konfiguruje Claude Desktop. Jesli konfiguracja nie zostala dodana automatycznie, zrob to recznie:

Reczna konfiguracja

  • Otworz Claude Desktop
  • Przejdz do Settings → Developer → Edit Config
  • Dodaj wpis do sekcji mcpServers:
{
  "mcpServers": {
    "subiektmcp": {
      "url": "http://localhost:8000/mcp"
    }
  }
}
  • Zapisz plik i zrestartuj Claude Desktop
Plik konfiguracyjny znajduje sie w: %APPDATA%\Claude\claude_desktop_config.json
6

Gotowe — testuj!

Otworz Claude Desktop i wyprobuj ponizsze pytania. Jesli wszystko dziala, zobaczysz dane prosto z Twojego Subiekta GT:

"Sprawdz stan magazynowy towaru LAPTOP-15"
"Pokaz nierozliczone faktury firmy Kowalski"
"Wygeneruj raport sprzedazy za ostatni miesiac"
"Jakie towary maja niski stan magazynowy?"

Rozwiazywanie problemow

Jesli cos nie dziala — sprawdz najczestsze problemy i ich rozwiazania:

Nie moge sie polaczyc z baza SQL

Sprawdz ponizsze elementy:

1. Nazwa serwera — upewnij sie, ze wpisales poprawna nazwe instancji SQL Server (np. localhost\SQLEXPRESS).

2. Dane logowania — sprawdz, czy login i haslo do SQL Server sa poprawne (nie do Windows!).

3. SQL Server Browser — usluga "SQL Server Browser" musi byc uruchomiona w Uslugach Windows (services.msc).

4. Firewall — port 1433 (TCP) musi byc otwarty w zaporze sieciowej Windows.

Port 8000 jest zajety

Jesli inny program uzywa portu 8000, zmien port serwera MCP. Edytuj plik .env w folderze instalacji i zmien wartosc MCP_PORT=8000 na inny port (np. 8001). Pamietaj, zeby zaktualizowac tez konfiguracje Claude Desktop.

Licencja niewazna

Mozliwe przyczyny:

1. Brak internetu — licencja wymaga polaczenia z internetem do pierwszej walidacji. Pozniej dziala offline do 7 dni.

2. Wygasla subskrypcja — sprawdz status subskrypcji w panelu klienta na subiektgt.chat/konto.

3. Limit maszyn — klucz licencyjny jest przypisany do jednego komputera. Jesli zmieniles komputer, skontaktuj sie z nami.

Claude nie widzi narzedzi SubiektMCP

1. Restart Claude Desktop — po dodaniu konfiguracji MCP musisz calkowicie zamknac i ponownie uruchomic Claude Desktop.

2. Sprawdz konfiguracje — otworz plik %APPDATA%\Claude\claude_desktop_config.json i upewnij sie, ze wpis subiektmcp jest w sekcji mcpServers.

3. Sprawdz serwer — upewnij sie, ze usluga SubiektMCP jest uruchomiona (ikona w zasobniku systemowym powinna byc zielona).

Brak ODBC Driver

SubiektMCP wymaga sterownika ODBC Driver 17 lub 18 for SQL Server. Pobierz go bezposrednio od Microsoftu: Pobierz ODBC Driver

SmartScreen blokuje instalator

Windows SmartScreen moze wyswietlic ostrzezenie przy pierwszym uruchomieniu instalatora. To normalne zachowanie dla nowych programow. Kliknij "Wiecej informacji" (lub "More info"), a nastepnie "Uruchom mimo to" (lub "Run anyway"). Instalator jest bezpieczny.

Potrzebujesz pomocy?

Jesli napotkales problem, ktorego nie ma na liscie powyzej — napisz do nas. Odpowiadamy w ciagu 24 godzin.

pomoc@subiektgt.chat

Sprawdz takze FAQ na stronie glownej →