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 ../openmcp-sdk -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

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.

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
• dev-docs/upgatesapiv2.apib — API specifikace dodavatele
• CONTRIBUTING.md

Licence

CC BY-NC 4.0