Chameleoon MCP Server

Co dělá MCP Server “Chameleoon”?

Chameleoon MCP Server poskytuje bezproblémovou integraci mezi platformou pro správu přepravy Chameleoon a AI asistenty prostřednictvím Model Context Protocol (MCP). Umožňuje e-commerce firmám, logistickým týmům a operacím splnění automatizovat přepravní pracovní postupy pomocí příkazů v přirozeném jazyce. Server se připojuje k multi-kurýrní platformě Chameleoon, což umožňuje AI asistentům vytvářet přepravní objednávky, sledovat doručení napříč více dopravci, generovat přepravní štítky v různých formátech, plánovat vyzvedávání kurýry a spravovat celý životní cyklus přepravy bez manuální navigace v přehledech. To transformuje složité logistické operace na jednoduché konverzační příkazy, což dramaticky snižuje čas strávený opakujícími se přepravními úkoly.

Seznam výzev

Vytváření a správa objednávek

Vytvořit přepravní objednávku pro Johna Smithe na Main Street 123, Praha 10000, Česká republika pomocí kurýra GLS

Zobrazit všechny přepravní objednávky vytvořené za posledních 7 dní

Najít všechny objednávky se stavem 'čekající' od kurýra DPD

Smazat přepravní objednávku s ID 12345

Získat podrobné informace o objednávce ID 67890 včetně historie sledování

Sledování a monitorování balíků

Sledovat balík s číslem zásilky 06515700194651

Zobrazit aktuální stav a polohu všech objednávek odeslaných do Německa tento měsíc

Najít informace o sledování pro referenční číslo ORDER-2026-001

Které balíky jsou aktuálně v přepravě a kdy se očekává jejich doručení?

Zobrazit všechny doručené objednávky za posledních 14 dní s jejich daty doručení

Generování přepravních štítků

Generovat přepravní štítky A4 pro objednávky 123, 456 a 789

Vytvořit termální štítky ve formátu A6 pro všechny objednávky připravené k vyzvednutí dnes

Získat štítky ve formátu ZPL pro tiskárnu Zebra pro tato čísla zásilek: [seznam]

Generovat štítky pro všechny objednávky GLS vytvořené včera ve formátu A4

Výběr kurýra a služeb

Vypsat všechny dostupné kurýry a jejich funkce jako podpora vyzvedávání a tisk manifestů

Zobrazit, které konfigurace kurýrů jsou k dispozici pro přepravu na Slovensko

Jaké jsou dostupné profily pro kurýra DPD?

Plánování a správa vyzvedávání

Zobrazit všechny objednávky způsobilé k vyzvednutí kurýrem dnes

Naplánovat vyzvednutí pro DPD s těmito čísly zásilek: [seznam]

Vypsat všechny objednávky vyzvednutí za poslední 3 dny seskupené podle kurýra

Validace a kontrola kvality

Validovat tuto přepravní objednávku před vytvořením: jméno příjemce, adresa, hmotnost a nastavení kurýra

Zkontrolovat, zda je tato adresa platná pro doručení GLS do Rakouska

Validovat všechny objednávky čekající na odeslání a zobrazit ty s chybami nebo varováními

Připraveni rozšířit své podnikání?

Začněte svou bezplatnou zkušební verzi ještě dnes a viďte výsledky během několika dní.

Požádat o demo Přihlásit se

Seznam zdrojů

Chameleoon MCP Server nevystavuje explicitní zdroje. Veškerý přístup k datům je založen na nástrojích.

Seznam nástrojů

Chameleoon MCP Server poskytuje 14 komplexních nástrojů organizovaných do pěti kategorií:

Nástroje pro správu kurýrů

1. list_couriers

• Účel: Získat dostupné přepravní kurýry/dopravce s jejich schopnostmi
• Parametry: Žádné
• Vrací: Seznam kurýrů s ID, názvy, funkcemi (podpora vyzvedávání, tisk manifestů)
• Případ použití: Určit, kteří kurýři jsou k dispozici před vytvořením objednávek

2. list_courier_configurations

• Účel: Získat profily/konfigurace kurýrů pro vytváření přepravních objednávek
• Parametry: Žádné
• Vrací: Dostupné konfigurace kurýrů s ID profilů a nastavením
• Případ použití: Najít platné hodnoty profilů potřebné pro vytvoření objednávky

