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 aktualizacja

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.

Zalecamy aplikację Claude na komputer — tryb Code albo Cowork; wiersz poleceń nie jest do pracy z TaxMachine potrzebny. Jak zacząć: Konfiguracja — jak uruchomić asystenta.

Opisy w tej sekcji powstały i są sprawdzane na Claude, bo z nim serwer jest testowany. Jeżeli na komputerze jest LM Studio z modelem lokalnym, program dopisuje wpis serwera także tam.

Inne asystenty. Serwer jest lokalny i taki ma pozostać — to wyznacza, co da się podłączyć bez pomocy informatyka:

  • Codex (narzędzie OpenAI) potrafi korzystać z serwerów MCP uruchomionych na tym samym komputerze, więc teoretycznie powinien zadziałać — z TaxMachine nie był testowany;
  • ChatGPT łączy się wyłącznie ze zdalnymi serwerami MCP; do serwera na komputerze użytkownika OpenAI kieruje przez swój Secure MCP Tunnel, a pełna obsługa MCP z zapisem wymaga planów Business, Enterprise lub Edu z „developer mode" (plan Pro — tylko odczyt). Warunki opisuje dokumentacja OpenAI i zmieniają się często — TaxMachine tego połączenia nie wspiera i nie opisuje.

Więcej o tym w pytaniach biur rachunkowych.

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