Chameleoon MCP Server

Ce face MCP Server “Chameleoon”?

Chameleoon MCP Server oferă integrare perfectă între platforma de gestionare expedieri Chameleoon și asistenții AI prin Model Context Protocol (MCP). Permite întreprinderilor de comerț electronic, echipelor logistice și operațiunilor de îndeplinire să automatizeze fluxurile de lucru de expediere folosind comenzi în limbaj natural. Serverul se conectează la platforma multi-curier Chameleoon, permițând asistenților AI să creeze comenzi de expediere, să urmărească livrări pe mai mulți transportatori, să genereze etichete de expediere în diverse formate, să programeze ridicări de curieri și să gestioneze întregul ciclu de viață al expedierii fără navigare manuală în tabloul de bord. Acest lucru transformă operațiunile logistice complexe în comenzi conversaționale simple, reducând dramatic timpul petrecut cu sarcini repetitive de expediere.

Lista de Instrucțiuni

Crearea și Gestionarea Comenzilor

Creează o comandă de expediere pentru John Smith la Main Street 123, Praga 10000, Republica Cehă folosind curierul GLS

Arată-mi toate comenzile de expediere create în ultimele 7 zile

Găsește toate comenzile cu statusul 'în așteptare' de la curierul DPD

Șterge comanda de expediere cu ID 12345

Obține informații detaliate despre comanda ID 67890 inclusiv istoricul de urmărire

Urmărirea și Monitorizarea Coletelor

Urmărește coletul cu numărul de expediere 06515700194651

Arată-mi statusul actual și locația tuturor comenzilor expediate în Germania luna aceasta

Găsește informațiile de urmărire pentru numărul de referință ORDER-2026-001

Care colete sunt în tranzit în prezent și când se așteaptă să sosească?

Arată-mi toate comenzile livrate din ultimele 14 zile cu datele lor de livrare

Generarea Etichetelor de Expediere

Generează etichete de expediere A4 pentru comenzile 123, 456 și 789

Creează etichete termice în format A6 pentru toate comenzile gata de ridicat astăzi

Obține etichete în format ZPL pentru imprimanta Zebra pentru aceste numere de expediere: [listă]

Generează etichete pentru toate comenzile GLS create ieri în format A4

Selecția Curierului și Serviciilor

Listează toți curierii disponibili și caracteristicile lor precum suportul pentru ridicări și imprimarea manifestelor

Arată-mi ce configurații de curieri sunt disponibile pentru expediere în Slovacia

Care sunt profilurile disponibile pentru curierul DPD?

Programarea și Gestionarea Ridicărilor

Arată-mi toate comenzile eligibile pentru ridicarea de către curier astăzi

Programează o ridicare pentru DPD cu aceste numere de expediere: [listă]

Listează toate comenzile de ridicare din ultimele 3 zile grupate pe curier

Validarea și Controlul Calității

Validează această comandă de expediere înainte de creare: numele destinatarului, adresa, greutatea și setările curierului

Verifică dacă această adresă este validă pentru livrarea GLS în Austria

Validează toate comenzile care așteaptă expediere și arată-mi pe cele cu erori sau avertismente

Pregătit să îți dezvolți afacerea?

Începe perioada de probă gratuită astăzi și vezi rezultate în câteva zile.

Solicită demo Autentificare

Lista de Resurse

Chameleoon MCP Server nu expune resurse explicite. Tot accesul la date este bazat pe instrumente.

Lista de Instrumente

Chameleoon MCP Server oferă 14 instrumente cuprinzătoare organizate în cinci categorii:

Instrumente de Gestionare Curieri

1. list_couriers

• Scop: Recuperează curierii/transportatorii de expediere disponibili cu capacitățile lor
• Parametri: Niciunul
• Returnează: Lista de curieri cu ID-uri, nume, caracteristici (suport ridicări, imprimare manifeste)
• Caz de utilizare: Determină ce curieri sunt disponibili înainte de a crea comenzi

2. list_courier_configurations

