convez.ai
MCP ServerIntegração & APIsAvançado
INTEVIA

Money S3 MCP Server

INTEVIA/money-s3-mcp-server

Integração MCP com Money S3 para IA gerenciar contabilidade e operações

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta assistentes de IA (Claude, GPT) ao sistema contábil Money S3 via GraphQL API. Oferece leitura e escrita de 129 ferramentas distribuídas em faturas, recibos, extratos bancários, estoque, pedidos, contabilidade, folha de pagamento e 15 catálogos de dados. Suporta transporte stdio e HTTP (pronto para Docker).

Instalação

$npx convez-ai INTEVIA/money-s3-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
1
Saúde
37%
Último commit
há 17 horas
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar leitura e escrita de faturas via Claude
  • Consultar e registrar movimentações bancárias e estoques
  • Integrar processamento de pedidos e folha de pagamento com agents de IA
  • Exposição de múltiplas agendas contábeis para assistentes inteligentes

Veredito

Implementação madura de MCP para ecossistema financeiro-contábil. Bem documentada, com suporte a autenticação robusta e deploy em containers. Ideal para contextos B2B onde integração profunda com sistemas ERP via IA é requisito.

README

A tradução para o português deste README ainda está na fila.

Money S3 MCP Server

MCP server pro propojeni AI asistentu s ucetnim systemem Money S3 pres jeho GraphQL API.

Umoznuje Claudovi (a dalsim AI agentum) pres standardni Model Context Protocol cist a zapisovat data v Money S3 — faktury, pokladni doklady, bankovni vypisy, sklad, objednavky, ucetnictvi, mzdy a dalsich 15 ciselniku.

Predpoklady

  • Node.js >= 20
  • Money S3 s aktivovanym GraphQL API
  • API pristupove udaje (Client ID, Client Secret, App ID)

Instalace

git clone <url-repozitare> money-s3-mcp-server
cd money-s3-mcp-server
npm install

Konfigurace

Zkopiruj .env.example a doplnte sve udaje:

cp .env.example .env

Obsah .env:

# Povinne
MONEY_S3_DOMAIN=nazev-domeny              # Domena API (bez .api.moneys3.eu)
MONEY_S3_CLIENT_ID=xxxxxxxx               # Client ID z Klice API v Money S3
MONEY_S3_CLIENT_SECRET=xxxxxxxx           # Client Secret
MONEY_S3_APP_ID=xxxxxxxx                  # ID aplikace (z money.cz, pouziva se v token URL)

# Volitelne — agenda (pokud nenastavite, pouzijte nastroj switch_agenda)
MONEY_S3_AGENDA_GUID=                     # Vychozi agenda GUID (pro pouziti s jednou agendou)
MONEY_S3_LEGISLATION=                     # CZ nebo SK (auto-detekce pokud nenastavite)

# Volitelne — pro Resource Owner Password Credentials flow
MONEY_S3_USERNAME=                         # Uzivatelske jmeno (bez mezer!)
MONEY_S3_PASSWORD=                         # Heslo

# Volitelne — lokalni pristup
MONEY_S3_LOCAL=false                       # true = localhost:85

# Volitelne — paginace
MAX_PAGE_SIZE=50                           # Max zaznamu na stranku (vychozi 50, zvyste pro vykonnejsi modely)

# Volitelne — import polling
IMPORT_POLL_TIMEOUT_MS=30000               # Max cekani na async import (ms)
IMPORT_POLL_INTERVAL_MS=1000               # Interval pollingu (ms)

# Volitelne — transport (Docker / HTTP)
MCP_TRANSPORT=stdio                        # "stdio" (vychozi) nebo "http" (Docker)
MCP_PORT=3000                              # Port pro HTTP rezim
MCP_AUTH_TOKEN=                            # Bearer token pro HTTP auth (doporuceno pro produkci)