Nástroje pro přepravní objednávky

3. list_shipping_orders

• Účel: Vypsat a filtrovat přepravní objednávky
• Parametry:
  • date_from (volitelné): Datum zahájení (YYYY-MM-DD)
  • date_to (volitelné): Datum ukončení (YYYY-MM-DD)
  • reference (volitelné): Filtrovat podle referenčního čísla
  • status (volitelné): Filtrovat podle stavu objednávky
  • state (volitelné): Filtrovat podle stavu objednávky
  • courier_id (volitelné): Filtrovat podle kurýra
  • limit (volitelné): Maximální výsledky (1-100)
  • offset (volitelné): Offset pro stránkování
• Vrací: Objednávky se sledovacími URL, počtem a aplikovanými filtry
• Případ použití: Monitorovat objednávky, najít konkrétní zásilky, generovat reporty

4. get_shipping_order

• Účel: Získat podrobné informace pro konkrétní objednávku podle interního ID
• Parametry:
  • order_id (povinné): Interní identifikátor objednávky
• Vrací: Kompletní detaily objednávky včetně historie sledování
• Případ použití: Hluboký ponor do konkrétního stavu a historie objednávky

5. get_order_tracking

• Účel: Sledovat balík podle čísla zásilky/sledování kurýra
• Parametry:
  • shipping_number (povinné): Sledovací číslo kurýra
• Vrací: Detaily objednávky, historie sledování, aktuální stav, informace o příjemci, sledovací URL
• Případ použití: Zákaznický servis, aktualizace stavu doručení

6. create_shipping_order

• Účel: Vytvořit novou přepravní objednávku s konkrétním kurýrem a profilem
• Parametry:
  • courier_id (povinné): Identifikátor kurýra (např.: ‘gls’, ‘dpd’, ‘packeta’)
  • profile (povinné): ID profilu z konfigurací kurýrů
  • reference_number (povinné): Vaše referenční číslo objednávky
  • recipient_name (povinné): Celé jméno příjemce
  • recipient_street (povinné): Adresa ulice
  • recipient_city (povinné): Město
  • recipient_zip (povinné): PSČ
  • recipient_country (povinné): ISO kód země (např.: ‘SK’, ‘CZ’)
  • recipient_company (volitelné): Název firmy
  • recipient_phone (volitelné): Telefonní číslo
  • recipient_email (volitelné): E-mailová adresa
  • package_weight (volitelné): Hmotnost v kg
  • package_width (volitelné): Šířka v cm
  • package_height (volitelné): Výška v cm
  • package_length (volitelné): Délka v cm
  • cod_amount (volitelné): Částka dobírky
  • cod_currency (volitelné): Měna dobírky (např.: ‘EUR’)
  • note (volitelné): Poznámka pro kurýra
• Vrací: Potvrzení úspěchu, číslo zásilky, URL štítku
• Případ použití: Automatizované splnění objednávky, dávková přeprava

7. delete_shipping_order

• Účel: Smazat jednu přepravní objednávku
• Parametry:
  • order_id (povinné): ID objednávky ke smazání
• Vrací: Potvrzení úspěchu
• Případ použití: Zrušit chybné objednávky, vyčistit testovací objednávky

8. delete_shipping_orders_batch

• Účel: Smazat více objednávek najednou
• Parametry:
  • order_ids (povinné): Pole ID objednávek (max 20)
• Vrací: Potvrzení úspěchu s počtem smazaných ID
• Případ použití: Hromadné čištění, dávková zrušení

Validační nástroje

9. validate_shipping_order

• Účel: Validovat objednávku před vytvořením pro kontrolu chyb
• Parametry: Stejné jako create_shipping_order
• Vrací: Výsledky validace s chybami a varováními
• Případ použití: Zabránit neúspěšným objednávkám, ověřit přesnost adresy

Nástroje pro přepravní štítky

10. get_shipping_labels