• Scop: Obține profiluri/configurații de curieri pentru crearea comenzilor de expediere
• Parametri: Niciunul
• Returnează: Configurații de curieri disponibile cu ID-uri de profil și setări
• Caz de utilizare: Găsește valori de profil valide necesare pentru crearea comenzii

Instrumente pentru Comenzi de Expediere

3. list_shipping_orders

• Scop: Listează și filtrează comenzile de expediere
• Parametri:
  • date_from (opțional): Data de început (YYYY-MM-DD)
  • date_to (opțional): Data de sfârșit (YYYY-MM-DD)
  • reference (opțional): Filtrează după numărul de referință
  • status (opțional): Filtrează după statusul comenzii
  • state (opțional): Filtrează după starea comenzii
  • courier_id (opțional): Filtrează după curier
  • limit (opțional): Rezultate maxime (1-100)
  • offset (opțional): Offset paginare
• Returnează: Comenzi cu URL-uri de urmărire, număr și filtre aplicate
• Caz de utilizare: Monitorizează comenzi, găsește expediții specifice, generează rapoarte

4. get_shipping_order

• Scop: Obține informații detaliate pentru o comandă specifică după ID-ul intern
• Parametri:
  • order_id (obligatoriu): Identificator intern al comenzii
• Returnează: Detalii complete ale comenzii inclusiv istoricul de urmărire
• Caz de utilizare: Analiză detaliată a statusului și istoricului comenzii specifice

5. get_order_tracking

• Scop: Urmărește coletul după numărul de expediere/urmărire al curierului
• Parametri:
  • shipping_number (obligatoriu): Numărul de urmărire al curierului
• Returnează: Detalii comandă, istoric urmărire, stare actuală, info destinatar, URL urmărire
• Caz de utilizare: Serviciu clienți, actualizări status livrare

6. create_shipping_order

• Scop: Creează comandă nouă de expediere cu curier și profil specifice
• Parametri:
  • courier_id (obligatoriu): Identificator curier (ex: ‘gls’, ‘dpd’, ‘packeta’)
  • profile (obligatoriu): ID profil din configurații curieri
  • reference_number (obligatoriu): Numărul tău de referință comandă
  • recipient_name (obligatoriu): Numele complet al destinatarului
  • recipient_street (obligatoriu): Adresa străzii
  • recipient_city (obligatoriu): Orașul
  • recipient_zip (obligatoriu): Codul poștal
  • recipient_country (obligatoriu): Codul țării ISO (ex: ‘SK’, ‘CZ’)
  • recipient_company (opțional): Numele companiei
  • recipient_phone (opțional): Număr de telefon
  • recipient_email (opțional): Adresă de email
  • package_weight (opțional): Greutate în kg
  • package_width (opțional): Lățime în cm
  • package_height (opțional): Înălțime în cm
  • package_length (opțional): Lungime în cm
  • cod_amount (opțional): Suma ramburs
  • cod_currency (opțional): Moneda ramburs (ex: ‘EUR’)
  • note (opțional): Notă pentru curier
• Returnează: Confirmare succes, număr expediere, URL etichetă
• Caz de utilizare: Îndeplinire automată comenzi, expediere în lot

7. delete_shipping_order

• Scop: Șterge o singură comandă de expediere
• Parametri:
  • order_id (obligatoriu): ID-ul comenzii de șters
• Returnează: Confirmare succes
• Caz de utilizare: Anulează comenzi greșite, curăță comenzi de test

8. delete_shipping_orders_batch

• Scop: Șterge mai multe comenzi deodată
• Parametri:
  • order_ids (obligatoriu): Array de ID-uri comenzi (max 20)
• Returnează: Confirmare succes cu numărul de ID-uri șterse
• Caz de utilizare: Curățare în masă, anulări în lot

Instrumente de Validare

9. validate_shipping_order

• Scop: Validează comanda înainte de creare pentru a verifica erorile
• Parametri: Aceiași ca create_shipping_order
• Returnează: Rezultate validare cu erori și avertismente
• Caz de utilizare: Previne comenzi eșuate, verifică acuratețea adresei