Kde najdu pristupove udaje?

  1. MONEY_S3_DOMAIN — domena vaseho Money S3 cloudu (cast pred .api.moneys3.eu)
  2. Client ID / Secret — v Money S3 jdete do Nastaveni > API > Klice API, vytvorte novy klic
  3. App ID — vyplnte formular na money.cz, ID aplikace vam prijde emailem
  4. Agenda GUID (volitelne) — v Money S3 jdete do Nastaveni > Agendy, kliknete na agendu, GUID je v detailu. Pokud nenastavite, pouzijte nastroj list_agendas a switch_agenda za behu.

Sestaveni a spusteni

# Sestaveni TypeScriptu
npm run build

# Spusteni (produkce, stdio — vychozi)
npm start

# Spusteni HTTP rezimu (pro Docker / sitovy pristup)
MCP_TRANSPORT=http MCP_PORT=3000 npm start

# Vyvoj s automatickym reloadem
npm run dev

Pouziti s Claude Desktop

Pridejte do claude_desktop_config.json:

{
  "mcpServers": {
    "money-s3": {
      "command": "node",
      "args": ["/absolutni/cesta/k/money-s3-mcp-server/dist/index.js"],
      "env": {
        "MONEY_S3_DOMAIN": "moje-domena",
        "MONEY_S3_CLIENT_ID": "vas-client-id",
        "MONEY_S3_CLIENT_SECRET": "vas-client-secret",
        "MONEY_S3_APP_ID": "vase-app-id"
      }
    }
  }
}

Poznamka: MONEY_S3_AGENDA_GUID je volitelny. Pokud ho nenastavite, pouzijte list_agendas a switch_agenda pro vyber agendy za behu. Pro jednoagendove nasazeni ho muzete pridat do env.

Umisteni konfiguracniho souboru:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Po restartu Claude Desktop se server automaticky spusti a zpristupni 187 nastroju.

Pouziti s Claude Code

Pres CLI (doporuceno)

# Stdio (lokalni vyvoj)
claude mcp add money-s3 node /cesta/k/money-s3-mcp-server/dist/index.js \
  --transport stdio \
  --env MONEY_S3_DOMAIN=moje-domena \
  --env MONEY_S3_CLIENT_ID=vas-client-id \
  --env MONEY_S3_CLIENT_SECRET=vas-client-secret \
  --env MONEY_S3_APP_ID=vase-app-id

# HTTP (Docker / remote server)
claude mcp add money-s3 https://vas-server.example.com/mcp \
  --transport http \
  --header "Authorization: Bearer VAS_MCP_AUTH_TOKEN"

Rucne pres settings.json

Pridejte do .claude/settings.json v projektu nebo globalne:

{
  "mcpServers": {
    "money-s3": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/cesta/k/money-s3-mcp-server",
      "env": {
        "MONEY_S3_DOMAIN": "moje-domena",
        "MONEY_S3_CLIENT_ID": "vas-client-id",
        "MONEY_S3_CLIENT_SECRET": "vas-client-secret",
        "MONEY_S3_APP_ID": "vase-app-id"
      }
    }
  }
}

Spusteni v Dockeru

Server podporuje HTTP transport pomoci StreamableHTTPServerTransport z MCP SDK — moderni protokol pro kontejnerizovane nasazeni.

Rychly start s Docker Compose

  1. Zkopirujte .env.example na .env a doplnte pristupove udaje
  2. Nastavte bezpecnostni token:
cp .env.example .env
# Doplnte MONEY_S3_DOMAIN, CLIENT_ID, CLIENT_SECRET, APP_ID
# Nastavte MCP_AUTH_TOKEN pro zabezpeceni:
echo "MCP_AUTH_TOKEN=$(openssl rand -hex 32)" >> .env
  1. Spustte:
docker compose up --build -d
  1. Overeni:
# Health check (verejny, bez tokenu)
curl http://localhost:3000/health
# → {"status":"ok"}

