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 kiedy po instalacji usług uruchomić asystenta ponownie.

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 „Strefa klienta" — to osobna rzecz (aplikacja, w której 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 tryb Code w aplikacji Claude na komputer (Claude Desktop). Przycisk „Dodaj do klienta AI..." w oknie serwerów dopisuje serwer TaxMachine do obu trybów tej aplikacji:

  • 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; na planach Pro i Max od 6 października 2026 r. nie łączy się z TaxMachine (niżej).

Cowork od 6 października 2026 r. Na planach Claude Pro i Max nowe zadania Cowork uruchamiają się na serwerach Anthropic, a nie na Twoim komputerze — Anthropic usunął opcję „Only on your computer”. Lokalne serwery MCP, w tym TaxMachine, w takich zadaniach nie działają, a usługa TaxMachine celowo nie jest dostępna z internetu. Do pracy z TaxMachine używaj więc trybu Code. Zadania Cowork rozpoczęte na komputerze przed 6 października działają do końca; na planach Team i Enterprise Anthropic na razie tego nie zmienił — tam wpis dla Cowork, który dodaje program, nadal działa.

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 klienta AI..." — 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 lub aktualizacji usług

Instalacja i aktualizacja usług zatrzymuje je na chwilę i uruchamia ponownie. Co to znaczy dla asystenta, zależy od trybu, w którym pracujesz:

  • Claude Code łączy się z usługą przez HTTP — każde wywołanie narzędzia to osobne połączenie, więc po ponownym uruchomieniu usługi narzędzia TaxMachine działają dalej, bez restartu Claude.
  • Sesje Cowork na komputerze (Team, Enterprise, zadania sprzed 6.10.2026) łączą się przez most — mały proces, który aplikacja Claude uruchamia przy starcie. Od wersji 3.6666 most działa z osobnej kopii programu usługi, więc aktualizacja usług go nie przerywa. Przy pierwszej instalacji albo aktualizacji usług w tej wersji program raz przełącza konfigurację Cowork na tę kopię i prosi wtedy o zamknięcie i ponowne uruchomienie aplikacji Claude. Jeżeli mimo to narzędzia TaxMachine zniknęły z Cowork, zamknij aplikację Claude i uruchom ją ponownie — program mówi o tym w komunikacie, gdy restart jest potrzebny.

Narzędzia TaxMachine mogą też nie być widoczne w sesji, która trwała już przed pierwszą instalacją usługi albo przed dodaniem jej do Claude — wtedy również wystarczy uruchomić Claude ponownie.

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

Usługi aktualizuje się osobno od programu. Po aktualizacji TaxMachine program sam sprawdza, czy zainstalowane usługi są aktualne, pobiera w tle ich nowe wersje i proponuje aktualizację:

  • Zaktualizuj teraz — podmienia pliki usług i uruchamia je ponownie; ustawienia instancji (porty, tokeny, parametry) zostają bez zmian, a system raz prosi o zgodę administratora,
  • Otwórz okno usług — sam wybierasz instancje,
  • Przypomnij później — przypomnienie wróci przy kolejnym wydaniu.

W oknie usług 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 „Zainstaluj / aktualizuj zaznaczone…". Samo pobranie nowych plików nie podmienia działających usług.

Dalej