• Účel: Generovat PDF přepravní štítky pro objednávky
• Parametry:
  • courier_id (povinné): Identifikátor kurýra
  • profile (povinné): Profil kurýra
  • shipping_numbers (povinné): Pole čísel zásilek
  • label_format (volitelné): ‘a4’, ‘a6’, nebo ‘zpl’ (výchozí: ‘a4’)
  • position (volitelné): Výchozí pozice na vícenásobných štítcích
• Vrací: Base64 kódované PDF nebo ZPL formátové štítky
• Případ použití: Tisknout štítky pro balíky, automatizované generování štítků

Nástroje pro správu vyzvedávání

11. list_pickup_orders

• Účel: Získat objednávky způsobilé k vyzvednutí kurýrem
• Parametry:
  • date_from (volitelné): Datum zahájení (YYYY-MM-DD)
  • date_to (volitelné): Datum ukončení (YYYY-MM-DD)
  • state (volitelné): Filtrovat podle stavu vyzvednutí
  • courier_id (volitelné): Filtrovat podle kurýra
• Vrací: Objednávky způsobilé k vyzvednutí se sledovacími URL
• Případ použití: Připravit denní vyzvednutí, naplánovat sběry

12. create_pickup

• Účel: Naplánovat žádost o vyzvednutí kurýrem
• Parametry:
  • courier_id (povinné): Identifikátor kurýra
  • shipping_numbers (povinné): Pole čísel zásilek k vyzvednutí
• Vrací: Potvrzení vyzvednutí, číslo vyzvednutí, volitelný manifest (base64)
• Případ použití: Automatizovat denní vyzvedávání, koordinovat sběry

Přihlaste se k odběru newsletteru

Získejte nejnovější tipy, trendy a nabídky zdarma.

E-mailová adresa

Přihlásit se

Případy použití tohoto MCP serveru

Zpracování vysokého objemu objednávek

Pondělní ráno po víkendu: Když zpracováváte více než 200 objednávek nahromadilých přes víkend, ruční vytváření každého přepravního štítku se stává nemožným. Místo trávení 4-5 hodin klikáním v přehledech použijte “Vytvořit přepravní objednávky pro všechny zaplacené objednávky od pátku do neděle pomocí optimálního kurýra pro každou destinaci” ke zpracování celé dávky během minut. AI automaticky vybere nejlepšího kurýra na základě destinace, validuje adresy, generuje štítky a poskytne sledovací čísla - transformuje úkol spotřebovávající ráno na 10minutovou operaci.

Krize splnění flash výprodeje: Váš flash výprodej generoval 350 objednávek za 24 hodin a zákazníci očekávají dodání ve stejný den. Ruční zpracování by zabralo celému týmu celý den. Přikažte “Validovat všechny objednávky z dávky flash výprodeje, vytvořit přepravní štítky pro platné adresy a označit problematické pro kontrolu”, abyste okamžitě oddělili 340 objednávek připravených k odeslání od 10 vyžadujících opravy adres. Váš skladový tým může okamžitě začít balit, zatímco zákaznický servis řeší výjimky.

Správa sezónního špičky v období svátků: Během prosincové špičky zvládáte 5× normální objem s dočasným personálem, který není vyškolen na vašem přepravním systému. Místo jejich školení na složitých přehledech jednoduše řeknou AI “Vytvořit přepravní objednávku GLS pro [jméno a adresa zákazníka]” a okamžitě obdrží vytištěné štítky. To zkracuje čas školení z hodin na minuty a eliminuje nákladné chyby přepravy během vašeho nejkritičtějšího prodejního období.

Optimalizace sazeb u více kurýrů

Analýza nákladů mezinárodních objednávek: Obdržíte 45 mezinárodních objednávek ve 12 zemích. Ruční kontrola přepravních sazeb pro každou kombinaci kurýrů by zabrala hodiny a pravděpodobně by vedla k přeplácení. Zeptejte se “Porovnat přepravní sazby napříč všemi dostupnými kurýry pro tyto mezinárodní destinace: [seznam]” a okamžitě uvidíte, který kurýr nabízí nejlepší sazbu pro každou zemi. Tato jediná analýza může ušetřit stovky v přepravních nákladech denně a zároveň zajistit rychlejší dodací lhůty.

