Start — podłącz asystenta w Claude
Ok. 5 minut, bez wiedzy technicznej. Logujesz się e-mailem i hasłem — bez wklejania tokenów.
https://mcp.asystentksiegowej.pl/mcp/mcp.Czego potrzebujesz
- Konto na claude.ai (wystarczy darmowe do dodania konektora).
- E-mail i hasło konta Asystent Księgowej — te same, których użyłaś/eś przy zakupie pakietu.
- Adres konektora (jeden dla wszystkich pakietów): https://mcp.asystentksiegowej.pl/mcp
- Aktywny co najmniej jeden pakiet (np. po zakupie/triału) — inaczej narzędzia będą niewidoczne.
Kroki
- Otwórz ustawienia konektorów w claude.ai
Zaloguj się na claude.ai → Ustawienia → Konektory (Connectors). Wybierz „Dodaj konektor / Add custom connector”.
- Wklej adres konektora MCP
W polu URL wklej adres swojego konektora: https://mcp.asystentksiegowej.pl/mcp To jeden konektor dla wszystkich Twoich pakietów (Asystent Księgowej).
- Zaloguj się e-mailem i hasłem
Claude przekieruje Cię na bezpieczne logowanie (OAuth 2.1 + PKCE). Podaj e-mail i hasło konta założonego przy zakupie. Nie podajesz żadnego tokena ręcznie.
- Sprawdź dostępne narzędzia
Po autoryzacji w rozmowie pojawią się narzędzia „search_<pakiet>" tylko dla pakietów, które masz aktywne (np. search_zus). Pakiety bez wykupionego dostępu są niewidoczne.
- Zadaj pytanie
Zapytaj np. o temat z pakietu ZUS. Odpowiedzi zawierają cytaty „[art. …]" i „Stan prawny: …". Gdy czegoś nie ma w bazie, asystent napisze, że to wymaga weryfikacji — nie zgaduje treści prawnej.
Załóż Projekt w Claude (zalecane)
Projekt w claude.ai trzyma stałą instrukcję i włączony konektor, więc asystent zawsze pracuje w tej samej roli — z bazą wiedzy i wymuszonymi cytatami.
- 1. Podłącz konektor (jeśli jeszcze nie masz)
W claude.ai dodaj konektor o adresie https://mcp.asystentksiegowej.pl/mcp i zaloguj się e-mailem oraz hasłem z zakupu. Instrukcja wyżej na tej stronie.
- 2. Utwórz Projekt
W claude.ai wejdź w „Projects” → „New project”. Nazwij go np. „Asystent Księgowej”.
- 3. Wklej instrukcję systemową
W ustawieniach Projektu, w polu instrukcji („Set project instructions” / „Custom instructions”), wklej instrukcję systemową z ramki poniżej.
- 4. Włącz konektor w Projekcie
Upewnij się, że w Projekcie (lub w nowej rozmowie w tym Projekcie) konektor jest włączony — w oknie czatu ikona „+” → Twój konektor. Wtedy asystent widzi narzędzia „search_…” i gotowe prompty.
- 5. Pracuj z gotowych promptów
Zadawaj pytania lub użyj promptów konektora (ikona „+”). Asystent najpierw wyszuka w bazie, potem odpowie z cytatami [art. …] i stanem prawnym.
Instrukcja systemowa Projektu — skopiuj i wklej:
Jesteś asystentem księgowej w Polsce (obszary: ZUS, podatki JDG, umowy, prawo pracy). Pomagasz informacyjnie — NIE prowadzisz pełnej ani usługowej księgowości. Zasada determinizmu (bezwzględna): wiedza merytoryczna pochodzi WYŁĄCZNIE z narzędzi konektora (np. „search_zus”) — nie odpowiadasz z własnej pamięci. Upewnij się, że w tym Projekcie konektor Asystenta jest włączony (przełącznik na ✓), aby narzędzia „search_…” działały bez pytania o zgodę przy każdej odpowiedzi. Zasady bezwzględne: 1. Zanim odpowiesz merytorycznie, ZAWSZE użyj narzędzia konektora „search_…” (np. search_zus), aby pobrać właściwe fragmenty. Nie odpowiadaj z własnej pamięci. 2. Odpowiadaj WYŁĄCZNIE na podstawie zwróconych fragmentów i przytaczaj ich cytaty [art. …] oraz stan prawny. Nie podawaj stawek, kwot, progów ani dat z pamięci. 3. Jeśli fragmenty nie pokrywają pytania — napisz wprost: „to wymaga weryfikacji w źródle”. Nie zgaduj i nie uzupełniaj treści prawnej samodzielnie. 4. Jeśli pytanie dotyczy pełnej/usługowej księgowości — odmów i wskaż zakres asystenta. 5. Zanim ustalisz stan faktyczny, dopytaj o brakujące fakty (kogo dotyczy, okres, forma działalności/rozliczenia, dokumenty) — nie zakładaj odpowiedzi. Format każdej odpowiedzi: • Ustalenia — co wynika ze stanu faktycznego i pytania. • Podstawa — fragmenty z cytatami [art. …] i stanem prawnym (lub „to wymaga weryfikacji”). • Co dalej — konkretne następne kroki lub dokumenty do zebrania.
Instrukcja zawiera wyłącznie sposób pracy — treść prawną (stawki, artykuły) dostarcza konektor przez narzędzia „search_…”, zawsze z cytatem [art. …] i stanem prawnym.
Playbook — 5 gotowych scenariuszy
Skopiuj prompt do czatu (w Projekcie z włączonym konektorem). Możesz też użyć wskazanego gotowego promptu konektora — ikona „+” → Twój konektor.
- Nowy klient biura — audyt składek
Kiedy: Przejmujesz klienta i chcesz sprawdzić poprawność jego zgłoszeń i składek ZUS.
Przejmuję nowego klienta prowadzącego jednoosobową działalność. Zrób audyt jego zgłoszeń i składek ZUS: poprowadź listę kontrolną, dopytaj o brakujące dane, a każdy wymóg potwierdź w bazie z cytatami [art. …] i stanem prawnym. Wątpliwości oznacz jako do wyjaśnienia.
Prompt konektora („+”): Audyt zgłoszeń ZUS klienta — checklist (ZUS) - Zwolnienie lekarskie pracownika
Kiedy: Pracownik na umowie o pracę dostarczył zwolnienie i pytasz o procedurę.
Pracownik zatrudniony na umowę o pracę dostarczył zwolnienie lekarskie. Wyjaśnij procedurę krok po kroku dla PRACOWNIKA (nie przedsiębiorcy): dopytaj o brakujące fakty, wypunktuj kroki i potwierdź podstawę w bazie z cytatami [art. …]. Nie mieszaj ścieżki pracownika i przedsiębiorcy.
Prompt konektora („+”): Chorobowe: pracownik vs przedsiębiorca — różnice proceduralne (ZUS) - Własne chorobowe przedsiębiorcy
Kiedy: Przedsiębiorca (JDG) choruje i pyta o swoje świadczenie.
Jestem przedsiębiorcą na jednoosobowej działalności i zachorowałem. Przeprowadź wywiad o mój tytuł ubezpieczenia i ciągłość ubezpieczenia chorobowego, a potem wyjaśnij procedurę dla PRZEDSIĘBIORCY i potwierdź podstawę w bazie z cytatami [art. …]. Kwot nie podawaj z pamięci.
Prompt konektora („+”): Chorobowe: pracownik vs przedsiębiorca — różnice proceduralne (ZUS) - Pismo z ZUS
Kiedy: Klient dostał pismo lub wezwanie z ZUS i trzeba odpowiedzieć.
Klient dostał pismo z ZUS. Pomóż ustrukturyzować odpowiedź: dopytaj o sygnaturę, termin i czego dokładnie żąda organ, zaproponuj strukturę pisma punkt po punkcie, a podstawę prawną do przywołania pobierz z bazy z cytatami [art. …] i stanem prawnym. Nie cytuj przepisów z pamięci.
Prompt konektora („+”): Pismo/kontrola z ZUS — jak ustrukturyzować odpowiedź (ZUS) - Comiesięczna checklist rozliczeń
Kiedy: Rutynowy przegląd przed wysyłką deklaracji i płatnością składek.
Zrób comiesięczną listę kontrolną rozliczeń ZUS dla moich klientów: co sprawdzić przed wysyłką deklaracji i opłaceniem składek, jakich danych potrzebuję, na co uważać przy zbiegach tytułów. Dopytaj o braki, a wymogi potwierdź w bazie z cytatami [art. …]. Braki oznacz jako do weryfikacji.
Prompt konektora („+”): Audyt zgłoszeń ZUS klienta — checklist (ZUS)
Gdzie znajdę prompty konektora
W oknie czatu w claude.ai kliknij ikonę „+” (dodaj z konektora/aplikacji), wybierz Asystent Księgowej i zobaczysz listę gotowych promptów zadaniowych (wywiady, checklisty, pismo z ZUS, wyjaśnienie klientowi). Prompty są widoczne tylko dla aktywnych pakietów Twojego konta.
📸 Zrzuty ekranu krok po kroku dodamy wkrótce. Jeśli nie widzisz promptów: sprawdź, że konektor jest połączony i że pakiet jest aktywny (patrz sekcja „Coś nie działa?”).
Przykładowe prompty
- Przeanalizuj sytuację — Opisz stan faktyczny; asystent dopyta o braki i odpowie z cytatem [art. …] oraz stanem prawnym.
- Krok po kroku — o co dopytać klienta — Asystent poprowadzi wywiad (okres, forma, dokumenty) przed udzieleniem odpowiedzi ze źródłem.
- Zasiłek — wywiad (pakiet ZUS) — Ustrukturyzowane pytania przed ustaleniem prawa do zasiłku; kwoty/progi wyłącznie z korpusu.
Pierwsze pytania
- Użyj narzędzia search_zus i podaj podstawę prawną dla mojego pytania o ZUS.
- Poproś o odpowiedź z cytatem „[art. …]” i informacją „Stan prawny: …”.
- Jeśli tematu nie ma w bazie, asystent napisze, że to wymaga weryfikacji — to poprawne zachowanie.
Coś nie działa? („Couldn’t connect”)
| Objaw | Przyczyna | Naprawa |
|---|---|---|
| „Couldn't connect” od razu po dodaniu konektora | URL bez końcówki /mcp (użyto samego adresu domeny). | Ustaw dokładnie: https://mcp.asystentksiegowej.pl/mcp |
| „Couldn't connect” po chwili / przy logowaniu | Chwilowy problem z serwerem logowania (Keycloak). | Spróbuj ponownie za chwilę; jeśli się powtarza — napisz do wsparcia. |
| Łączy się, ale nie widać narzędzi „search_…” | Brak aktywnego pakietu (subskrypcja/trial) albo zalogowano inne konto. | Sprawdź, że pakiet jest aktywny i że logujesz się e-mailem z zakupu. |
| Prośba o token / klucz | Nieporozumienie — logowanie jest przez e-mail i hasło (OAuth 2.1 + PKCE). | Nie wklejaj żadnych tokenów; wybierz logowanie i podaj e-mail oraz hasło. |
FAQ
- Nie widzę żadnych narzędzi „search_…” w rozmowie.
- Sprawdź, czy masz aktywny pakiet i czy zalogowałaś/eś się przy dodawaniu konektora. Narzędzia pakietów bez dostępu są ukryte.
- Muszę wpisać jakiś token albo klucz?
- Nie. Logowanie odbywa się e-mailem i hasłem (OAuth 2.1 + PKCE). Nigdy nie wklejasz tokenów ani kluczy ręcznie.
- Asystent pisze, że coś „wymaga weryfikacji” albo „brak w bazie”.
- To celowe — asystent nie zgaduje treści prawnej. Odpowiada tylko na podstawie zweryfikowanego korpusu, z cytatem źródła.
- Pełna księgowość / prowadzenie ksiąg?
- To poza zakresem asystenta — dostarcza fragmenty wiedzy z cytatami, nie zastępuje księgowej ani pełnej obsługi.
Zarządzaj pakietami, subskrypcją i hasłem w panelu klienta.