taxmachine.pl

Konfiguracja

Czego potrzebujesz, żeby księgować z asystentem AI: licencja Pro, baza MariaDB, instalacja serwera MCP dla wybranych baz, zasada jedna baza = jedna usługa = jeden port oraz restart asystenta po instalacji.

Opublikowano aktualizacja

Wymagania

  • Licencja profesjonalna lub dla biur rachunkowych. Konfiguracja i instalacja serwerów MCP jest dostępna od wersji Pro w górę.
  • Baza MariaDB lub MySQL. Serwer MCP nie obsługuje baz plikowych SQLite — bazy SQLite nie pojawiają się na liście do instalacji. Jeśli pracujesz na pliku, przenieś bazę na MariaDB (program ma do tego kreator konwersji).
  • Windows z prawami administratora do jednorazowej instalacji usługi.

Nic poza tym nie trzeba ustawiać — program przygotowuje konfigurację instancji sam.

Gdzie się to konfiguruje

Na wstążce Konfiguracja znajdziesz przycisk „Serwery MCP", który otwiera okno „Serwery MCP dla wielu baz danych". Wskazujesz w nim bazy, nadajesz instancjom porty, generujesz tokeny oraz instalujesz, uruchamiasz i zatrzymujesz usługi. Pliki serwera program pobiera sam i informuje o dostępnych aktualizacjach.

Obok stoi bliźniaczy przycisk „Portale akceptacji" — to osobna rzecz (portal, w którym klienci akceptują e-faktury), konfigurowana w ten sam sposób.

Ustawienia usług należą do komputera, a nie do bazy księgowej — dlatego są w osobnym oknie, a nie w opcjach bazy.

Instancje a bazy danych

Zasada jest prosta: jedna baza danych = jedna usługa = jeden port.

  • Lista instancji do wyboru pochodzi wprost z listy baz zdefiniowanych w TaxMachine — tej samej, którą widzisz przy wyborze połączenia. Bazy plikowe SQLite są z niej pomijane, bo serwer ich nie obsługuje.
  • Każda instancja ma własny katalog konfiguracji z ustawieniami, tokenem i własnym dziennikiem zdarzeń, oraz własny port (program proponuje kolejne wolne i pilnuje, żeby się nie dublowały).
  • Instancje są niezależne: asystent podłączony do bazy jednego biura nie widzi danych z drugiej.
  • Rejestr instancji jest właściwością komputera, a nie bazy — dlatego stan odczytywany jest z dysku i z listy usług Windows. Dzięki temu ustawienia jednego stanowiska nie „przenoszą się" na pozostałe, gdzie serwera może w ogóle nie być.

Plik konfiguracyjny instancji zawiera hasło do bazy zapisane tekstem — dokładnie tak, jak trzyma je sam program. Katalog dziedziczy uprawnienia systemowe; nie należy go udostępniać ani kopiować poza stanowisko.

Jak uruchomić asystenta

Zalecany sposób to aplikacja Claude na komputer (Claude Desktop). Działają w niej oba tryby, do których program dopisuje serwer TaxMachine przyciskiem „Dodaj do Claude" w oknie serwerów:

  • Code — asystent pracuje na wskazanym katalogu projektu. Tam trzymasz plik CLAUDE.md z instrukcjami (sposób pracy, kolejność kroków, kiedy pytać) i pliki pomocnicze. Katalog może leżeć w OneDrive lub innym synchronizowanym folderze — wtedy te same instrukcje masz na każdym komputerze.
  • Cowork — tryb pracy zadaniowej w tej samej aplikacji, bez katalogu projektu.

Aplikacja pamięta listę rozmów, więc wznowienie wcześniejszej sesji z całym kontekstem to jedno kliknięcie. Claude Code w wierszu poleceń (terminal, PowerShell) też działa — wpis dodaje to samo „Dodaj do Claude" — ale nie jest potrzebny do pracy z TaxMachine i wymaga osobnej instalacji; zostaw go, jeśli i tak go używasz.

Wiedzy o konkretnej firmie asystent nie trzyma w plikach, lecz w programie: w profilu firmy AI (reguły księgowania, stawki, prawo do odliczeń, wyjątki i dziennik korekt) oraz — przy pełnej księgowości — w polityce rachunkowości. Oba zapisują się przy firmie w bazie, więc podążają za danymi na każde stanowisko. W CLAUDE.md wystarczy jedno polecenie: „przy każdej firmie najpierw odczytaj profil AI i politykę rachunkowości, a po korekcie użytkownika zapisz regułę w profilu". Szczegóły w Co potrafi asystent.

Po instalacji uruchom asystenta ponownie

Po instalacji lub aktualizacji usługi zamknij i uruchom ponownie program asystenta. Połączenie z usługą zestawiane jest przy jego starcie i nie jest nawiązywane ponownie samo z siebie, więc dopóki asystent działa na starej sesji, narzędzia TaxMachine mogą być u niego niewidoczne — mimo że usługa działa poprawnie. To samo dotyczy sytuacji, w której usługa została w międzyczasie zatrzymana i uruchomiona. Program przypomina o tym w komunikacie po instalacji.

Gdy asystent odmawia zapisu do KPiR lub ryczałtu

Jeśli instancja pochodzi ze starszej wersji programu, asystent może wykonać podgląd, ale odmówić zapisu do księgi podatkowej (księgi rachunkowe działają niezależnie od tego). Wystarczy w oknie serwerów kliknąć „Zainstaluj / aktualizuj zaznaczone" — konfiguracja zostanie odświeżona, a usługa zrestartowana.

Asystent w takiej sytuacji nie księguje po cichu byle jak: wykonuje podgląd i wprost mówi, czego brakuje.

Aktualizacje serwera

Samo pobranie nowych plików nie podmienia działających usług — trzeba jeszcze kliknąć „Zainstaluj / aktualizuj zaznaczone…". Kolumna Wersja pokazuje przy przestarzałej instalacji zapis „stara → nowa", a przestarzałe instancje są z góry zaznaczone, więc aktualizacja to jedno kliknięcie. Konfiguracja instancji (porty, tokeny, parametry) zostaje przy tym bez zmian.

Dalej