Instrumente pentru Etichete de Expediere

10. get_shipping_labels

• Scop: Generează etichete de expediere PDF pentru comenzi
• Parametri:
  • courier_id (obligatoriu): Identificator curier
  • profile (obligatoriu): Profil curier
  • shipping_numbers (obligatoriu): Array de numere expediere
  • label_format (opțional): ‘a4’, ‘a6’, sau ‘zpl’ (implicit: ‘a4’)
  • position (opțional): Poziție de start pe foi multi-etichetă
• Returnează: Etichete codificate Base64 în format PDF sau ZPL
• Caz de utilizare: Imprimă etichete pentru colete, generare automată etichete

Instrumente de Gestionare Ridicări

11. list_pickup_orders

• Scop: Obține comenzi eligibile pentru ridicare de către curier
• Parametri:
  • date_from (opțional): Data de început (YYYY-MM-DD)
  • date_to (opțional): Data de sfârșit (YYYY-MM-DD)
  • state (opțional): Filtrează după starea ridicării
  • courier_id (opțional): Filtrează după curier
• Returnează: Comenzi eligibile pentru ridicare cu URL-uri de urmărire
• Caz de utilizare: Pregătește ridicarea zilnică, programează colectări

12. create_pickup

• Scop: Programează cerere de ridicare de către curier
• Parametri:
  • courier_id (obligatoriu): Identificator curier
  • shipping_numbers (obligatoriu): Array de numere expediere de colectat
• Returnează: Confirmare ridicare, număr ridicare, manifest opțional (base64)
• Caz de utilizare: Automatizează ridicări zilnice, coordonează colectări

Abonează-te la newsletter-ul nostru

Primește cele mai recente sfaturi, tendințe și oferte gratuit.

Adresă de email

Abonează-te

Cazuri de Utilizare ale acestui Server MCP

Procesarea Comenzilor cu Volum Mare

Luni dimineața după weekend: Când procesezi peste 200 de comenzi acumulate în weekend, crearea manuală a fiecărei etichete de expediere devine imposibilă. În loc să petreci 4-5 ore apăsând în tablouri de bord, folosește “Creează comenzi de expediere pentru toate comenzile plătite de vineri până duminică folosind curierul optim pentru fiecare destinație” pentru a procesa întregul lot în minute. AI-ul selectează automat cel mai bun curier pe baza destinației, validează adresele, generează etichete și furnizează numere de urmărire - transformând o sarcină care consumă dimineața într-o operațiune de 10 minute.

Criză de Îndeplinire Vânzare Flash: Vânzarea ta flash a generat 350 de comenzi în 24 de ore, iar clienții se așteaptă la expediere în aceeași zi. Procesarea manuală ar necesita întreaga zi pentru echipa ta. Comandă “Validează toate comenzile din lotul de vânzare flash, creează etichete de expediere pentru adrese valide și marchează pe cele problematice pentru revizuire” pentru a separa instant cele 340 de comenzi gata de expediere de cele 10 care necesită corecții de adresă. Echipa ta de depozit poate începe imediat ambalarea în timp ce serviciul clienți gestionează excepțiile.

Gestionarea Vârfului Sezonului Sărbătorilor: În timpul sezonului de vârf din decembrie, gestionezi un volum de 5 ori mai mare cu personal temporar care nu este instruit pe sistemul tău de expediere. În loc să îi instruiești pe tablouri de bord complexe, ei pur și simplu spun AI-ului “Creează comandă de expediere GLS pentru [nume și adresă client]” și primesc instant etichete printate. Acest lucru reduce timpul de instruire de la ore la minute și elimină erorile costisitoare de expediere în perioada ta de vânzări cea mai critică.

Optimizarea Tarifelor Multi-Curier

Analiza Costurilor Comenzi Internaționale: Primești 45 de comenzi internaționale în 12 țări. Verificarea manuală a tarifelor de expediere pentru fiecare combinație de curieri ar dura ore și probabil ar rezulta în plata în exces. Întreabă “Compară tarifele de expediere pe toți curierii disponibili pentru aceste destinații internaționale: [listă]” și vezi instant care curier oferă cel mai bun tarif pentru fiecare țară. Această singură analiză poate economisi sute în costuri de expediere pe zi asigurând în același timp timpi de livrare mai rapizi.