# MCP endpoint (vyzaduje token)
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VAS_TOKEN" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'

Rucni Docker build

docker build -t money-s3-mcp .
docker run -d -p 3000:3000 --env-file .env money-s3-mcp

Automaticky start po rebootu

Kontejner ma restart: always, takze se automaticky spusti po restartu. Predpoklad: Docker daemon musi byt zapnuty pri startu systemu.

# Overeni, ze Docker startuje pri bootu (systemd)
sudo systemctl enable docker

# Overeni, ze kontejner bezi a ma restart policy "always"
docker inspect --format '{{.HostConfig.RestartPolicy.Name}}' money-s3-mcp-server-money-s3-mcp-1
# → always

Pokud pouzivate docker run misto Compose, pridejte --restart always:

docker run -d --restart always -p 3000:3000 --env-file .env money-s3-mcp

Vlastnosti Docker obrazu

  • Multi-stage build — prvni faze kompiluje TypeScript, druha obsahuje jen produkci
  • node:22-alpine — minimalni obraz (~50 MB)
  • Non-root uzivatel — bezi pod mcpuser (UID 1001)
  • HEALTHCHECK — Docker automaticky kontroluje /health kazdych 30s
  • Graceful shutdown — reaguje na SIGTERM (Docker stop)
  • restart: always — kontejner se automaticky spusti po rebootu i po padu

Transporty

Server podporuje dva transportni rezimy, vyber pres env promennou MCP_TRANSPORT:

RezimPopisPouziti
stdio (vychozi)stdin/stdout, MCP pres podprocesClaude Desktop, Claude Code, lokalni vyvoj
httpStreamable HTTP na portu MCP_PORTDocker, sitove nasazeni, vice klientu

HTTP transport — endpointy

EndpointMetodaPopis
/healthGETHealth check — vzdy verejny (pro Docker HEALTHCHECK / load balancer)
/mcpPOSTMCP zpravy (klient → server) — chraneny tokenem
/mcpGETSSE notifikace (server → klient) — chraneny tokenem
/mcpDELETEUkonceni MCP session — chraneny tokenem

Zabezpeceni HTTP transportu

Kdyz je server v HTTP rezimu, endpoint /mcp je ve vychozim stavu otevreny (pro snadny lokalni vyvoj). Pro produkci nutne nastavit MCP_AUTH_TOKEN.

Konfigurace

# Generovani nahodneho tokenu
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)

Jak to funguje

  • Nastaven MCP_AUTH_TOKEN → kazdý pozadavek na /mcp musi obsahovat hlavicku Authorization: Bearer <token>
  • Nenastaven MCP_AUTH_TOKEN → endpoint je nechraneny (varování do logu)
  • /health je vzdy verejny — neni chraneny tokenem (pro Docker HEALTHCHECK, load balancery)

HTTP odpovedi pri chybe autentizace

SituaceHTTP kodOdpoved
Chybi hlavicka Authorization401{"error":"Missing Authorization header"}
Spatny format (ne Bearer <token>)401{"error":"Invalid Authorization header format"}
Neplatny token403{"error":"Invalid token"}

Token je porovnavan pomoci crypto.timingSafeEqual() — odolny vuci timing attackum.

Pripojeni AI klienta pres HTTP

AI klient (napr. Claude Desktop Remote, vlastni agent) se pripojuje takto:

{
  "mcpServers": {
    "money-s3": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer VAS_TOKEN"
      }
    }
  }
}

Priklady pouziti v Claude

"Vypis vsechny vydane faktury z ledna 2025"

"Kolik mame neuhrazenych pohledavek?"

"Najdi firmu s ICO 12345678 a ukaž jeji kontaktni udaje"

"Vytvor vydanou fakturu pro firmu ABC s.r.o. na 10 000 Kc za konzultacni sluzby"

"Jake zbozi mame na sklade s mnozstvim pod 5 kusu?"

"Ukaž pokladni doklady za posledni tyden"

