Na čo rozhranie slúži

GraphQL je read-only doplnok REST API určený na flexibilné filtrovanie, projekcie a serverové reporty. MCP nad ním poskytuje nástroje pre AI klientov a na zápisy používa bezpečný draft-first postup cez REST API.

Endpointy a autentifikácia

POST /v1/graphql
GET  /v1/graphql/schema.graphql
GET/POST /mcp/mcp
GET  /mcp/claude-desktop.mcpb

GraphQL aj SDL používajú rovnakú autorizáciu ako REST Open API. MCP HTTP endpoint prijíma API kľúč v hlavičke Api-Key (odporúčané) alebo OAuth klientské údaje v Basic hlavičke. Cesty MCP sú uvedené vrátane aplikácie /mcp pod webom Open API.

Pripojenie Claude Desktop

Stiahnuť inštalačný balíček (.mcpb)

Balíček je pripravený pre prostredie tejto dokumentácie a pre Claude Desktop na Windows a macOS. Obsahuje všetky potrebné závislosti; používateľ nemusí inštalovať Node.js ani upravovať konfiguračné súbory.

V mPohode vyberte firmu, ktorú chcete pripojiť, v ponuke firmy otvorte agendu API a v časti Prístup pomocou API kľúča vytvorte tlačidlom Nový kľúč nový kľúč. Skopírujte si ho. Stiahnutý súbor pretiahnite do okna Settings → Extensions v Claude Desktop (prípadne ho vyberte cez Settings → Extensions → Advanced settings → Install Extension…) a na výzvu vložte API kľúč. Použite kľúč z rovnakého prostredia, z ktorého ste balíček stiahli.

Balíček neobsahuje prihlasovacie údaje. API kľúč sa zadáva až v inštalačnom dialógu a Claude Desktop ho uloží do zabezpečeného úložiska operačného systému. Kľúč je možné zmeniť v nastavení rozšírenia. V novej konverzácii povoľte prepojenie s mPohodou.

Ďalší AI klienti

Balíček .mcpb je určený pre Claude Desktop. VS Code a Cursor umožňujú vlastné MCP pripojenie s hlavičkou Api-Key. ChatGPT pri vlastných MCP pripojeniach aktuálne ponúka OAuth alebo prístup bez prihlásenia, takže súčasný API kľúč mPohody týmto spôsobom nenastavíte.

Schéma a kompatibilita

Aktuálne úplné SDL je dostupné na uvedenom schema endpointe po prihlásení. Introspection zostáva zapnutá, pretože MCP klienti skladajú read-only dotazy dynamicky. Odstránenie alebo nekompatibilné zmeny polí vyžadujú novú verziu endpointu; zastarávajúce členy sa najprv označia direktívou @deprecated s uvedením náhrady.

Menový základ súm

Pri fakturačných dokladoch nie sú polia totalPrice a restToPay v rovnakej mene. totalPrice je hrubá suma vrátane DPH v domácej mene firmy, zatiaľ čo restToPay je v mene dokladu. Domácu neuhradenú sumu vracia restToPayHome; tú možno priamo porovnať s totalPrice. Pre agregované pohľadávky použite report reportUnpaidIssuedInvoices a pole remainingHomeAmount alebo totalHomeAmount.

Bezpečnostné limity

Schéma neobsahuje mutations ani subscriptions. Server obmedzuje hĺbku dotazu na 20, veľkosť stránky na 100 a cenu operácie na 10 000. MCP navyše odmietne zapisovaciu operáciu ešte pred volaním API.

An unhandled error has occurred. Reload 🗙