Zanim zaczniesz
Potrzebujesz dwóch rzeczy: asystenta obsługującego MCP i wyciągów od brokera na dysku.
MCP to protokół, którym asystent łączy się z zewnętrznym narzędziem. Obsługują go Claude Code, Claude Desktop, Cursor i ChatGPT w trybie deweloperskim. Pliki maklerskie zostają u Ciebie — asystent czyta je lokalnie i przysyła nam wyłącznie liczby.
Podłączenie
Klucz znajdziesz w panelu. W Claude Desktop i Cursor ten sam adres i ten sam nagłówek Authorization: Bearer … wpisujesz w pliku konfiguracyjnym.
Pierwsze obliczenie
Powiedz asystentowi swoimi słowami, na przykład:
Policz mi PIT-38 za 2026. Wyciągi z XTB i Revolut są w Downloads.Asystent pobierze reguły, odczyta pliki i przeprowadzi trzy kroki: sprawdzenie, wycenę, obliczenie. Zapyta o zgodę, zanim pobierze cokolwiek z salda.
Polecenia
| Polecenie | Co robi | Saldo |
|---|---|---|
| validate | Sprawdza kontrakt i dane osobowe. Nic nie liczy. | bez opłaty |
| quote | Ile transakcji zostanie policzonych i ile zostanie salda. | bez opłaty |
| calculate | Podatek, rozbicie na sekcje, poprawki. | pobiera |
| balance | Saldo i data wygaśnięcia. | bez opłaty |
Sprawdzenie i wycena są bezpłatne celowo: poprawianie danych nie powinno kosztować.
Saldo i doładowania
- Płacisz za transakcje, nie za abonament.
- Ponowne przeliczenie tych samych transakcji jest bezpłatne — rozpoznajemy je po zawartości, więc inna kolejność wierszy czy ponowny eksport nic nie kosztują.
- Doładowanie dodaje się do reszty salda.
- Niewykorzystane saldo wygasa z końcem sezonu podatkowego.
Odmowy i co z nimi zrobić
| Kod | Znaczenie i co zrobić |
|---|---|
| QUOTA_EXCEEDED | Za mało salda. Nic nie pobrano. W odpowiedzi jest, ilu transakcji brakuje. |
| PII_DETECTED | W danych znalazły się dane osobowe. Wskazujemy pole, nigdy nie powtarzamy wartości. |
| CONTRACT_INVALID | Któreś pole ma zły format. Lista jest w odpowiedzi — asystent poprawi i wyśle ponownie. |
| NO_ACTIVE_BALANCE | Nie ma kupionego pakietu. |
Reguły dla asystenta
Reguły normalizacji są opublikowane pod stałym adresem /rulebook/pl/v1 — to je czyta Twój asystent. Nie musisz ich znać; są jawne, żeby dało się sprawdzić, co i dlaczego wysyłamy.
Adres jest wersjonowany według jurysdykcji, nie języka interfejsu: polskie przepisy zostają pod /rulebook/pl/ niezależnie od tego, w jakim języku czytasz tę stronę.