Pro AI agenty

Jak nechat AI agenta, třeba Claude Code, Codex nebo Cursor, pracovat s Moniary přes CLI nebo API.

S Moniary může pracovat i AI agent. Přečte si dokumentaci, najde správnou akci a spustí ji vaším jménem.

Dokumentace pro agenty

AdresaCo obsahuje
/llms.txtKrátký rozcestník podle zvyklosti llms.txt
/llms-full.txtCelou dokumentaci pro vývojáře a všechny akce se vstupy v jednom souboru
/docs/<stránka>.mdLibovolnou stránku dokumentace jako čistý Markdown, například /docs/api.md
/api/v1/openapi.jsonStrojový popis API (OpenAPI 3.1)

Agentovi stačí napsat: „Přečti si https://moniary.com/llms-full.txt a použij příkaz moniary.“ Soubory pro agenty jsou anglicky.

Doporučený postup

  1. Najít akci: moniary actions <hledat> --json
  2. Zjistit vstup: moniary describe <akce>
  3. Spustit: moniary run <akce> '<json>'
  4. Ověřit výsledek čtecí akcí a teprve pak pokračovat.

Když akce vrátí INVALID_INPUT, seznam issues přesně řekne, které pole je potřeba opravit.

Bezpečnost

  • Agentovi, který jen odpovídá na otázky, dejte API klíč s přístupem Čtení. Nic tím nezmění.
  • Akce s přístupem confirm (vystavení a odeslání faktury, upomínky, platební příkazy poslané do banky k podpisu) mají dopad mimo Moniary. Nastavte agenta tak, aby se vás před nimi zeptal.
  • Mazat a nakupovat přes API vůbec nejde.
  • Každému agentovi dejte vlastní API klíč. Ve sloupci Poslední použití uvidíte, kdy ho naposledy použil, a jedním kliknutím ho můžete zneplatnit.

ChatGPT a Claude

Pokud chcete s Moniary pracovat v chatu (ChatGPT, Claude), je jednodušší připojit ho přímo. V ChatGPT najdete Moniary jako hotovou aplikaci, v Claude ho přidáte jako konektor. API klíč k tomu nepotřebujete, stačí se přihlásit účtem Moniary. Adresa MCP serveru je https://moniary.com/api/mcp a použít ji mohou i agenti, kteří MCP s přihlášením podporují. Návod najdete na stránce Integrace.