Výběr kurýra pro hromadnou zásilku: Potřebujete poslat 100 identických produktů na různé tuzemské adresy. Místo slepého používání vašeho výchozího kurýra přikažte “Analyzovat možnosti kurýrů pro 100 balíků, každý o hmotnosti 2kg, na tyto adresy. Ukázat rozdíl v celkových nákladech mezi kurýry včetně objemových slev.” To odhalí, že přepnutí z vašeho výchozího DPD na GLS pro tuto dávku ušetří 380 EUR - úspory, které se skládají v každé hromadné zásilce.

Optimalizace objednávek na dobírku: Máte 30 objednávek na dobírku dnes. Ne všichni kurýři zacházejí s dobírkou stejně - někteří účtují vyšší poplatky, jiní mají lepší úspěšnost. Použijte “Kteří kurýři podporují doručení na dobírku na tyto adresy s nejnižšími kombinovanými poplatky za přepravu a dobírku?” k automatickému směrování každé objednávky k nejekonomičtějšímu kurýrovi schopnému dobírky, což snižuje vaše náklady na zpracování dobírky o 15-20%.

Proaktivní správa doručení

Komunikace se zákazníky o opožděných zásilkách: Je čtvrteční odpoledne a víte, že někteří zákazníci očekávají páteční doručení. Místo čekání na rozzlobené hovory přikažte “Ukázat všechny balíky naplánované na páteční doručení, které jsou aktuálně zpožděny nebo stále v tranzitu bez očekávaných aktualizací doručení.” To identifikuje 12 rizikových doručení. Proaktivně kontaktujete tyto zákazníky s aktualizovanými harmonogramy a slevovými kódy, čímž transformujete potenciální stížnosti na ocenění vaší transparentnosti.

Příprava víkendového doručení: V pátek ve 16 hodin potřebujete identifikovat, které objednávky nedoručí před pondělím. Zeptejte se “Vypsat všechny objednávky odeslané tento týden zobrazující aktuální stav a odhadované doručení. Označit ty, které se k zákazníkům nedostanou před pondělím.” To okamžitě odhalí 18 objednávek uvízlých ve víkendovém tranzitu. Pošlete proaktivní páteční večerní e-maily s potvrzeními pondělního doručení, což dramaticky snižuje pondělní ranní dotazy “kde je moje objednávka?”.

Prevence ztracených balíků: Místo čekání, až zákazníci ohlásí chybějící balíky, spusťte denní kontrolu: “Ukázat všechny balíky odeslané před více než 7 dny bez stavu doručeno, seskupené podle kurýra.” Tento systém včasného varování zachytí balíky uvízlé v tranzitním limbu před tím, než si toho zákazníci všimnou, což vám umožní podat reklamace u kurýrů a proaktivně odeslat náhrady.

Efektivita skladových operací

Denní koordinace vyzvedávání na více místech: Provozujete tři skladové lokality, každá odesílající s DPD, GLS a Packeta. Ruční koordinace šesti samostatných vyzvedávání kurýrů denně znamená šest telefonátů a žonglování s více časovými okny. Místo toho přikažte “Naplánovat vyzvedávání pro všechny připravené objednávky na všech místech: sklad Varšava pro DPD a GLS, sklad Praha pro všechny tři kurýry, sklad Berlín pouze pro DPD.” AI naplánuje všechna vyzvedávání současně, poskytne potvrzovací čísla a vygeneruje manifesty - snížení 90 minut telefonní koordinace na 3 minuty instrukce v přirozeném jazyce.

Správa fronty tiskárny přepravních štítků: Váš sklad má tři balicí stanice: jednu s termálními tiskárnami (štítky A6), jednu se standardními tiskárnami (štítky A4) a jednu s tiskárnami Zebra (formát ZPL). Místo ručního třídění objednávek podle stanice použijte “Generovat termální štítky A6 pro objednávky 1-50 pro stanici jedna, štítky A4 pro objednávky 51-100 pro stanici dva a formát ZPL pro objednávky 101-120 pro stanici tři.” Každá balicí stanice okamžitě obdrží správně formátované štítky, čímž se eliminují chyby kompatibility tiskáren a úzká místa pracovního postupu.

