Upgates MCP Server

AI asistent pro automatizaci Upgates e-shopů

Model Context Protocol (MCP) server pro propojení s Upgates e-shop API v2.

🚀 Rychlý start

1. Instalace

git clone https://github.com/LukasOrcik/upgates-com-mcp.git
cd upgates-com-mcp
npm install
npm run build

2. Konfigurace

Vytvořte API přístup v Upgates Admin > Doplňky > API a přidejte do claude_desktop_config.json:

{
  "mcpServers": {
    "upgates": {
      "command": "node",
      "args": ["/absolute/path/to/upgates-com-mcp/dist/index.js"],
      "env": {
        "UPGATES_API_URL": "https://your-shop.admin.s17.upgates.com/api/v2",
        "UPGATES_API_USERNAME": "your-api-username",
        "UPGATES_API_PASSWORD": "your-api-key",
        "UPGATES_READONLY": "true",
        "UPGATES_ANONYMIZE_DATA": "true"
      }
    }
  }
}

Viz .mcp.example.json pro template.

3. Použití v Claude AI

"Kolik máme dnes objednávek?"
"Které produkty jsou vyprodané?"
"Seznam nedokončených košíků za poslední týden"

📦 Dostupné nástroje (34)

| Kategorie | Count | Příklady | |-----------|-------|----------| | Objednávky | 5 | list, create, update, delete, history | | Produkty | 5 | list, list_simple, create, update, delete | | Zákazníci | 2 | list, create | | Faktury | 1 | list | | Košíky | 1 | list | | Kupóny | 2 | list, create | | Webhooky | 3 | list, create, events | | Číselníky | 9 | statuses, labels, payments, shipments... | | Konfigurace | 4 | languages, config, owner, api_status |

Kompletní seznam →

🔒 Bezpečnost

GDPR Anonymizace

UPGATES_ANONYMIZE_DATA=true  # Anonymizuje 40+ polí

Více →

Readonly režim

UPGATES_READONLY=true  # Blokuje write operace

Více →

📚 Dokumentace

Uživatelská

• Nástroje - Seznam všech 34 nástrojů
• Smart Defaults - Výchozí hodnoty a filtry
• Anonymizace - GDPR ochrana

Provozní

• Production - Deployment checklist
• Changelog - Historie verzí
• Release Notes - v0.1.0 release

Vývojářská

• Contributing - Jak přispět
• GitHub Issues - Issue templates

Externí

• Upgates API Docs

📊 Statistiky

• Kód: 2,716 řádků TypeScript
• Testy: 23/23 passing (100%)
• Build: ~2 sekundy
• Optimalizace: 82-99.8% token reduction
• Testováno: EdgarPower shop (23,794 orders, 87 products)

🤝 Podpora a komunita

Máte problém nebo nápad?

• 🐛 Nahlásit chybu
• ✨ Navrhnout funkci
• 🚀 Navrhnout vylepšení
• 💬 Diskuze

Komunita

• GitHub Discussions - Otázky a tipy

⚡ Rychlé odkazy

• Instalace - Jak začít
• Konfigurace - Nastavení
• Nástroje - Co můžete dělat
• Production - Nasazení
• Contributing - Jak přispět

📄 Licence

CC-BY-NC-4.0 - Attribution-NonCommercial 4.0 International

Pro komerční využití kontaktujte autora.

👨‍💻 Autor

Lukáš Orčík Neziskový projekt OpenMCP Specialista na e-commerce automatizaci a AI integrace

Repository: https://github.com/LukasOrcik/upgates-com-mcp