taxmachine.pl

Jak to działa

Co się dzieje pod spodem, gdy asystent AI księguje w TaxMachine: serwer MCP jako usługa Windows na Twoim komputerze, dwa sposoby połączenia, obsługiwane programy oraz to, które dane trafiają do rozmowy z asystentem.

Opublikowano

Między asystentem a Twoimi danymi stoi serwer MCP — mały pośrednik, który udostępnia asystentowi narzędzia TaxMachine:

asystent AI  ⇄  serwer MCP (usługa Windows na Twoim komputerze)  ⇄  baza TaxMachine

Serwer jest usługą Windows, uruchamianą raz i działającą w tle. Nasłuchuje wyłącznie na tym komputerze (localhost) — nie wystawia bazy do sieci ani do internetu, więc nie wymaga otwierania portów w zaporze ani zgody administratora sieci.

Serwer stawia się na stanowisku, nie na serwerze biura. Każdy, kto pracuje z asystentem, instaluje go u siebie — wtedy asystent rozmawia z instancją na tym samym komputerze. Same bazy danych mogą przy tym leżeć centralnie na wspólnym serwerze MariaDB; usługa łączy się z nimi tak samo jak program.

Dwa sposoby połączenia

Rozmowa z asystentem może się z serwerem łączyć na dwa sposoby, w zależności od tego, jakiego programu używasz:

  • przez HTTP — instancja ma własny adres w rodzaju http://localhost:8095/mcp i token dostępu; tak działa m.in. Claude Code;
  • przez konsolę (stdio) — dla programów, które nie potrafią wołać serwera po adresie. Ten sam plik serwera uruchomiony w trybie mostu przekazuje komunikaty ze standardowego wejścia do instancji HTTP i z powrotem. Most nie dotyka bazy ani konfiguracji — to czysty przekaźnik, bez potrzeby instalowania Node.js czy innych dodatków na stanowisku pracy.

Konfigurację obu wariantów program wpisuje sam — nie trzeba edytować plików konfiguracyjnych ręcznie.

Z jakimi programami działa

MCP (Model Context Protocol) to otwarty standard, więc podłączyć się może każdy program, który go obsługuje. Dwa są obsłużone od ręki — program sam dopisuje do nich wpisy i sam je usuwa przy deinstalacji:

  • Claude Code — dostępny w terminalu, w aplikacji Claude na komputer oraz jako rozszerzenie do edytorów kodu. Instancje rejestrowane są jako wpisy użytkownika, więc widać je niezależnie od tego, gdzie akurat pracujesz.
  • Sesje Cowork w aplikacji Claude — to osobny tryb pracy w tej samej aplikacji. Korzysta z własnego pliku konfiguracyjnego i przyjmuje wyłącznie połączenie przez konsolę, dlatego program rejestruje tam serwer przez most stdio. Przed zmianą powstaje kopia zapasowa tego pliku.

Opisy w tej sekcji powstały i są sprawdzane na Claude, bo z nim serwer jest testowany.

Co trafia do rozmowy

Warto rozumieć podział ról: dane pozostają w bazie na Twoim komputerze lub serwerze biura, ale to, o co asystent zapyta i co mu serwer odpowie, trafia do rozmowy — czyli do dostawcy modelu. Zakres tego, co asystent może zobaczyć i zmienić, wyznaczają narzędzia serwera, a nie swobodny dostęp do bazy.

Nie ma tu „samodzielnego grzebania w bazie": asystent może wywołać wyłącznie przygotowane narzędzia, a operacje zapisujące pokazują podgląd i wymagają potwierdzenia.

Dalej