> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eeu-ecom.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Asistenți AI (MCP)

Poți conecta **Claude**, **ChatGPT** sau **Codex** la CRM și poți lucra în limbaj natural: verifici comenzi, adaugi note, modifici produsele unei comenzi, creezi review-uri sau landing page-uri, ceri rapoarte zilnice de performanță. Asistentul lucrează cu contul tău și are exact drepturile utilizatorului tău.

Conectarea se face prin **MCP** (Model Context Protocol), standardul prin care asistenții AI folosesc aplicații externe.

> [!WARNING]
>
> Asistenții AI sunt disponibili doar pentru abonamentul **Gold Plus** și pentru utilizatorii care au permisiunea `mcp.use`.

## CRM sau CMS

EEU-ECOM are două aplicații și fiecare are propriul server MCP:

* **CRM (acest server)**: comenzi, parțiale, clienți, produse și stoc, Helpship, cheltuieli de reclamă și rapoarte, utilizatori și setări, plus partea comercială a unui landing page: prețuri, formular de comandă, review-urile din widget, upsell-uri, pixeli de tracking, magazin și slug.
* **CMS**: pagina de produs așa cum o văd vizitatorii (texte, secțiuni, imagini, design, publicare). Vezi [Asistenți AI (MCP) în CMS](https://docs.eeu-ecom.app/cms/asistenti-ai.md).

Pagina de produs din CMS afișează formularul de comandă și widgetul de review-uri ale landing page-ului din CRM cu **același slug**, din magazinul CRM legat de magazinul CMS. Dacă schimbi slug-ul unui landing page în CRM, schimbă-l și în CMS, altfel pagina nu mai afișează formularul.

> [!TIP]
>
> Conectează ambele servere și dă-le numele recomandate (ex: `EEU-ECOM RJE CRM` și `EEU-ECOM RJE CMS`). Așa tu și asistentul le deosebiți ușor, iar asistentul alege singur aplicația potrivită pentru fiecare cerere.

## Conectare

Informațiile de conectare se află în [Setări](https://docs.eeu-ecom.app/crm/settings.md), secțiunea **Asistenți AI (MCP)**:

* **Adresa serverului MCP** (ex: `https://rje.eeu-ecom.app/mcp`), cu buton de copiere
* **Numele recomandat al conectorului** (ex: `EEU-ECOM RJE CRM`)
* pașii pentru Claude, ChatGPT și Codex și un link către instrucțiunile complete

### Claude (claude.ai / Claude Desktop)

1. Deschide **Settings → Connectors** și alege **Add custom connector**
2. Numește conectorul ca în **Setări** (ex: `EEU-ECOM RJE CRM`) și lipește adresa serverului
3. Click pe **Connect**: ești trimis în CRM. Autentifică-te și aprobă accesul.

### ChatGPT

1. În **Settings → Apps & Connectors**, activează **Developer mode** (setări avansate)
2. Creează un conector nou cu numele recomandat, adresa serverului și autentificare **OAuth**
3. Autentifică-te în CRM și aprobă accesul

### Codex

Rulează comenzile afișate în **Setări**, de forma:

```bash theme={null}
codex mcp add eeu-rje-crm --url https://rje.eeu-ecom.app/mcp
codex mcp login eeu-rje-crm
```

> [!NOTE]
>
> Accesul este valabil o zi și se reînnoiește automat până la 30 de zile de folosire. Parola ta nu este niciodată transmisă asistentului.

## Permisiuni

Permisiunile se gestionează din [Roluri](https://docs.eeu-ecom.app/crm/roles.md):

| Permisiune | Ce permite |
| - | - |
| `mcp.use` | Conectarea unui asistent și acțiunile de citire (listare, căutare, vizualizare) |
| `mcp.write` | Acțiunile care modifică date. Fără ea, asistentul nici nu vede aceste acțiuni |
| `mcp.audit` | Vizualizarea activității AI și a aplicațiilor conectate ale **tuturor** utilizatorilor, nu doar ale tale |

`mcp.use` și `mcp.write` sunt acordate implicit rolurilor **Master Admin** și **Store Owner**. Pe lângă acestea, fiecare acțiune verifică aceleași permisiuni ca în aplicație (ex: anularea unei comenzi, crearea unui review) și funcțiile incluse în abonament.

> [!TIP]
>
> Pentru a tăia imediat accesul unui utilizator, scoate permisiunea `mcp.use` din rolul lui sau apasă **Deconectează** în lista de aplicații conectate.

## Ce poate face asistentul

### Citire și analiză

* caută și afișează comenzi, parțiale, clienți, landing page-uri, review-uri, upsell-uri, produse, magazine. Căutarea este aceeași ca în aplicație, inclusiv căutarea comenzilor după IP.
* afișează un landing page complet într-un singur pas: prețurile, setările formularului de comandă, review-urile și upsell-urile (cu SKU-ul vândut și imaginile)
* calculează statistici direct pe server: comenzi pe landing page și zi, cele mai vândute upsell-uri, rata de retur pe landing page, clienți cu multe comenzi sau retururi
* rapoartele din aplicație, cu aceleași cifre: [Landing Page Offers](https://docs.eeu-ecom.app/crm/landing-page-offers.md) (recomandat pentru rapoarte zilnice sau săptămânale), [Sales & ROAS](https://docs.eeu-ecom.app/crm/sales-and-roas.md), [Cost & Profit](https://docs.eeu-ecom.app/crm/cost-and-profit.md), [Hartă rată retururi](https://docs.eeu-ecom.app/crm/return-rate-map.md)
* **exporturi**: pentru volume mari, asistentul generează un fișier CSV sau JSONL și îți dă un link de descărcare valabil o oră, în loc să afișeze datele în conversație

### Comenzi

* adaugă note interne
* blochează, retrimite sau sincronizează cu Helpship (ca butoanele din aplicație)
* schimbă statusul (doar în aplicație, nu și în Helpship) sau anulează comanda (și în Helpship)
* modifică produsele unei comenzi: adaugă, schimbă sau șterge linii. Totalul se recalculează și Helpship este actualizat. Nu se aplică la comenzile plătite, returnate, neplătite sau anulate. O comandă confirmată trebuie mai întâi pusă pe hold în Helpship.
* corectează un SKU greșit pe mai multe comenzi deodată (ex: un landing page configurat cu varianta greșită): mai întâi o previzualizare, apoi aplicarea, cu confirmarea ta
* transformă un [parțial](https://docs.eeu-ecom.app/crm/partials.md) în comandă

### Landing page-uri, review-uri și upsell-uri

* creează landing page-uri și modifică prețurile, setările și [formularul de comandă](https://docs.eeu-ecom.app/crm/landing-pages.md) (SKU, variante, etichete, câmpuri, textul butonului)
* **duplică un landing page**, de exemplu pentru o variantă de ofertă (1+1, alte prețuri): copiază formularul, tracking-ul, review-urile și upsell-urile active, iar tu spui doar ce diferă (vezi mai jos)
* creează, modifică sau șterge review-uri (cu avatar și poze) și upsell-uri pre / post-purchase (cu imagine, GIF sau MP4)
* copiază review-urile și upsell-urile de pe un landing page pe altul: toate deodată sau doar pe cele alese, cu imagini cu tot

#### Variante de ofertă

Pentru a testa o ofertă nouă pentru un produs existent (ex: „1+1 gratis” la pantalonii modelatori), cere asistentului să duplice landing page-ul:

1. În CRM, asistentul creează landing page-ul nou cu slug-ul ales. Copiază formularul de comandă, tracking-ul (pixeli, CAPI, TikTok), review-urile și upsell-urile active, cu imaginile lor, și modifică doar ce îi spui: prețurile, SRP-ul, multiplicatorul de cantitate sau etichetele din formular.
2. În CMS (dacă ai conectat și [asistentul CMS](https://docs.eeu-ecom.app/cms/asistenti-ai.md)), duplică pagina de produs cu **același slug**, ca formularul să apară pe pagină.

Comenzile, parțialele și cheltuielile de reclamă nu se copiază, așa că testul pornește de la zero. Dacă un pas nu reușește (de exemplu slug-ul e deja folosit), nu se creează nimic.

### Alte resurse

* produse, variante și bundle-uri; [reguli de atașare](https://docs.eeu-ecom.app/crm/attachment-rules.md)
* [conturi de reclamă](https://docs.eeu-ecom.app/crm/ad-accounts.md): le creează și le modifică (nume, platformă, monedă, ID-ul contului Meta). Nu le poate șterge.
* cheltuieli de reclamă: înregistrează o zi, șterge o perioadă, importă un raport CSV și citește cheltuielile deja înregistrate pe cont, Landing Page și zi
* [webhooks](https://docs.eeu-ecom.app/crm/webhooks.md), întotdeauna cu confirmare explicită
* [setările](https://docs.eeu-ecom.app/crm/settings.md) instanței (valorile secrete nu sunt afișate și nu pot fi modificate)
* utilizatori și roluri (doar Master Admin). Utilizatorii noi primesc o parolă temporară pe care trebuie să o schimbe la prima autentificare.

**Nu sunt disponibile prin asistent:** confirmarea comenzii cu editarea adresei, unirea comenzilor, apelurile primite, ștergerea conturilor de reclamă, editarea sau ștergerea utilizatorilor și rolurilor.

#### Importul cheltuielilor de reclamă

1. **Probă, fără scriere.** Asistentul rulează întâi importul în mod de probă și îți arată sumele pe fiecare Landing Page și zi, plus campaniile ignorate și motivul (fără tag, Landing Page inexistent, tag-ul altei instanțe, dată sau sumă invalidă). Importă doar după ce confirmi.
2. **Contul potrivit.** Raportul se potrivește după ID-ul contului Meta, salvat pe contul de reclamă din CRM. Dacă niciun cont nu are încă acel ID, asistentul îți propune contul care a mai avut cheltuieli pe Landing Page-urile din raport. După confirmarea ta, salvează ID-ul pe cont pentru data viitoare.
3. **Avertizare la contul greșit.** Dacă importi pe un cont pe care Landing Page-urile din raport nu au avut niciodată cheltuieli, asistentul te avertizează înainte.

Regulile importului (ce se înlocuiește, tag-urile cu prefix de instanță) sunt aceleași ca în admin. Vezi [Conturi publicitare](https://docs.eeu-ecom.app/crm/ad-accounts.md).

### Imagini și video

* **Imagine deja folosită** de un review sau un upsell: asistentul o refolosește direct, fără să o încarce din nou. Fișierul se copiază pe server.
* **Fișier deja online**: dă-i asistentului linkul.
* **Fișier de pe calculatorul tău**: asistentul îți dă un link privat de upload, valabil 30 de minute, de folosit cu `curl -X PUT --data-binary @poza.jpg "<link>"`.
* Sunt acceptate **JPG, PNG, WEBP, GIF** (review-uri și upsell-uri) și **MP4** (doar upsell-uri), cel mult **3 MB**, ca în aplicație. Tipul fișierului se verifică după conținut.

## Siguranță

* Înainte de orice modificare, asistentul îți spune ce va schimba și îți cere confirmarea.
* Acțiunile ireversibile (anulare, ștergere, schimbare de status, blacklist...) cer o **confirmare explicită**.
* Textele scrise de clienți sau de terți (note, adrese, review-uri) sunt tratate ca **date**, niciodată ca instrucțiuni.
* Valorile secrete (token-uri, parole, chei) nu sunt transmise asistentului.
* Limite per utilizator: 120 de cereri pe minut, dintre care cel mult **30 de modificări**. Exporturile și calculele grele au limite separate.

## Aplicații conectate și activitate AI

În [Setări](https://docs.eeu-ecom.app/crm/settings.md), secțiunea **Asistenți AI (MCP)**:

* **Aplicațiile conectate** arată fiecare asistent autorizat, când a fost conectat și când a fost folosit ultima dată. Butonul **Deconectează** retrage accesul imediat.
* **Activitate AI** arată acțiunile făcute prin asistenți în ultimele **30 de zile**, cu filtre după utilizator, acțiune, perioadă sau doar erori. Click pe un rând pentru detalii.

Fără permisiunea `mcp.audit`, vezi doar propriile aplicații și propria activitate.

## Exemple de cereri

* „Arată-mi comenzile în așteptare de azi.”
* „Adaugă nota «Confirmat pe WhatsApp» la comanda 45213.”
* „Fă-mi raportul zilnic pe Landing Page Offers și spune-mi ce landing page-uri au ROAS scăzut.”
* „Câte comenzi au venit de pe același IP ca și comanda 45213 în ultimele zile?”
* „Adaugă un review cu poza asta la landing page-ul lampa-solara.”
* „Comenzile de ieri de pe landing page-ul X au SKU-ul greșit, înlocuiește-l cu Y.”
* „Exportă comenzile returnate din septembrie, cu județul și landing page-ul.”
* „Fă o variantă a landing page-ului 219 cu oferta 1+1: prețuri 99 / 139 / 169, slug pantaloni-modelatori-oferta-2x.”
* „Copiază review-urile de pe landing page-ul 219 pe 340.”
* „Importă raportul ăsta de cheltuieli din Meta, dar arată-mi întâi ce ar importa.”


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.