"Kolik zamestnancu mame a jake maji pracovni pomery?"

"Ukaz mi dostupne agendy a prepni na firmu ABC"

"Prepni na agendu XYZ a vypis vydane faktury za brezen"

Dostupne nastroje (187)

Faktury (10 nastroju)

NastrojPopis
list_issued_invoicesVydane faktury s filtrovanim dle data, firmy, neuhrazene castky
get_issued_invoiceDetail vydane faktury vcetne polozek, plateb, DPH souhrnu
create_issued_invoiceVytvori vydanou fakturu s polozkami
update_issued_invoiceAktualizuje vydanou fakturu (identifikace pres GUID)
delete_issued_invoiceSmaze vydanou fakturu
list_received_invoicesPrijate faktury s filtrovanim dle data, firmy, neuhrazene castky
get_received_invoiceDetail prijate faktury
create_received_invoiceVytvori prijatou fakturu
update_received_invoiceAktualizuje prijatou fakturu
delete_received_invoiceSmaze prijatou fakturu

Adresaŕ firem (5 nastroju)

NastrojPopis
list_companiesFirmy z adresare s filtrovanim dle ICO, nazvu, kodu
get_companyDetail firmy vcetne kontaktnich osob, pobocek
create_companyVytvori novou firmu v adresari
update_companyAktualizuje firmu
delete_companySmaze firmu

Pokladna, banka, interni doklady (25 nastroju)

NastrojPopis
list_cash_vouchersPokladni doklady s filtrovanim dle data, pokladny, popisu
get_cash_voucherDetail pokladniho dokladu
create_cash_voucherVytvori pokladni doklad
update_cash_voucherAktualizuje pokladni doklad
delete_cash_voucherSmaze pokladni doklad
list_bank_statementsBankovni vypisy s filtrovanim dle data, bankovniho uctu, popisu
get_bank_statementDetail bankovniho vypisu
create_bank_statementVytvori bankovni vypis
update_bank_statementAktualizuje bankovni vypis
delete_bank_statementSmaze bankovni vypis
list_internal_documentsInterni doklady
get_internal_documentDetail interniho dokladu
create_internal_documentVytvori interni doklad
update_internal_documentAktualizuje interni doklad
delete_internal_documentSmaze interni doklad
list_liabilitiesZavazky
get_liabilityDetail zavazku
create_liabilityVytvori zavazek
update_liabilityAktualizuje zavazek
delete_liabilitySmaze zavazek
list_receivablesPohledavky
get_receivableDetail pohledavky
create_receivableVytvori pohledavku
update_receivableAktualizuje pohledavku
delete_receivableSmaze pohledavku

Sklad (42 nastroju)

NastrojPopis
list_articlesSkladove karty (artikly) s filtrovanim dle nazvu, kodu
get_articleDetail artiklu
create_articleVytvori artikl (skladovou kartu)
update_articleAktualizuje artikl
delete_articleSmaze artikl
list_warehouse_stocksSkladove zasoby s aktualnim mnozstvim
get_warehouse_stockDetail zasoby
create_warehouse_stockVytvori skladovou zasobu
update_warehouse_stockAktualizuje skladovou zasobu
delete_warehouse_stockSmaze skladovou zasobu
list_warehousesSeznam skladu
list_received_slipsPrijemky
create_received_slipVytvori prijemku
update_received_slipAktualizuje prijemku
delete_received_slipSmaze prijemku
list_issued_slipsVydejky
create_issued_slipVytvori vydejku
update_issued_slipAktualizuje vydejku
delete_issued_slipSmaze vydejku
list_sale_slipsProdejky
create_sale_slipVytvori prodejku
update_sale_slipAktualizuje prodejku
delete_sale_slipSmaze prodejku
list_transfer_notesPrevodky
create_transfer_noteVytvori prevodku
update_transfer_noteAktualizuje prevodku
delete_transfer_noteSmaze prevodku
list_received_delivery_notesPrijate dodaci listy
create_received_delivery_noteVytvori prijaty dodaci list
update_received_delivery_noteAktualizuje prijaty dodaci list
delete_received_delivery_noteSmaze prijaty dodaci list
list_issued_delivery_notesVydane dodaci listy
create_issued_delivery_noteVytvori vydany dodaci list
update_issued_delivery_noteAktualizuje vydany dodaci list
delete_issued_delivery_noteSmaze vydany dodaci list
list_production_notesVyrobni listy
list_stock_takingsInventury
list_stock_taking_documentsInventurni doklady
create_stock_taking_documentVytvori inventurni doklad
update_stock_taking_documentAktualizuje inventurni doklad
delete_stock_taking_documentSmaze inventurni doklad
list_stock_taking_typesTypy inventur

