MCP server

Prepojte svoju AI aplikáciu s Digitálnou Poštárkou

Digitálna Poštárka prevádzkuje Model Context Protocol (MCP) server iba na čítanie. Pripojte k údajom v Digitálnej Poštárke akúkoľvek AI aplikáciu, ktorá podporuje MCP OAuth, napríklad Claude (web, desktop alebo Code), ChatGPT v režime pre vývojárov, Cursor alebo n8n.

Adresa servera

Vašej AI aplikácii stačí táto adresa. Sama sa zaregistruje a v prehliadači otvorí prihlásenie do Digitálnej Poštárky. Prihláste sa (ak ešte nie ste) a kliknite na Povoliť.

https://api.digitalnapostarka.sk/mcp

Prepojte svoju AI aplikáciu

Pridajte server:

Terminál

$ claude mcp add --transport http -s user digital-postman https://api.digitalnapostarka.sk/mcp

V Claude Code zadajte /mcp, vyberte digital-postman a zvoľte Authenticate.

Nástroje

Všetky nástroje údaje iba čítajú.

Nástroj	Čo robí
list_accounts	Vaše firmy s IČO, daňovými údajmi a Peppol adresou.
search_companies	Vyhľadá slovenské firmy podľa IČO alebo názvu.
get_company	Údaje firmy z registra: daňové údaje, adresa, Peppol adresa.
list_documents	Vaše odoslané a prijaté faktúry, s filtrami.
get_document	Celý obsah jednej faktúry.
get_document_xml	Pôvodné XML faktúry, napr. pre účtovný softvér.

Prihlásenie a bezpečnosť

Prihlásenie prebieha iba cez OAuth. Prihlasovacie údaje k API ani prihlasovacie tokeny webu pre MCP nefungujú.
Aplikácia dostane prístupový token platný 15 minút a obnovovací token platný 30 dní, ktorý sa pri obnove mení.
Prístup zahŕňa čítanie vašich firiem a dokladov v rozsahu vašej roly, takže AI aplikácia nikdy nemôže odosielať doklady ani nič spravovať.
Stránka so súhlasom ukazuje názov aplikácie a kam sa vrátite, a uvádza iba oprávnenia, ktoré naozaj udelíte.

Staviate vlastnú integráciu alebo potrebujete faktúry odosielať? Použite REST API.