upgates-com-mcp

MCP konektor pro Upgates e-shop API v2. Čtecí přístup k objednávkám, fakturám, produktům, zákazníkům a konfiguraci e-shopu s pseudonymizací osobních údajů.

Součást platformy OpenMCP.cz.

Poznámka k historii: konektor původně vznikl v TypeScriptu. Od a8f71aa (7/2026) je implementován v Pythonu nad openmcp-sdk; TS strom byl odstraněn a je dohledatelný v git historii.

Rychlý start

python -m venv .venv && . .venv/bin/activate
pip install -e .
export OPENMCP_MODE=local-stdio
export UPGATES_API_URL="https://vas-eshop.admin.s17.upgates.com/api/v2"
export UPGATES_API_LOGIN="api-login"
export UPGATES_API_KEY="api-klic"
export OPENMCP_PII_SALT="$(openssl rand -hex 32)"
python -m connector

pip si openmcp-sdk stáhne z GitHubu podle commitu připnutého v pyproject.toml — na PyPI SDK není, protože tam jméno patří nesouvisejícímu projektu. Bez přístupu k GitHubu (nebo když chcete přesně ten snapshot, se kterým se staví produkční image) použijte vendorovaný archiv z repozitáře:

python release/materialize_sdk.py --root . --output /tmp/openmcp-sdk
pip install /tmp/openmcp-sdk -e .

API přístup se zakládá v Upgates Admin → Doplňky → API.

OPENMCP_PII_SALT je povinný — bez něj konektor záměrně nenastartuje. Tichý fallback na náhodný salt by zrušil stabilitu pseudonymizačních tokenů a projevilo by se to až po restartu.

Related MCP server: mcp-server-woocommerce

Nástroje (23)

Všechny jsou pouze ke čtení; konektor nezapisuje ani nemaže.

Seznam musí odpovídat display.tools v connector.yaml — z něj platforma klasifikuje oprávnění nástrojů.

Osobní údaje

Údaje zákazníků (e-maily, telefony, jména, adresy, IČO/DIČ, bankovní spojení) se před odesláním do modelu nahradí stabilními tokeny typu <EMAIL_3f9c1a2b4d5e>. Token je jednosměrný HMAC — nedá se rozšifrovat zpět a nikde nevzniká re-identifikační mapa.

Katalogová data (produkty, kategorie, ceny) se nepseudonymizují. Ochranu osobních údajů nelze operátorskou konfigurací vypnout.

Konfigurace

V režimu local-stdio se čtou z env jako UPGATES_<KEY> velkými písmeny.

Testy

python -m pytest tests -q
openmcp-sdk validate connector.yaml

Dokumentace

• docs/anonymization.md — pseudonymizace

• docs/readonly.md — read-only režim

• docs/defaults.md — výchozí hodnoty a limity

• docs/tools.md — nástroje

• CONTRIBUTING.md — postup a nároky na změny

• SECURITY.md — hlášení zranitelností

API specifikaci Upgates repozitář nešíří (viz .gitignore); aktuální verzi najdete v dokumentaci Upgates.

Licence

MIT — viz LICENSE.