Konečné denní skladové odsouhlasení: Před uzavřením v 18 hodin potřebujete ověřit, že všechny vybrané objednávky mají přepravní štítky a všechny dnes vygenerované štítky byly skutečně použity. Přikažte “Ukázat všechny objednávky označené jako vybrané bez přepravních štítků a všechny dnes vygenerované štítky nepřiřazené k vybraným objednávkám.” To odhalí 3 objednávky bez štítků (seznam výběru dokončen, ale zásilka nevytvořena) a 2 štítky vygenerované pro objednávky stále čekající na výběr - což vám umožní vyřešit nesrovnalosti před uzavřením skladu místo jejich objevení následující ráno.

Validace adres a prevence chyb

Hromadná validace adres objednávek: Obdrželi jste firemní hromadnou objednávku se 150 adresami zaměstnanců pro doručení dárků. Zpracování těchto bez validace riskuje míru selhání 10-15% z překlepů a neúplných adres. Místo vytváření neúspěšných zásilek spusťte “Validovat všechny adresy v této dávce před vytvořením objednávek. Seskupit výsledky do ověřených adres, opravitelných adres potřebujících menší opravy a neplatných adres vyžadujících kontakt se zákazníkem.” To zabraňuje neúspěšným doručením, snižuje náklady na zpáteční přepravu a umožňuje vám vyřešit problémy s adresami před odesláním, ne po neúspěšných pokusech o doručení.

Formátování mezinárodních adres: Rozšiřujete se na nové evropské trhy, ale každá země má různé požadavky na formátování adres. Adresa v Praze se významně liší od adresy v Berlíně nebo Vídni. Místo studia poštovních předpisů pro každou zemi jednoduše přikažte “Validovat tuto přepravní objednávku pro doručení do České republiky” před vytvořením. Systém automaticky zkontroluje formát ulice, platnost PSČ a konzistenci názvu města - čímž zabraňuje frustraci z balíků zamítnutých zahraničními kurýry kvůli chybám formátování.

Detekce čísel bytů a apartmánů: Všimnete si, že mnoho selhání doručení pochází z chybějících čísel bytů - zákazníci zadávají “Main Street 123” bez “Apt 5B.” Před zpracováním dnešních 80 objednávek spusťte “Identifikovat všechny adresy bez čísel bytů, apartmánů, pater nebo jednotek v dnešních objednávkách.” To označí 12 potenciálně neúplných adres. Rychlý ověřovací hovor ušetří 12 neúspěšných doručení, 12 opětovných zásilek a 12 frustrovaných zákazníků.

Excelence zákaznického servisu

Okamžitý stav objednávky pro hovory zákazníků: Váš zákaznický servis přijímá 50+ hovorů “kde je moje objednávka?” denně. Místo toho, aby každý agent přihlašoval do přepravní platformy, hledal objednávky, nacházel sledovací čísla, kontroloval weby kurýrů a vysvětloval stav, jednoduše se zeptají AI “Sledovat balík pro zákazníka Johna Smithe, číslo objednávky 2024-12345.” AI okamžitě odpoví s aktuální polohou, stavem doručení a sledovacím URL ke sdílení - snížení průměrné doby zpracování hovoru ze 4 minut na 45 sekund a dramatické zlepšení spokojenosti zákazníků.

Dávkové aktualizace stavu pro VIP zákazníky: Váš podnikový klient zadal objednávku na 200 jednotek odesílaných na různá místa. Chtějí aktualizaci stavu všech zásilek. Místo ručního kontrolování 200 sledovacích čísel použijte “Ukázat stav doručení pro všechny objednávky s referencí CLIENT-BULK-2024-001, seskupené podle doručeno, v tranzitu a zpožděno.” Vygenerujte formátovaný report za 30 sekund místo trávení 3 hodin ručními kontrolami sledování.

Generování štítku na vrácení: Zákazník chce vrátit svou objednávku. Místo vytváření návratového štítku přes několik obrazovek systému váš podpůrný agent jednoduše řekne “Vytvořit návratový přepravní štítek z [adresa zákazníka] do našeho skladu pomocí GLS s referencí RETURN-ORDER-12345.” Zákazník obdrží svůj návratový štítek e-mailem za méně než minutu, což zlepšuje návratový zážitek a zkracuje dobu vyřešení podpůrného ticketu.