Selecția Curierului pentru Expediere în Masă: Trebuie să expediezi 100 de produse identice la adrese domestice diferite. În loc să folosești orbește curierul tău implicit, comandă “Analizează opțiunile de curieri pentru 100 de pachete, fiecare de 2kg, la aceste adrese. Arată-mi diferența de cost total între curieri inclusiv reducerile de volum.” Acest lucru relevă că schimbarea de la DPD-ul tău implicit la GLS pentru acest lot economisește 380 EUR - economii care se compun la fiecare expediere în masă.

Optimizarea Comenzilor Ramburs: Ai 30 de comenzi cu ramburs astăzi. Nu toți curierii gestionează rambursul la fel - unii taxează tarife mai mari, alții au rate de succes mai bune. Folosește “Care curieri suportă livrarea cu ramburs la aceste adrese cu cele mai mici taxe combinate de expediere și ramburs?” pentru a ruta automat fiecare comandă la curierul capabil de ramburs cel mai rentabil, reducând costurile tale de procesare ramburs cu 15-20%.

Gestionarea Proactivă a Livrărilor

Comunicarea cu Clienții pentru Expediții Întârziate: Este joi după-amiază și știi că unii clienți se așteaptă la livrări vineri. În loc să aștepți apeluri furioase, comandă “Arată-mi toate pachetele programate pentru livrare vineri care sunt întârziate în prezent sau încă în tranzit fără actualizări așteptate de livrare.” Acest lucru identifică 12 livrări la risc. Contactezi proactiv acești clienți cu calendare actualizate și coduri de reducere, transformând potențiale plângeri în apreciere pentru transparența ta.

Pregătirea Livrării de Weekend: Vineri la 16:00, trebuie să identifici care comenzi nu vor fi livrate înainte de luni. Întreabă “Listează toate comenzile expediate săptămâna aceasta arătând statusul actual și livrarea estimată. Marchează pe cele care nu vor ajunge la clienți înainte de luni.” Acest lucru revelează instant 18 comenzi blocate în tranzitul de weekend. Trimiți emailuri proactive vineri seara cu confirmări de livrare pentru luni, reducând dramatic întrebările de luni dimineață “unde este comanda mea?”.

Prevenirea Pachetelor Pierdute: În loc să aștepți ca clienții să raporteze pachete lipsă, rulează o verificare zilnică: “Arată-mi toate pachetele expediate cu peste 7 zile în urmă fără status livrat, grupate pe curier.” Acest sistem de avertizare timpurie prinde pachete blocate în limbo-ul tranzitului înainte ca clienții să observe, permițându-ți să depui reclamații la curieri și să expediezi proactiv înlocuiri.

Eficiența Operațiunilor de Depozit

Coordonarea Zilnică a Ridicărilor pe Mai Multe Locații: Operezi trei locații de depozit, fiecare expediind cu DPD, GLS și Packeta. Coordonarea manuală a șase ridicări separate de curieri zilnic înseamnă șase apeluri telefonice și jonglarea cu mai multe ferestre de timp. În schimb, comandă “Programează ridicări pentru toate comenzile gata la toate locațiile: depozitul Varșovia pentru DPD și GLS, depozitul Praga pentru toți cei trei curieri, depozitul Berlin doar pentru DPD.” AI-ul programează toate ridicările simultan, furnizează numere de confirmare și generează manifeste - reducând 90 de minute de coordonare telefonică la 3 minute de instrucțiuni în limbaj natural.

