Prepojenie Claude s aplikáciou Nordlet

Tento návod je určený pre používateľov, ktorí chcú, aby Claude pracoval s ich účtovníctvom v aplikácii Nordlet. Claude sa pripája k MCP serveru Nordlet na adrese https://api.nordlet.com/mcp. Prepojenie povolíte jednorazovo na stránke aplikácie Nordlet, pričom nemusíte kopírovať žiadne kľúče.

1. Vytvorenie účtu v Nordlet

1. Otvorte adresu app.nordlet.com a zadajte svoju e-mailovú adresu.
2. Vyjadrite súhlas s obchodnými podmienkami, zásadami ochrany osobných údajov a zmluvou o spracovaní údajov. Nordlet vám pošle prihlasovací odkaz, ktorý platí 15 minút a dá sa použiť iba raz. Heslo sa nepoužíva.
3. Otvorte odkaz a vyberte si predplatné: paušálny program, ktorý začína bezplatným skúšobným obdobím, alebo platbu za jednotlivé požiadavky s prvým dobitím kreditu.
4. Vytvorte svoju spoločnosť: zadajte názov, krajinu, IČO (registration code) a IČ DPH (VAT code). Ak si chcete aplikáciu najskôr vyskúšať, začiarknite možnosť Testovacia spoločnosť (Sandbox company). V testovacom prostredí sa uchovávajú testovacie údaje a môžete ho kedykoľvek vymazať.

Môžete byť členom viacerých spoločností: vašich vlastných a tých, do ktorých vás pozval ich vlastník. Vaša používateľská rola v každej spoločnosti (vlastník, správca, účtovník, manažér, vývojár alebo iba na čítanie) určuje, aké úkony tam môžete vykonávať. Rovnaké oprávnenia preberá aj Claude.

2. Prepojenie s Claude

1. V aplikácii Claude pridajte vlastný konektor s adresou https://api.nordlet.com/mcp. Polia pre overenie totožnosti (authentication) nechajte prázdne.
2. Claude otvorí stránku aplikácie Nordlet. Ak nie ste prihlásení, Nordlet si vyžiada vašu e-mailovú adresu a pošle vám prihlasovací odkaz. Otvorte ho v rovnakom prehliadači, čím sa vrátite späť na stránku.
3. Na stránke sa zobrazí názov aplikácie, ktorá žiada o prístup, a cieľová adresa, na ktorú sa vrátite. Obidve informácie skontrolujte a vyberte možnosť Povoliť (Allow). Tlačidlo Zamietnuť (Deny) vás vráti späť bez udelenia prístupu.
4. Budete presmerovaní späť do aplikácie Claude a konektor bude úspešne pripojený.

Claude si prístup obnovuje automaticky. Prístupový token (access token) platí jednu hodinu a Claude ho bez vášho zásahu nahradí novým.

3. Prepojenie nástroja Claude Code

Spustite tento príkaz:

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

Potom v nástroji Claude Code zadajte /mcp a vyberte overenie totožnosti pre server nordlet. Vo vašom prehliadači sa otvorí rovnaká stránka Nordlet ako v druhom kroku. Po kliknutí na tlačidlo Povoliť (Allow) vás prehliadač vráti do nástroja Claude Code vo vašom počítači.

4. Práca vo vašich spoločnostiach

Jedno prepojenie funguje vo všetkých spoločnostiach, ktorých ste členom. Claude najprv zoznamovo načíta vaše spoločnosti a pri každom volaní uvedie konkrétnu spoločnosť. Spoločnosť uveďte podľa názvu, napríklad „vystav pre túto faktúru v spoločnosti UAB Pavyzdys“. Keď vás pridajú do novej spoločnosti, Claude v nej môže okamžite pracovať. Po odobratí prístupu k spoločnosti v nej Claude stráca oprávnenie pracovať.

Každé volanie, ktoré Claude uskutoční, predstavuje bežnú požiadavku na API a započítava sa rovnako ako akákoľvek iná požiadavka. Vykonané zmeny sa zaznamenávajú v protokole auditu (audit log).

5. Odpojenie

1. V aplikácii Nordlet prejdite na Účet (Account) -> Vývojári (Developers). Prepojenie sa nachádza v zozname API kľúčov pod názvom aplikácie, napríklad „Claude“.
2. Zvoľte možnosť Odwoľať (Revoke). Claude okamžite stratí prístup vo všetkých spoločnostiach.

Ak sa chcete opätovne pripojiť, zopakujte druhý krok.

Alternatívne použitie API kľúča

Vlastníci, správcovia a vývojári môžu vytvoriť API kľúč v sekcii Účet (Account) -> Vývojári (Developers) a odoslať ho v hlavičke (header). Viac informácií nájdete v časti MCP server.