Objednavky, nabidky, poptavky (26 nastroju)

NastrojPopis
list_received_ordersPrijate objednavky
create_received_orderVytvori prijatou objednavku
update_received_orderAktualizuje prijatou objednavku
delete_received_orderSmaze prijatou objednavku
list_issued_ordersVydane objednavky
create_issued_orderVytvori vydanou objednavku
update_issued_orderAktualizuje vydanou objednavku
delete_issued_orderSmaze vydanou objednavku
list_received_offersPrijate nabidky
create_received_offerVytvori prijatou nabidku
update_received_offerAktualizuje prijatou nabidku
delete_received_offerSmaze prijatou nabidku
list_issued_offersVydane nabidky
create_issued_offerVytvori vydanou nabidku
update_issued_offerAktualizuje vydanou nabidku
delete_issued_offerSmaze vydanou nabidku
list_received_inquiriesPrijate poptavky
create_received_inquiryVytvori prijatou poptavku
update_received_inquiryAktualizuje prijatou poptavku
delete_received_inquirySmaze prijatou poptavku
list_issued_inquiriesVydane poptavky
create_issued_inquiryVytvori vydanou poptavku
update_issued_inquiryAktualizuje vydanou poptavku
delete_issued_inquirySmaze vydanou poptavku
list_servicesServisni doklady
list_repairsOpravy

Ciselniky (51 nastroju)

NastrojPopis
list_currenciesMeny (ISO kody, kurzy)
list_centresStrediska
create_centreVytvori stredisko
update_centreAktualizuje stredisko
delete_centreSmaze stredisko
list_operationsCinnosti
create_operationVytvori cinnost
update_operationAktualizuje cinnost
delete_operationSmaze cinnost
list_numerical_seriesCiselne rady
list_bank_account_cash_boxesBankovni ucty a pokladny
create_bank_account_cash_boxVytvori bankovni ucet/pokladnu
update_bank_account_cash_boxAktualizuje bankovni ucet/pokladnu
delete_bank_account_cash_boxSmaze bankovni ucet/pokladnu
list_vat_classificationsKlasifikace DPH
create_vat_classificationVytvori klasifikaci DPH
update_vat_classificationAktualizuje klasifikaci DPH
delete_vat_classificationSmaze klasifikaci DPH
list_account_chartsUctovy rozvrh (uctova osnova)
create_account_chartVytvori ucet v rozvrhu
update_account_chartAktualizuje ucet v rozvrhu
delete_account_chartSmaze ucet z rozvrhu
list_countriesStaty (ISO kody)
list_constant_symbolsKonstantni symboly
list_exchange_listsKurzovni listky
list_price_levelsCenove hladiny
list_vat_purposesUcely DPH
list_address_keysKlice adres
list_shippingsDopravci
list_parametersParametry (pro zasoby)
create_parameterVytvori parametr
update_parameterAktualizuje parametr
delete_parameterSmaze parametr
list_banksBanky (ciselnik)
list_combined_nomenclaturesKombinovana nomenklatura (celni kody)
list_municipality_postal_codesObce a PSC
create_vat_accounting_accVytvori uctovani DPH (podvojne)
update_vat_accounting_accAktualizuje uctovani DPH (podvojne)
delete_vat_accounting_accSmaze uctovani DPH (podvojne)
create_vat_accounting_trVytvori uctovani DPH (danova evidence)
update_vat_accounting_trAktualizuje uctovani DPH (danova evidence)
delete_vat_accounting_trSmaze uctovani DPH (danova evidence)
create_account_assignment_accVytvori predkontaci (podvojne)
update_account_assignment_accAktualizuje predkontaci (podvojne)
delete_account_assignment_accSmaze predkontaci (podvojne)
create_account_assignment_trVytvori predkontaci (danova evidence)
update_account_assignment_trAktualizuje predkontaci (danova evidence)
delete_account_assignment_trSmaze predkontaci (danova evidence)
create_account_movementVytvori ucetni pohyb
update_account_movementAktualizuje ucetni pohyb
delete_account_movementSmaze ucetni pohyb