Gestionarea Cozii de Imprimantă Etichete Expediere: Depozitul tău are trei stații de ambalare: una cu imprimante termice (etichete A6), una cu imprimante standard (etichete A4) și una cu imprimante Zebra (format ZPL). În loc să sortezi manual comenzile pe stație, folosește “Generează etichete termice A6 pentru comenzile 1-50 pentru stația unu, etichete A4 pentru comenzile 51-100 pentru stația doi și format ZPL pentru comenzile 101-120 pentru stația trei.” Fiecare stație de ambalare primește instant etichete formatate corect, eliminând erorile de compatibilitate a imprimantei și blocajele fluxului de lucru.

Reconcilierea de Sfârșit de Zi a Depozitului: Înainte de închidere la 18:00, trebuie să verifici că toate comenzile preluate au etichete de expediere și toate etichetele generate astăzi au fost efectiv folosite. Comandă “Arată-mi toate comenzile marcate ca preluate fără etichete de expediere și toate etichetele generate astăzi neatribuite comenzilor preluate.” Acest lucru revelează 3 comenzi fără etichete (listă de preluare completată dar expediere necreată) și 2 etichete generate pentru comenzi încă în așteptarea preluării - permițându-ți să rezolvi discrepanțele înainte de închiderea depozitului în loc să le descoperi a doua zi dimineață.

Validarea Adreselor și Prevenirea Erorilor

Verificarea Adreselor Comenzi în Masă: Ai primit o comandă corporativă în masă cu 150 de adrese de angajați pentru livrarea cadourilor. Procesarea acestora fără validare riscă o rată de eșec de 10-15% din greșeli de tastare și adrese incomplete. În loc să creezi expediții eșuate, rulează “Validează toate adresele din acest lot înainte de a crea comenzi. Grupează rezultatele în adrese verificate, adrese corectabile necesitând corecții minore și adrese invalide necesitând contact cu clientul.” Acest lucru previne livrări eșuate, reduce costurile de returnare și îți permite să rezolvi problemele de adresă înainte de expediere, nu după încercări eșuate de livrare.

Formatarea Adreselor Internaționale: Te extinzi pe noi piețe europene, dar fiecare țară are cerințe diferite de formatare a adreselor. O adresă din Praga diferă semnificativ de una din Berlin sau Viena. În loc să studiezi regulamentele poștale pentru fiecare țară, pur și simplu comandă “Validează această comandă de expediere pentru livrare în Republica Cehă” înainte de creare. Sistemul verifică automat formatul străzii, validitatea codului poștal și consistența numelui orașului - prevenind frustrarea pachetelor respinse de curieri străini din cauza erorilor de formatare.

Detectarea Numerelor de Apartament și Suită: Observi că multe eșecuri de livrare sunt din numere de apartament lipsă - clienții introduc “Main Street 123” fără “Apt 5B.” Înainte de a procesa cele 80 de comenzi de astăzi, rulează “Identifică toate adresele fără numere de apartament, suită, etaj sau unitate în comenzile de astăzi.” Acest lucru marchează 12 adrese potențial incomplete. Un apel rapid de verificare salvează 12 livrări eșuate, 12 reexpediții și 12 clienți frustrați.

Excelență în Serviciul Clienți

Status Instant al Comenzii pentru Apeluri Clienți: Serviciul tău clienți primește peste 50 de apeluri zilnice “unde este comanda mea?”. În loc ca fiecare agent să se autentifice pe platforma de expediere, să caute comenzi, să găsească numere de urmărire, să verifice site-urile curierilor și să explice statusul, ei pur și simplu întreabă AI-ul “Urmărește pachetul pentru clientul John Smith, număr comandă 2024-12345.” AI-ul răspunde instant cu locația actuală, statusul livrării și URL-ul de urmărire de partajat - reducând timpul mediu de gestionare a apelului de la 4 minute la 45 de secunde și îmbunătățind dramatic satisfacția clienților.

Actualizări de Status în Lot pentru Clienți VIP: Clientul tău corporativ a plasat o comandă pentru 200 de unități expediate la diferite locații. Ei doresc o actualizare de status pe toate expediițiile. În loc să verifici manual 200 de numere de urmărire, folosește “Arată statusul de livrare pentru toate comenzile cu referința CLIENT-BULK-2024-001, grupate după livrat, în tranzit și întârziat.” Generează un raport formatat în 30 de secunde în loc să petreci 3 ore cu verificări manuale de urmărire.

