Podłączanie Claude do Nordlet

Ten przewodnik jest przeznaczony dla osób, które chcą, aby Claude pracował z ich księgami w Nordlet. Claude łączy się z serwerem MCP Nordlet pod adresem https://api.nordlet.com/mcp. Zezwalasz na połączenie jednorazowo na stronie Nordlet. Nie musisz kopiować żadnego klucza.

1. Utworzenie konta w Nordlet

1. Otwórz app.nordlet.com i wpisz swój adres e-mail.
2. Zaakceptuj Regulamin, Politykę prywatności oraz Umowę powierzenia przetwarzania danych. Nordlet wyśle Ci link do logowania. Link jest ważny przez 15 minut i działa tylko raz. Hasło nie jest wymagane.
3. Otwórz link. Wybierz plan: ryczałtowy, który zaczyna się od bezpłatnego okresu próbnego, lub płatny za każde zapytanie z pierwszym doładowaniem konta.
4. Utwórz swoją firmę: podaj nazwę, kraj, numer identyfikacyjny (NIP / kod rejestracyjny) oraz numer VAT. Aby przetestować system, zaznacz opcję Firma piaskownicowa (Sandbox company). Środowisko testowe (sandbox) przechowuje dane testowe i można je usunąć w dowolnym momencie.

Możesz należeć do wielu firm: własnych oraz takich, których właściciel Cię zaprosił. Twoja rola w każdej firmie (właściciel, administrator, księgowy, menedżer, programista lub użytkownik z uprawnieniami do przeglądania) decyduje o tym, co możesz tam robić. Claude otrzymuje takie same uprawnienia.

2. Podłączanie Claude

1. W aplikacji Claude dodaj niestandardowe połączenie (connector) z adresem https://api.nordlet.com/mcp. Pola uwierzytelniania pozostaw puste.
2. Claude otworzy stronę Nordlet. Jeśli nie jesteś zalogowany, Nordlet poprosi Cię o adres e-mail i wyśle link do logowania. Otwórz link w tej samej przeglądarce, a wrócisz do odpowiedniej strony.
3. Strona wyświetli nazwę aplikacji proszącej o dostęp oraz adres powrotny. Sprawdź oba elementy, a następnie wybierz Zezwalaj (Allow). Opcja Odrzuć (Deny) przeniesie Cię z powrotem bez udzielania dostępu.
4. Wracasz do Claude, a połączenie jest aktywne.

Claude odnawia swój dostęp samodzielnie. Token dostępu jest ważny przez godzinę. Claude wymienia go na nowy bez pytania użytkownika o zgodę.

3. Podłączanie Claude Code

Uruchom polecenie:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp

Następnie wpisz /mcp w Claude Code i wybierz uwierzytelnianie serwera nordlet. Twoja przeglądarka otworzy tę samą stronę Nordlet co w kroku 2. Po kliknięciu Zezwalaj (Allow) przeglądarka przekieruje Cię z powrotem do Claude Code na Twoim komputerze.

4. Praca w firmach

Jedno połączenie działa w każdej firmie, której jesteś członkiem. Claude najpierw pobiera listę Twoich firm, a następnie wskazuje firmę w każdym wywołaniu. Wskazuj firmę po nazwie, na przykład „wystaw tę fakturę w UAB Pavyzdys”. Gdy zostaniesz dodany do nowej firmy, Claude może w niej pracować natychmiast. Po usunięciu z firmy Claude traci do niej dostęp.

Każde wywołanie wykonane przez Claude jest zwykłym żądaniem API i jest rozliczane jak każde inne zapytanie. Wprowadzone przez niego zmiany są rejestrowane w dzienniku zdarzeń (audit log).

5. Odłączanie

1. W Nordlet przejdź do sekcji Konto -> Deweloperzy (Account -> Developers). Połączenie znajduje się na liście kluczy API pod nazwą aplikacji, na przykład „Claude”.
2. Wybierz Cofnij (Revoke). Claude natychmiast traci dostęp we wszystkich firmach.

Aby połączyć się ponownie, powtórz krok 2.

Używanie klucza API zamiast tego

Właściciel, administratorzy oraz deweloperzy mogą utworzyć klucz API w sekcji Konto -> Deweloperzy (Account -> Developers) i przesyłać go w nagłówku. Zobacz Serwer MCP.