Ucetnictvi (8 nastroju)

NastrojPopis
list_journal_accsUcetni zurnal (podvojne ucetnictvi)
list_journal_trsPenezni zurnal (danova evidence)
list_account_assignments_accPredkontace (podvojne ucetnictvi)
list_account_assignments_trPredkontace (danova evidence)
list_account_movementsUcetni pohyby
list_vat_accounting_accsUctovani DPH (podvojne ucetnictvi)
list_vat_accounting_trsUctovani DPH (danova evidence)
list_non_monetary_paymentsNepenezni platidla (stravenky, poukazky)

Zamestnanci a mzdy (7 nastroju)

NastrojPopis
list_employeesZamestnanci s filtrovanim dle jmena, osobniho cisla
get_employeeDetail zamestnance vcetne pracovnich pomeru
list_employment_typesTypy pracovnich pomeru
list_employment_codesKody pracovnich pomeru (CSSZ)
create_wageVytvori mzdu zamestnanci za mesic/rok
update_wageAktualizuje mzdu
delete_wageSmaze mzdu

Agendy a zakazky (12 nastroju)

NastrojPopis
list_agendasDostupne agendy (firmy) v systemu — funguje i bez nastavene agendy
switch_agendaPrepne aktivni agendu (vsechny nasledujici operace budou pracovat s touto agendou)
get_current_agendaZobrazi aktualne nastavenou agendu (GUID)
list_yearsUcetni roky aktualni agendy
list_job_ordersZakazky s filtrovanim
get_job_orderDetail zakazky
create_job_orderVytvori zakazku
update_job_orderAktualizuje zakazku
delete_job_orderSmaze zakazku
list_job_order_typesTypy zakazek
list_eshopsE-shopy pripojene k agende
list_activitiesAktivity

Import status (1 nastroj)

NastrojPopis
check_import_statusZkontroluje stav asynchronniho importu podle GUID

Architektura

src/
├── index.ts                     # Vstupni bod — McpServer + stdio/HTTP transport
├── config.ts                    # Zod-validovana konfigurace z env promennych
├── auth/oauth.ts                # OAuth 2.0 (Client Credentials + ROPC flow)
├── graphql/
│   ├── client.ts                # GraphQL klient s automatickou autentizaci a timeouty
│   ├── queries/ (10 souboru)    # GraphQL dotazy dle domeny
│   └── mutations/ (8 souboru)   # GraphQL mutace dle domeny
├── tools/ (10 souboru)          # 187 MCP nastroju
├── helpers/
│   ├── types.ts                 # Sdilene typy, rozhrani a Zod schemata
│   ├── response.ts              # Standardizovane odpovedi + withErrorHandler
│   ├── mutation.ts              # Sdileny vzor mutace s kontrolou isSuccess
│   ├── import-poller.ts         # Polling stavu asynchronniho importu
│   ├── pagination.ts            # Prevod page/pageSize na skip/take
│   ├── filters.ts               # Sestaveni GraphQL filtru z jednoduchych parametru
│   └── legislation.ts           # Auto-detekce CZ/SK legislativy a filtrace poli