Analýza a správa nákladů

Měsíční analýza přepravních nákladů: Máte podezření, že za přepravu přeplácíte, ale chybí vám čas na ruční analýzu stovek objednávek. Přikažte “Ukázat všechny objednávky z minulého měsíce seskupené podle kurýra, s celkovými přepravními náklady, průměrnými náklady na balík a mírou úspěšnosti doručení.” To odhalí, že zatímco Kurýr A vypadá levněji za balík, jejich 12% míra neúspěšného doručení znamená, že skutečné náklady na úspěšné doručení jsou vyšší než 98% míra úspěchu Kurýra B. Výběr kurýra řízený daty na základě skutečných nákladů, ne jen nabídnutých sazeb.

Benchmarking výkonu dopravců: Pracujete se čtyřmi kurýry, ale chybí vám objektivní data o výkonu. Použijte “Porovnat všechny kurýry z minulého čtvrtletí: průměrná doba doručení, procento včasného doručení, míra neúspěšného doručení a průměrné náklady. Ukázat nejlepšího výkonného pro tuzemskou versus mezinárodní přepravu.” To odhalí, že DPD vyniká v tuzemské rychlosti, ale GLS nabízí lepší mezinárodní spolehlivost - což vám umožní strategicky směrovat objednávky místo použití univerzálního přístupu.

Optimalizace dodacích zón: Zvažujete otevření druhého skladu pro zlepšení dodacích lhůt. Před investicí se zeptejte “Analyzovat dodací časy na všechna PSČ, na která dodáváme, seskupené podle regionu. Ukázat průměrné tranzitní dny a identifikovat oblasti s trvale pomalým doručením.” Tato geografická analýza odhalí, že 60% vašich 3+ denních doručení směřuje do jihovýchodních regionů - validace business case pro regionální distribuční centrum a projekce potenciálních zlepšení dodacích časů.

Podpora sezónních a propagačních kampaní

Plánování kapacity před kampaní: Spouštíte propagaci “Bezplatná přeprava v pátek” s očekáváním 3× normálního objemu objednávek. Zeptejte se “Na základě současné kapacity vyzvedávání kurýrů a plánování, kolik objednávek může každý kurýr zvládnout, pokud obdržíme 600 objednávek v pátek? Jaká je naše maximální zpracovatelská kapacita?” To odhalí, že vaše současné dohody s kurýry podporují maximálně 450 objednávek. Proaktivně zajistíte dodatečnou kapacitu vyzvedávání s kurýry před spuštěním propagace, čímž zabráníte krizi splnění, která sužovala loňskou propagaci.

Objednávky s více příjemci v období dárků: Během svátků mnoho zákazníků objednává dárky odesílané různým příjemcům. Místo ručního vytváření 8 samostatných zásilek pro dárkový seznam jednoho zákazníka použijte “Vytvořit přepravní objednávky pro zákazníka ORDER-HOLIDAY-789: 8 různých příjemců na těchto adresách, všichni používající poznámku dárkového balení a stejnou fakturační referenci.” Zpracujte složité objednávky s více příjemci za sekundy při zachování přesné atribuce objednávky pro zákaznický servis a účetnictví.

Správa termínu dodání ve stejný den: Slibujete dodání ve stejný den pro objednávky zadané před 14. hodinou. V 13:45 potřebujete vědět přesně, které objednávky jsou těsně před termínem. Přikažte “Ukázat všechny zaplacené objednávky z dneška, u kterých ještě nebyly vytvořeny přepravní štítky. Kolik jich můžeme zpracovat a naplánovat vyzvednutí pro dodání ve stejný den?” To odhalí, že 23 objednávek potřebuje okamžitou pozornost. Upřednostníte je před termínem 14 hodin, čímž udržíte svůj slib dodání ve stejný den a konkurenční výhodu.

Jak to nastavit

Požadavky

• Nainstalovaný Python 3.10 nebo vyšší
• Účet Chameleoon s přístupem k API (registrace na chameleoon.sk)
• Platný CHAMELEOON_API_KEY

Windsurf

1. Získejte svůj API klíč Chameleoon:

   • Přihlaste se ke svému účtu Chameleoon na chameleoon.sk
   • Přejděte na Nastavení > Přístup k API
   • Vygenerujte nebo zkopírujte svůj API klíč

