Jak nechat AI agenta automaticky posílat papírové faktury poštou?

Stručná odpověď

Agent (Claude, Cursor, vlastní skript) může přes hostovaný MCP server nebo REST API poslat fakturu jako papírový dopis bez lidského zásahu — stačí adresa a obsah, Postbot fakturu vytiskne, zalepí do obálky a odešle Českou poštou. První dopis jde poslat bez kreditu, opakované odesílání běží na předplacený kredit.

Postup

  1. Připoj agenta k Postbotu. Přidej hostovaný MCP server (adresa /mcp) do agenta jako vzdálený nástroj, nebo použij REST API s API klíčem — bez instalace.
  2. Agent zavolá nástroj send_letter_cz. Předá adresu příjemce a obsah faktury (PDF, markdown nebo text) a zvolí obyčejně nebo doporučeně.
  3. Fakturu vytiskneme a odešleme. Česká pošta doručí do schránky; u doporučeného dopisu dostaneš podací číslo pro sledování.

Časté otázky

Potřebuje agent kredit předem?

První dopis lze poslat bez kreditu — nezaplacené volání vrátí platební odkaz na přesnou částku. Pro opakované odesílání faktur je potřeba předplacený kredit navázaný na API klíč.

Jak agent pozná, že faktura dorazila?

Nástroj get_letter_status vrací stav zásilky podle podacího čísla, které Česká pošta přidělí u doporučeného dopisu.

Musí se MCP server instalovat?

Ne — hostovaný server na /mcp funguje bez instalace, stačí ho přidat do agenta jako vzdálený nástroj (Streamable HTTP). Self-host varianta (bunx @postbot/mcp) je volitelná.

Jde poslat fakturu i s dokladem o doručení?

Ano — zvol doporučenou zásilku a dostaneš podací číslo, kterým doručení sleduješ.