Propojení Claude s aplikací Nordlet

Tento návod je určen uživatelům, kteří chtějí umožnit umělé inteligenci Claude pracovat se svými účetními daty v Nordletu. Claude se připojuje k MCP serveru Nordlet na adrese https://api.nordlet.com/mcp. Připojení schválíte jednorázově na stránce v Nordletu. Nemusíte kopírovat žádné klíče.

1. Vytvoření účtu v Nordletu

1. Otevřete stránku app.nordlet.com a zadejte svou e-mailovou adresu.
2. Vyjádřete souhlas s podmínkami použití, zásadami ochrany osobních údajů a smlouvou o zpracování údajů (Data Processing Agreement). Nordlet vám odešle přihlašovací odkaz. Odkaz platí 15 minut a lze jej použít pouze jednou. Heslo se nepoužívá.
3. Otevřete odkaz. Zvolte si tarif: buď paušální předplatné, které začíná bezplatným zkušebním obdobím, nebo platbu za jednotlivé požadavky s počátečním nabitím kreditu.
4. Založte svou společnost: zadejte název, zemi, IČO a DIČ (VAT code). Pokud si chcete systém nejprve vyzkoušet, zaškrtněte políčko Testovací společnost (Sandbox company). Testovací společnost obsahuje zkušební data a lze ji kdykoliv smazat.

Můžete být členem několika společností: své vlastní a společností, jejichž vlastníci vás přizvali. Vaše role v jednotlivých společnostech (vlastník, správce, účetní, manažer, vývojář nebo čtenář) určuje, jaké akce v nich můžete provádět. Claude dědí stejná oprávnění.

2. Propojení s aplikací Claude

1. V aplikaci Claude přidejte vlastní konektor (custom connector) s adresou https://api.nordlet.com/mcp. Políčka pro ověření (authentication) ponechte prázdná.
2. Claude otevře stránku v Nordletu. Pokud nejste přihlášeni, Nordlet si vyžádá vaši e-mailovou adresu a odešle přihlašovací odkaz. Otevřete odkaz ve stejném prohlížeči, čímž se vrátíte zpět na stránku.
3. Na stránce se zobrazí název aplikace, která žádá o přístup, a adresa, na kterou budete přesměrováni zpět. Obě položky zkontrolujte a zvolte možnost Povolit (Allow). Tlačítko Zamítnout (Deny) vás vrátí zpět bez udělení přístupu.
4. Vrátíte se do aplikace Claude a konektor bude aktivní.

Claude si přístup obnovuje automaticky. Přístupový token (access token) platí jednu hodinu a Claude jej bez vašeho přispění vymění za nový.

3. Propojení s Claude Code

Spusťte příkaz:

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

Poté v rozhraní Claude Code zadejte příkaz /mcp a zvolte ověření (authenticate) serveru nordlet. V prohlížeči se otevře stejná stránka Nordletu jako v kroku 2. Po kliknutí na Povolit (Allow) vás prohlížeč vrátí zpět do nástroje Claude Code ve vašem počítači.

4. Práce ve společnostech

Jedno připojení funguje ve všech společnostech, jejichž jste členem. Claude nejprve vypíše seznam vašich společností a v každém volání pak uvede konkrétní společnost. Požadavek na společnost zadávejte jménem, například "vystav společnosti UAB Pavyzdys tuto fakturu". Jakmile budete přidáni do nové společnosti, Claude v ní může okamžitě pracovat. Po odebrání ze společnosti v ní Claude již pracovat nemůže.

Každý požadavek odeslaný aplikací Claude představuje běžný API požadavek a započítává se jako jakýkoliv jiný požadavek. Provedené změny se zaznamenávají v protokolu změn (audit log).

5. Odpojení

1. V Nordletu přejděte do nabídky Účet (Account) -> Vývojáři (Developers). Připojení je uvedeno v seznamu vašich API klíčů pod názvem aplikace, například „Claude“.
2. Zvolte možnost Odvolat (Revoke). Claude okamžitě ztratí přístup ve všech společnostech.

Pro opětovné připojení opakujte krok 2.

Alternativní použití API klíče

Vlastníci, správci a vývojáři mohou vytvořit API klíč v sekci Účet (Account) -> Vývojáři (Developers) a odesílat jej v hlavičce požadavku. Více informací naleznete v části MCP server.