2. Najděte konfigurační soubor MCP Windsurf:

   • macOS: ~/Library/Application Support/Windsurf/mcp.json
   • Windows: %APPDATA%\Windsurf\mcp.json
   • Linux: ~/.config/Windsurf/mcp.json

3. Přidejte konfiguraci Chameleoon MCP serveru:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. Uložte konfigurační soubor a restartujte Windsurf kompletně.

5. Ověřte připojení:

   • Otevřete panel MCP ve Windsurf
   • Hledejte “chameleoon” v seznamu aktivních serverů
   • Vyzkoušejte testovací příkaz: “Vypsat dostupné kurýry”

Claude Desktop

1. Získejte své přihlašovací údaje API Chameleoon z chameleoon.sk (viz Požadavky).

2. Najděte konfiguraci Claude Desktop:

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

3. Aktualizujte nebo vytvořte konfigurační soubor:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. Uložte soubor a plně restartujte Claude Desktop (ukončete a znovu spusťte).

5. Potvrďte připojení serveru:

   • Otevřete Claude Desktop
   • Hledejte panel integrace MCP
   • Ověřte, že se “Chameleoon MCP Server” zobrazuje jako připojený
   • Testujte: “Ukázat seznam dostupných přepravních kurýrů”

Cursor

1. Zaregistrujte se a získejte přístup k API na chameleoon.sk (viz Požadavky).

2. Najděte konfigurační soubor MCP Cursor:

   • macOS: ~/Library/Application Support/Cursor/mcp.json
   • Windows: %APPDATA%\Cursor\mcp.json
   • Linux: ~/.config/Cursor/mcp.json

3. Přidejte záznam MCP serveru:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. Uložte a restartujte Cursor.

5. Zkontrolujte stav serveru:

   • Otevřete panel MCP Cursor (Zobrazit > MCP servery)
   • Ujistěte se, že “chameleoon” se zobrazuje jako aktivní
   • Vyzkoušejte: “Vypsat moje přepravní objednávky z tohoto týdne”

Cline

1. Získejte API klíč Chameleoon z chameleoon.sk.

2. Najděte konfigurační soubor Cline (umístění se liší podle instalace Cline).