Generarea Etichetei de Retur: Un client dorește să returneze comanda sa. În loc să creezi o etichetă de retur prin mai multe ecrane de sistem, agentul tău de suport pur și simplu spune “Creează o etichetă de expediere retur de la [adresa clientului] la depozitul nostru folosind GLS cu referința RETURN-ORDER-12345.” Clientul primește eticheta de retur prin email în mai puțin de un minut, îmbunătățind experiența de retur și reducând timpul de rezolvare a tichetului de suport.

Analiza și Gestionarea Costurilor

Analiza Lunară a Costurilor de Expediere: Suspectezi că plătești prea mult pentru expediere dar îți lipsește timpul să analizezi manual sute de comenzi. Comandă “Arată-mi toate comenzile din luna trecută grupate pe curier, cu costuri totale de expediere, cost mediu pe pachet și rate de succes ale livrării.” Acest lucru revelează că în timp ce Curierul A pare mai ieftin pe pachet, rata lor de 12% de livrări eșuate înseamnă că costul efectiv pe livrare reușită este mai mare decât rata de succes de 98% a Curierului B. Selecția curierului bazată pe date pe costuri reale, nu doar pe tarife cotate.

Benchmarking-ul Performanței Transportatorilor: Lucrezi cu patru curieri dar îți lipsesc date obiective de performanță. Folosește “Compară toți curierii din ultimul trimestru: timp mediu de livrare, procent de livrare la timp, rată de livrări eșuate și cost mediu. Arată-mi cel mai bun performer pentru expediere domestică versus internațională.” Acest lucru relevă că DPD excelează la viteza domestică dar GLS oferă fiabilitate internațională mai bună - permițându-ți să rutezi comenzile strategic în loc să folosești o abordare universală.

Optimizarea Zonelor de Livrare: Iei în considerare deschiderea unui al doilea depozit pentru a îmbunătăți timpii de livrare. Înainte de a investi, întreabă “Analizează timpii de livrare la toate codurile poștale la care expediem, grupate pe regiune. Arată zilele medii de tranzit și identifică zonele cu livrare constant lentă.” Această analiză geografică revelă că 60% din livrările tale de peste 3 zile merg în regiunile de sud-est - validând cazul de afaceri pentru un centru regional de distribuție și proiectând potențiale îmbunătățiri ale timpilor de livrare.

Suportul Campaniilor Sezoniere și Promoționale

Planificarea Capacității Pre-Campanie: Lansezi o promoție “Expediere Gratuită Vinerea” așteptându-te la un volum de comenzi de 3 ori mai mare. Întreabă “Pe baza capacității actuale de ridicare a curierilor și programării, câte comenzi poate gestiona fiecare curier dacă primim 600 de comenzi vineri? Care este capacitatea noastră maximă de procesare?” Acest lucru relevă că acordurile tale actuale cu curierii suportă maxim 450 de comenzi. Aranjezi proactiv capacitate suplimentară de ridicare cu curierii înainte de lansarea promoției, prevenind criza de îndeplinire care a afectat promoția anului trecut.

Comenzi Multi-Destinatar Sezon Cadouri: În timpul sărbătorilor, mulți clienți comandă cadouri expediate la destinatari diferiți. În loc să creezi manual 8 expediții separate pentru lista de cadouri a unui client, folosește “Creează comenzi de expediere pentru clientul ORDER-HOLIDAY-789: 8 destinatari diferiți la aceste adrese, toate folosind nota de ambalare cadou și aceeași referință de facturare.” Procesează comenzi complexe multi-destinatar în secunde menținând atribuirea precisă a comenzii pentru serviciul clienți și contabilitate.

