Back to the help

Připojení ke Claude a Codexu (MCP)

This article is not translated yet; the Czech version is shown.

Simbilu si můžete připojit do aplikace Claude nebo do Codexu od OpenAI jako konektor a pracovat s fakturami běžnou řečí přímo v chatu: zeptat se, kdo vám dluží, kolik jste letos vyfakturovali, nebo si nechat připravit fakturu. Spojení využívá otevřený standard MCP (Model Context Protocol).

Adresa serveru Simbily je:

https://mcp.simbila.com/mcp

Připojení

  1. V aplikaci Claude otevřete nastavení konektorů a zvolte přidání vlastního konektoru. Dostupnost vlastních konektorů závisí na vašem předplatném Claude.
  2. Jako název zadejte například Simbila a jako adresu https://mcp.simbila.com/mcp.
  3. Claude otevře okno Připojit k Simbile. Přihlaste se e-mailem a heslem k Simbile. Pokud heslo nemáte (přihlašujete se přes Google), klikněte na Mám API klíč a vložte API klíč s účelem external, viz API klíče.
  4. Klikněte na Povolit připojení.

Okno ukazuje i adresu, kam se po přihlášení vrátíte. Pokud nepatří aplikaci, kterou jste právě připojovali, okno zavřete a nepřihlašujte se.

Konektor pracuje s tím účtem a s tou rolí, pod kterými jste se přihlásili. Člen s rolí Jen čtení dostane jen nástroje pro čtení, viz Uživatelé účtu.

Co konektor umí

  • Odpovídat na otázky nad vašimi daty – tržby po měsících, neuhrazené faktury, pohledávky po splatnosti, zákazníci, přijaté faktury, platby. Čísla počítá Simbila, ne jazykový model.
  • Připravovat a měnit doklady – zákazníky, koncepty faktur, nabídky a další.
  • Nevratné kroky jen s potvrzením. Vystavení, odeslání, zaplacení, storno a smazání konektor neprovede hned: připraví návrh a ten se provede, až ho v Claude potvrdíte. Nepotvrzený návrh po 24 hodinách propadne.
  • Vrácení změny. Ostatní změny se provedou hned a do 24 hodin je jde vrátit zpět – stačí Claude požádat, ať změnu vrátí.

Některé úpravy zatím uděláte jen v aplikaci Simbila: změnu už vystavené faktury, dobropis, kopii faktury a úpravu nebo smazání platby.

Kolik to stojí

Konektor nespotřebovává AI kredit Simbily – jazykový model běží v Claude, ne u nás. Platí jen váš tarif Simbily včetně měsíčního limitu vystavených faktur, viz Váš účet a tarif. Na jeden účet je povoleno nejvýše 120 volání za minutu.

Údaje, které konektor v chatu použije, zpracovává poskytovatel aplikace (Anthropic u Claude, OpenAI u Codexu) podle vašeho účtu u něj. Simbila sama žádnému poskytovateli umělé inteligence nic neposílá.

Odpojení

Každé připojení přes Claude má vlastní klíč. Najdete ho v Nastavení → API klíč s účelem Konektor MCP a poznámkou začínající MCP: a názvem aplikace. Ikonou koše klíč smažete a konektor ztratí přístup okamžitě. Vaše ostatní API klíče se tím nezmění. U Codexu smažete klíč, který jste mu vytvořili.

Codex (OpenAI)

Codex se k Simbile přihlašuje API klíčem místo okna s heslem.

  1. V Simbile vytvořte samostatný klíč: Nastavení → API klíč → Nový API klíč, poznámka například „Codex“, účel external. Hodnotu si zkopírujte, uvidíte ji jen jednou.
  2. Uložte klíč do proměnné prostředí počítače, na kterém Codex běží – například do proměnné SIMBILA_API_KEY. Pak Codex zavřete a znovu spusťte, aby si ji načetl.
  3. V Codexu přidejte MCP server: jako URL zadejte https://mcp.simbila.com/mcp a do pole pro proměnnou prostředí s bearer tokenem napište jen název proměnné (SIMBILA_API_KEY), ne samotný klíč. Hlavičky nevyplňujte.

Pokud aplikace místo proměnné chce hlavičku, má název Authorization a hodnotu Bearer následovanou klíčem.

Takový klíč má přístup k celému API Simbily, ne jen ke konektoru – proto pro Codex vytvořte vlastní klíč, který můžete kdykoli smazat bez dopadu na ostatní integrace. Nevratné kroky i tak jen připraví návrh k potvrzení.

Jiné aplikace

Server používá standardní MCP s přihlášením přes OAuth nebo API klíčem, takže by s ním měly umět pracovat i jiné aplikace, které vzdálené MCP servery podporují. Ověřené máme Claude a Codex.