3. Přidejte Chameleoon MCP server:

   {
     "mcpServers": {
       "chameleoon": {
         "command": "python3",
         "args": ["-m", "chameleoon_mcp_server"],
         "env": {
           "CHAMELEOON_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

4. Uložte, restartujte Cline a ověřte, že se server zobrazuje v dostupných MCP serverech.

5. Testujte připojení: “Získat seznam konfigurací kurýrů”

Osvědčené postupy zabezpečení

Nikdy nekódujte API klíče natvrdo. Vždy používejte proměnné prostředí:

{
  "mcpServers": {
    "chameleoon": {
      "command": "python3",
      "args": ["-m", "chameleoon_mcp_server"],
      "env": {
        "CHAMELEOON_API_KEY": "${CHAMELEOON_API_KEY}"
      }
    }
  }
}

Poté nastavte proměnnou prostředí na úrovni systému:

• macOS/Linux: Přidejte do ~/.bashrc nebo ~/.zshrc: export CHAMELEOON_API_KEY="your_key"
• Windows: Nastavte přes Vlastnosti systému > Proměnné prostředí

Omezte oprávnění API klíče ve svém účtu Chameleoon pouze na potřebné operace.

Pravidelně rotujte klíče a okamžitě odvolejte staré klíče v případě kompromitace.

Používejte samostatné klíče pro vývojová, stagingová a produkční prostředí.

Jak používat tento MCP uvnitř toků

Používání MCP ve FlowHunt

Pro integraci Chameleoon MCP Server do vašeho pracovního postupu FlowHunt pro automatizované přepravní operace postupujte podle těchto kroků:

1. Přidejte komponentu MCP:
   • Otevřete svůj tok FlowHunt nebo vytvořte nový
   • Přetáhněte komponentu MCP z panelu komponent
   • Připojte ji k vaší komponentě AI agenta

2. Nakonfigurujte MCP server:
   • Klikněte na komponentu MCP pro otevření konfigurace
   • V sekci konfigurace systémového MCP vložte detaily vašeho Chameleoon MCP serveru:

{
  "chameleoon": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/path/to/chameleoon/mcp"
  }
}

Nahraďte URL vaším skutečným koncovým bodem Chameleoon MCP serveru.

3. Nastavte proměnné prostředí:

   • V nastavení prostředí FlowHunt přidejte:
     • Klíč: CHAMELEOON_API_KEY
     • Hodnota: Váš API klíč Chameleoon

4. Nakonfigurujte svého AI agenta: Po připojení může váš AI agent používat přirozený jazyk k řízení přepravních operací. Příklady výzev:

   • “Vytvořit přepravní objednávku pro zákazníka Johna Smithe na…”
   • “Sledovat všechny objednávky od včerejška”
   • “Generovat štítky pro objednávky čekající na odeslání”
   • “Naplánovat vyzvednutí pro objednávky DPD”

5. Vytvořte automatizované pracovní postupy:

   Příklad: Tok splnění objednávky

   • Spouštěč: Nová objednávka v systému elektronického obchodu
   • Akce 1: Extrahovat adresu zákazníka a detaily objednávky
   • Akce 2: Komponenta MCP instruuje AI: “Vytvořit přepravní objednávku s těmito detaily: [data objednávky]”
   • Akce 3: Uložit číslo zásilky a sledovací URL
   • Akce 4: Poslat potvrzovací e-mail zákazníkovi s odkazem na sledování

   Příklad: Denní přepravní report

   • Spouštěč: Plán (denně v 9 ráno)
   • Akce 1: Komponenta MCP se ptá AI: “Vypsat všechny objednávky od včerejška”
   • Akce 2: Analyzovat data pro poznatky
   • Akce 3: Generovat souhrnný report
   • Akce 4: Poslat logistickému týmu

   Příklad: Automatizace zákaznického servisu

   • Spouštěč: Dotaz zákazníka s číslem objednávky
   • Akce 1: Extrahovat číslo objednávky ze zprávy
   • Akce 2: Komponenta MCP: “Sledovat balík s referencí [order_number]”
   • Akce 3: Formátovat informace o sledování
   • Akce 4: Poslat odpověď zákazníkovi se stavem a sledovacím URL

Hodnocení MCP serveru

Přehled

Náš názor

Chameleoon MCP Server poskytuje robustní, produkčně připravenou integraci pro automatizaci správy přepravy. Vyniká komplexním pokrytím nástrojů napříč celým životním cyklem přepravy - od výběru kurýra a vytváření objednávek až po sledování, generování štítků a plánování vyzvedávání.

Silné stránky:

• Kompletní pokrytí: 14 dobře navržených nástrojů pokrývajících všechny přepravní operace
• Podpora více kurýrů: Funguje s DPD, GLS, Packeta a dalšími evropskými dopravci
• Praktické funkce: Univerzální sledovací URL, více formátů štítků, dávkové operace
• Zaměření na byznys: Jasné případy použití pro elektronický obchod, logistiku a malé firmy
• Vědomí zabezpečení: Konfigurace proměnných prostředí, žádné zakódované přihlašovací údaje

Nejvhodnější pro:

• Firmy elektronického obchodu automatizující splnění objednávek
• Logistické týmy spravující operace více kurýrů
• Malé firmy hledající automatizaci přepravy bez složitých API
• Vývojáře vytvářející přepravní pracovní postupy ve FlowHunt nebo podobných platformách
• Týmy zákaznického servisu potřebující rychlý přístup k informacím o sledování

Omezení:

• Regionální zaměření (především evropští kurýři)
• Vyžaduje účet Chameleoon a přístup k API
• Žádné vystavené zdroje (veškerý přístup je založen na nástrojích)

Server transformuje složité interakce s přepravním API na jednoduché příkazy v přirozeném jazyce, čímž činí pokročilou automatizaci logistiky přístupnou netechnickým uživatelům a zároveň poskytuje pokročilým uživatelům komplexní programovou kontrolu.

MCP skóre

Poznámka: Počty forků a hvězd nejsou k dispozici, protože se jedná o interní/proprietární implementaci MCP serveru.