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.