Úvod
Potrebujete narýchlo faktúru s platobným QR kódom a máte otvorený AI agent? Nemusíte otvárať fakturačný program. V Antigravity CLI (alebo v Claude, Cursore) poviete agentovi, čo má spraviť, a platobný QR kód pre Pay by Square máte vygenerovaný jedným volaním Easy Square API — zadarmo, bez registrácie.
Tento návod ukazuje presne ten workflow: ako z Antigravity CLI necháte AI agenta vytvoriť faktúru aj s QR kódom, cez REST API aj cez MCP.
Čo je Antigravity CLI a prečo cez neho fakturovať
Antigravity je agentická vývojová platforma od Googlu, poháňaná modelom Gemini 3. Antigravity CLI je jej terminálový agent — zadáte úlohu v prirodzenom jazyku, agent ju rozloží na kroky, spustí ich v termináli a výsledok overí. Nie je to len doplňovanie kódu; agent reálne vytvorí súbory, zavolá API a odovzdá hotový výstup.
Fakturovať cez agenta dáva zmysel, keď:
- vystavujete pár faktúr mesačne a nechcete platený fakturačný SaaS,
- máte vlastnú šablónu faktúry (HTML, LaTeX, Markdown → PDF),
- ste technicky zdatní a skladáte si nástroje cez AI agentov,
- chcete to rýchlo, lacno a bez vendor lock-inu.
QR kód pridáte do faktúry jedným krokom navyše — a zákazník ho naskenuje telefónom, platobné údaje sa vyplnia samé.
Krok za krokom: faktúra s Pay by Square QR cez AI agenta
1. Zadajte agentovi úlohu
V Antigravity CLI stačí prirodzený prompt. Napríklad:
Vytvor PDF faktúru pre klienta Firma s.r.o., suma 240,00 €, IBAN
SK3112000000198742637541, variabilný symbol 2026042. Na faktúru pridaj
platobný QR kód Pay by Square — zavolaj Easy Square API a vlož vrátený PNG.
2. Agent zavolá Easy Square API
Free tier funguje bez registrácie s verejným testovacím kľúčom z dokumentácie. Agent pošle jeden POST request a dostane naspäť PNG:
curl -X POST https://api.easy-square.sk/api/v1/pay-by-square/qr-code \
-H "Content-Type: application/json" \
-H "X-Api-Email: test@easy-square.sk" \
-H "X-Api-Key: esq_test_2026_charity_qr_key" \
-d '{
"beneficiaryName": "Firma s.r.o.",
"iban": "SK3112000000198742637541",
"amount": 240.00,
"variableSymbol": "2026042"
}' \
--output qr.png
Povinné polia sú beneficiaryName, iban a amount. Variabilný symbol a ďalšie údaje sú voliteľné. Kompletný zoznam nájdete v dokumentácii API.
3. Agent vloží QR do PDF faktúry
Uložený qr.png agent vloží do vašej šablóny — vedľa platobných údajov — a vyexportuje faktúru do PDF. Hotovo: faktúra má platobný QR kód a vy ste nenapísali jediný riadok kódu ručne.
To isté cez MCP (Claude, Antigravity a ďalší)
Ešte pohodlnejšie je pripojiť Easy Square ako MCP server. Agent potom nemusí skladať HTTP request — zavolá pripravený nástroj generate_qr s parametrami, čím ubudne priestor na chyby.
V Antigravity CLI pridáte server do ~/.gemini/config/mcp_config.json. Funguje aj s verejným free kľúčom, takže si to vyskúšate bez registrácie:
{
"mcpServers": {
"easy-square": {
"serverUrl": "https://mcp.easy-square.sk/mcp",
"headers": {
"X-Api-Email": "test@easy-square.sk",
"X-Api-Key": "esq_test_2026_charity_qr_key"
}
}
}
}
Potom stačí agentovi povedať „vygeneruj Pay by Square QR pre tento IBAN a sumu" a on zavolá nástroj generate_qr sám. Konfiguráciu pre Claude Desktop, Cursor a ďalších nájdete v dokumentácii MCP. Širší pohľad na MCP integráciu ponúka článok Pay by Square cez MCP — AI agenti generujú QR kódy.
Limity free tieru a kedy sa oplatí API kľúč
Verejný prístup je zadarmo a bez registrácie, s dvoma limitmi:
- 100 QR kódov denne — spoločný limit pre všetkých používateľov,
- 10 QR kódov denne na jednu IP adresu.
Pre pár faktúr mesačne to bohato stačí. Keď potrebujete viac, zaregistrujte sa a získate vlastný API kľúč — bez denného limitu, s brandovanými QR kódmi a cenou od 0,003 € bez DPH za kód. Vlastný kľúč jednoducho vložíte namiesto testovacieho do hlavičiek X-Api-Email a X-Api-Key.
Časté otázky
Funguje to aj s Claude alebo ChatGPT?
Áno. Cez MCP to funguje s Claude Desktop, Cursorom, Antigravity aj ďalšími MCP klientmi. Ak agent MCP nepodporuje, zavolá priamo REST API — jeden POST request zvládne každý AI agent.
Je to naozaj zadarmo?
Áno. Free tier ponúka 100 QR kódov denne (10 na IP adresu) s verejným testovacím kľúčom, bez registrácie. Pre vyšší objem si aktivujete vlastný kľúč od 0,003 € bez DPH za kód.
Je bezpečné posielať IBAN cez AI agenta?
Áno. IBAN je údaj príjemcu platby — je verejný a nájdete ho na každej faktúre. Neposielate žiadne citlivé údaje platcu, číslo karty ani prihlasovacie údaje do banky.
V ktorých bankách QR kód funguje?
Vo všetkých 9 slovenských bankách. Pay by Square je národný štandard, ktorý podporujú Tatra banka, Slovenská sporiteľňa, VÚB, ČSOB, mBank aj ostatné.
Záver
Ak už pracujete s AI agentom, faktúru s platobným QR kódom vytvoríte bez otvorenia fakturačného programu — v Antigravity CLI, Claude či Cursore. Vyskúšajte generátor QR kódov alebo si pozrite dokumentáciu API a dokumentáciu MCP. Pre vlastný kľúč bez limitov sa zaregistrujte.