Gestionarea Termenului de Expediere în Aceeași Zi: Promiti expediere în aceeași zi pentru comenzile plasate înainte de ora 14:00. La 13:45, trebuie să știi exact care comenzi sunt pe terminate. Comandă “Arată-mi toate comenzile plătite de astăzi fără etichete de expediere create încă. Câte putem procesa și programa ridicare pentru expediere în aceeași zi?” Acest lucru revelează că 23 de comenzi necesită atenție imediată. Dai prioritate acestora înainte de termenul de 14:00, menținând promisiunea ta de expediere în aceeași zi și avantajul competitiv.

Cum să-l configurezi

Cerințe preliminare

• Python 3.10 sau superior instalat
• Cont Chameleoon cu acces API (înregistrează-te la chameleoon.sk)
• CHAMELEOON_API_KEY valid

Windsurf

1. Obține cheia ta API Chameleoon:

   • Autentifică-te în contul tău Chameleoon la chameleoon.sk
   • Navighează la Setări > Acces API
   • Generează sau copiază cheia ta API

2. Localizează fișierul de configurare MCP al Windsurf:

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

3. Adaugă configurația serverului MCP Chameleoon:

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

4. Salvează fișierul de configurare și repornește complet Windsurf.

5. Verifică conexiunea:

   • Deschide panoul MCP din Windsurf
   • Caută “chameleoon” în lista de servere active
   • Încearcă o comandă de test: “Listează curierii disponibili”

Claude Desktop

1. Obține credențialele tale API Chameleoon de la chameleoon.sk (vezi Cerințe preliminare).

2. Localizează configurația 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. Actualizează sau creează fișierul de configurare:

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

4. Salvează fișierul și repornește complet Claude Desktop (închide și relansează).

5. Confirmă conexiunea serverului:

   • Deschide Claude Desktop
   • Caută panoul de integrări MCP
   • Verifică că “Chameleoon MCP Server” apare ca conectat
   • Testează cu: “Arată-mi lista curierilor de expediere disponibili”

Cursor

1. Înregistrează-te și obține acces API la chameleoon.sk (vezi Cerințe preliminare).

2. Găsește fișierul de configurare MCP al Cursor:

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

3. Adaugă intrarea serverului MCP:

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

4. Salvează și repornește Cursor.

5. Verifică starea serverului:

   • Deschide panoul MCP din Cursor (Vizualizare > Servere MCP)
   • Asigură-te că “chameleoon” apare ca activ
   • Încearcă: “Listează comenzile mele de expediere din această săptămână”

Cline

1. Obține cheia API Chameleoon de la chameleoon.sk.

2. Localizează fișierul de configurare Cline (locația variază în funcție de instalarea Cline).

3. Adaugă serverul MCP Chameleoon:

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

4. Salvează, repornește Cline și verifică că serverul apare în serverele MCP disponibile.

5. Testează conectivitatea: “Obține lista configurațiilor de curieri”

Cele Mai Bune Practici de Securitate

Nu codifica niciodată cheile API. Folosește întotdeauna variabile de mediu:

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

Apoi setează variabila de mediu la nivel de sistem:

• macOS/Linux: Adaugă la ~/.bashrc sau ~/.zshrc: export CHAMELEOON_API_KEY="your_key"
• Windows: Setează prin Proprietăți Sistem > Variabile de Mediu

Restricționează permisiunile cheii API în contul tău Chameleoon doar la operațiunile necesare.

Rotește cheile regulat și revocă imediat cheile vechi dacă sunt compromise.

Folosește chei separate pentru mediile de dezvoltare, staging și producție.

Cum să folosești acest MCP în fluxuri

Folosirea MCP în FlowHunt

Pentru a integra Chameleoon MCP Server în fluxul tău de lucru FlowHunt pentru operațiuni automatizate de expediere, urmează acești pași:

1. Adaugă Componenta MCP:
   • Deschide fluxul tău FlowHunt sau creează unul nou
   • Trage componenta MCP din panoul de componente
   • Conecteaz-o la componenta ta de agent AI

2. Configurează Serverul MCP:
   • Clic pe componenta MCP pentru a deschide configurația
   • În secțiunea de configurare MCP de sistem, inserează detaliile serverului tău MCP Chameleoon:

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

