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

---

<p align="center"> <strong>Automatizujte svůj Upgates e-shop s AI!</strong> 🚀 </p>