Jak funguje zapis dat

Vsechny zapisy (create/update/delete) v Money S3 API jsou asynchronni. Mutace vraci ImportPromise s GUID a server automaticky polluje vysledek pres importStatus, nez vrati odpoved AI agentovi.

1. Tool zavola GraphQL mutaci
2. API vrati ImportPromise { guid, isSuccess }
3. Server polluje importStatus(guid) kazdou sekundu
4. Az state = OK/WARNING/ERROR, vrati vysledek agentovi

CZ/SK legislativa

Money S3 podporuje ceskou (CZ) i slovenskou (SK) legislativu. Nektere pole v GraphQL API jsou dostupne pouze pro slovenskou legislativu — pri dotazu na ceske agende API vrati chybu "Member is available only for 'Sk' legislation".

Server tuto situaci resi automaticky:

  1. Prvni dotaz na agendu odesle vsechna pole (predpoklada SK)
  2. Pokud API vrati chybu legislativy, oznaci agendu jako CZ
  3. SK pole se automaticky odstrani z dotazu a pozadavek se opakuje
  4. Vsechny dalsi dotazy uz SK pole neobsahuji (zadny zbytecny pozadavek navic)

Legislativu lze vynutit pres env promennou MONEY_S3_LEGISLATION=CZ (nebo SK). Pokud neni nastavena, detekuje se automaticky.

Aktualni legislativu agendy zjistite nastrojem get_current_agenda.

Reseni potizi

"Chyba autentizace"

  • Overite spravnost MONEY_S3_CLIENT_ID a MONEY_S3_CLIENT_SECRET
  • Overite, ze API klic je aktivni v Money S3
  • Pro ROPC flow: uzivatelske jmeno nesmi obsahovat mezery

"Agenda neni nastavena"

  • Nastavte MONEY_S3_AGENDA_GUID v env, nebo pouzijte nastroj list_agendas a nasledne switch_agenda

"GraphQL chyba"

  • Skontrolujte, ze aktivni agenda je platny GUID existujici agendy
  • Overite, ze API klic ma opravneni k dane agende

"API_VERSIONING_MISSMATCH" nebo "Uzivatel nebyl prihlasen"

  • Restartujte Windows sluzbu S3Api (v Task Manager / Services) — resi 99% pripadu
  • V extremnim pripade: odhlaste vsechny uzivatele Money S3, vypnete Money, restartujte sluzbu
  • Zkontrolujte stav v Money S3: Nastroje > S3api

"Import nebyl dokoncen"

  • Zvyste IMPORT_POLL_TIMEOUT_MS (vychozi 30s)
  • Pouzijte nastroj check_import_status s GUID pro rucni kontrolu

Server se nespusti

  • Overite, ze mate Node.js >= 20 (node --version)
  • Overite, ze jsou nainstalovane zavislosti (npm install)
  • Overite, ze projekt je sestaven (npm run build)

Skripty

SkriptPopis
npm run buildSestavi TypeScript do dist/
npm startSpusti server (produkce)
npm run devSpusti server s automatickym reloadem (vyvoj)
npm run typecheckZkontroluje typy bez sestaveni
npm run lintSpusti ESLint

Technicky stack

VrstvaTechnologie
RuntimeNode.js >= 20
JazykTypeScript 5.x (strict mode)
MCP SDK@modelcontextprotocol/sdk
GraphQL klientgraphql-request
Validacezod
Transportstdio (Claude Desktop / CLI) nebo HTTP (Docker / sit)
KontejnerizaceDocker (multi-stage Alpine build)
HTTP authBearer token (MCP_AUTH_TOKEN, timing-safe porovnani)

Licence

MIT

Ver o original no GitHub

Bom para

Relacionados