Înlocuiește URL-ul cu punctul final efectiv al serverului tău MCP Chameleoon.

3. Configurează Variabilele de Mediu:

   • În setările de mediu FlowHunt, adaugă:
     • Cheie: CHAMELEOON_API_KEY
     • Valoare: Cheia ta API Chameleoon

4. Configurează Agentul Tău AI: Odată conectat, agentul tău AI poate folosi limbajul natural pentru a controla operațiunile de expediere. Exemple de instrucțiuni:

   • “Creează o comandă de expediere pentru clientul John Smith la…”
   • “Urmărește toate comenzile de ieri”
   • “Generează etichete pentru comenzile care așteaptă expediere”
   • “Programează o ridicare pentru comenzile DPD”

5. Construiește Fluxuri de Lucru Automatizate:

   Exemplu: Flux de Îndeplinire Comenzi

   • Declanșator: Comandă nouă în sistemul de comerț electronic
   • Acțiune 1: Extrage adresa clientului și detaliile comenzii
   • Acțiune 2: Componenta MCP instruiește AI: “Creează comandă de expediere cu aceste detalii: [date comandă]”
   • Acțiune 3: Stochează numărul de expediere și URL-ul de urmărire
   • Acțiune 4: Trimite email de confirmare clientului cu link de urmărire

   Exemplu: Raport Zilnic de Expediere

   • Declanșator: Program (zilnic la ora 9)
   • Acțiune 1: Componenta MCP întreabă AI: “Listează toate comenzile de ieri”
   • Acțiune 2: Analizează datele pentru perspective
   • Acțiune 3: Generează raport sumar
   • Acțiune 4: Trimite echipei logistice

   Exemplu: Automatizare Serviciu Clienți

   • Declanșator: Întrebare client cu număr comandă
   • Acțiune 1: Extrage numărul comenzii din mesaj
   • Acțiune 2: Componenta MCP: “Urmărește pachetul cu referința [order_number]”
   • Acțiune 3: Formatează informațiile de urmărire
   • Acțiune 4: Trimite răspuns clientului cu status și URL urmărire

Evaluarea Serverului MCP

Prezentare Generală

Părerea noastră

Chameleoon MCP Server oferă o integrare robustă, gata de producție pentru automatizarea gestionării expedierii. Se remarcă prin acoperirea cuprinzătoare a instrumentelor pe întregul ciclu de viață al expedierii - de la selecția curierului și crearea comenzii până la urmărire, generarea etichetelor și programarea ridicărilor.

Puncte Forte:

• Acoperire Completă: 14 instrumente bine proiectate care acoperă toate operațiunile de expediere
• Suport Multi-Curier: Funcționează cu DPD, GLS, Packeta și alți transportatori europeni
• Caracteristici Practice: URL-uri de urmărire universale, formate multiple de etichete, operațiuni în lot
• Focusat pe Afaceri: Cazuri de utilizare clare pentru comerț electronic, logistică și întreprinderi mici
• Conștient de Securitate: Configurare variabile de mediu, fără credențiale codificate

Cel Mai Bun Pentru:

• Afaceri de comerț electronic care automatizează îndeplinirea comenzilor
• Echipe logistice care gestionează operațiuni multi-curier
• Întreprinderi mici care caută automatizare expediere fără API-uri complexe
• Dezvoltatori care construiesc fluxuri de expediere în FlowHunt sau platforme similare
• Echipe de serviciu clienți care necesită acces rapid la informații de urmărire

Limitări:

• Focus regional (în principal curieri europeni)
• Necesită cont Chameleoon și acces API
• Nicio resursă expusă (tot accesul este bazat pe instrumente)

Serverul transformă interacțiunile complexe cu API-ul de expediere în comenzi simple în limbaj natural, făcând automatizarea logistică avansată accesibilă utilizatorilor non-tehnici, oferind în același timp utilizatorilor avansați control programatic cuprinzător.

Scor MCP

Notă: Numărul de fork-uri și stele nu sunt disponibile deoarece aceasta este o implementare internă/proprietară a serverului MCP.