Knowledgebase

Cum conectez un asistent AI la BOCP

Introducere

 

Modulul Conectori AI are trei zone. Agenți chat se ocupă de platformele externe de chat care caută starea comenzilor pentru clienții tăi, iar Servicii AI păstrează cheile de acces folosite de ERP pentru prelucrări interne. Articolul de față este despre a treia zonă, Agenți AI: conectarea propriului tău asistent AI, ca să poți întreba în limbaj obișnuit „cum au evoluat vânzările în ultimele trei luni?" sau „ce probleme au avut piloții azi?" și să primești răspunsul din datele firmei tale.

Configurarea are două jumătăți: în BOCP creezi conectorul și bifezi ce are voie să citească, iar în aplicația AI adaugi adresa de conectare. Ordinea contează — întâi BOCP, apoi aplicația AI.

Notă: ai nevoie de drepturi de administrator al contului. Aprobarea unei conectări nu poate fi dată de un utilizator obișnuit.

Ce găsești în acest articol

  • Ce îți trebuie înainte de a începe
  • Pașii în BOCP: activare, creare conector, acordare permisiuni
  • Cele trei feluri de date pe care le poți acorda: indicatori zilnici, valori la zi și rapoartele piloților
  • Conectarea în Claude (aplicația web)
  • Conectarea în Claude Code
  • Conectarea în ChatGPT
  • Ecranul de aprobare și opțiunea „Păstrează permisiunile actuale"
  • Metoda alternativă, cu date de acces fixe
  • Ce se întâmplă când apar cifre noi și când trebuie refăcută conectarea
  • Cum verifici că funcționează și ce faci când nu merge

Înainte de a începe

  • Submodulul Agenți AI trebuie să fie activ pe contul tău. Dacă nu este, în locul listei vei vedea un ecran de prezentare cu opțiunea de activare.
  • Un cont AI de business. Recomandarea fermă este să folosești un cont de firmă (business, team, enterprise) sau un cont de tip API, nu un abonament personal de chat. Diferența nu este de preț, ci juridică — vezi articolul despre GDPR din secțiunea Vezi și.
  • Drepturi de administrator în BOCP.

Pasul 1 — activează funcționalitatea la nivel de cont

Se intră în Conectori AI → Agenți AI. În partea de sus a paginii se bifează Activează conectarea AI prin OAuth/MCP.

Această bifă pornește adresa de conectare a contului. Cât timp este oprită, adresa nu răspunde deloc, indiferent câți conectori ai creat.

După bifare apare, tot acolo, URL-ul de conectare al contului tău. Are forma https://adresa-ta-bocp/app/rest/mcp/12345/, unde numărul este identificatorul contului. Copiază-l — este singura informație de care ai nevoie în aplicația AI.

[Ecran: partea de sus a paginii Agenți AI, cu bifa de activare și URL-ul de conectare]

Pasul 2 — creează conectorul

Se apasă Adaugă și se completează o denumire. Alege ceva care spune la ce folosește, de exemplu Claude - analize vânzări: o vei recunoaște mai târziu în listă și în jurnalul de accesări.

După salvare se deschide fereastra de configurare, cu trei file: Configurare, Acces API și Jurnal accesări.

Notă: pasul este opțional. Dacă te conectezi direct din aplicația AI (Pasul 4), ecranul de aprobare îți oferă să creeze el conectorul.

Pasul 3 — acordă permisiuni

Un conector nou nu are acces la nimic. Aceasta este starea implicită și este intenționată: până nu bifezi ceva, asistentul nu poate citi absolut nicio dată.

În fila Configurare ai lista completă a elementelor pe care le poți acorda, fiecare cu bifa lui. Butonul cu declarația AI deschide lista a ceea ce va putea citi conectorul — se completează automat pe măsură ce bifezi. Este cel mai bun mod de a verifica ce dai: dacă declarația nu spune ce te aștepți, ai bifat altceva.

[Ecran: fila Configurare, cu lista de permisiuni și butonul declarației]

Recomandare: începe cu două-trei elemente, pentru o întrebare concretă. Poți oricând adăuga altele. Un conector cu trei bife este mai ușor de explicat și de justificat decât unul cu treizeci.

Verifică și că bifa Activ este pusă. Un conector inactiv nu răspunde, chiar dacă are permisiuni.

Cele trei feluri de date

Lista de permisiuni este împărțită în trei familii, pentru că răspund la întrebări diferite:

  • Indicatori zilnici — cât s-a întâmplat într-o zi. Se pot aduna pe o perioadă: valoarea facturată, încasările, comenzile primite, marja brută, costul mărfii vândute, valoarea intrărilor și a ieșirilor din stoc, comenzile anulate, valoarea retururilor către furnizori. Întrebarea tipică: „cât am vândut luna trecută?"
  • Valori la zi — cât este acum, la un moment dat. Nu se adună: valoarea stocului (la preț de achiziție sau de vânzare), marja potențială din stocul existent, soldul de încasat de la clienți, numărul total de clienți, numărul total de produse și câte dintre ele au stoc. Întrebarea tipică: „cât stoc am pe raft chiar acum?"
  • Rapoartele piloților — ce au făcut automatizările ERP-ului (Pilot Comenzi, Pilot Facturare, Pilot AWB și ceilalți): câte acțiuni au făcut, ce probleme au întâmpinat, ce a rămas deschis și ce așteaptă în cozile de lucru. Se acordă separat pe fiecare pilot; configurarea pilotului (ce automatizări are pornite) este o bifă separată. Întrebarea tipică: „ce probleme au avut piloții azi?"

Diferența contează la interpretare. Zece zile de vânzări se pot aduna într-un total pe perioadă; zece zile de valoare a stocului nu — ar da un număr fără sens. Pentru valorile la zi, asistentul primește valoarea curentă și, unde se poate reconstitui corect, comparații cu acum 7, 30, 90 de zile și cu anul trecut.

Notă: pentru unele valori la zi istoricul nu poate fi reconstituit exact — de exemplu soldul de încasat, pentru că anularea unei facturi vechi îl schimbă fără să lase o mișcare pe o anumită zi. În aceste cazuri asistentul primește valoarea de acum, fără comparații, și este informat de ce.

Notă: la o problemă deschisă a unui pilot, asistentul primește tipul documentului, numărul lui intern și un link care se deschide doar după autentificarea în BOCP. Nu primește textul problemei, clientul sau cine a rezolvat-o.

Pasul 4 — conectează asistentul AI

Aici nu mai lucrezi în BOCP. Pașii diferă de la o aplicație la alta, iar meniurile furnizorilor se schimbă des — dacă denumirile nu corespund exact, caută secțiunea de conectori sau integrări din setări.

În Claude (aplicația web, claude.ai)

Atenție: BOCP apare în catalogul public de conectori al Claude, dar conectarea nu se face din catalog. Intrarea din catalog este doar prezentarea aplicației — nu știe la ce cont de BOCP vrei să te legi. Conectarea se face întotdeauna cu URL-ul propriului tău cont, ca conector personalizat, exact ca mai jos.

  1. Deschide Settings (Setări) din contul tău Claude.
  2. Intră în secțiunea Connectors (Conectori).
  3. Alege adăugarea unui connector personalizat (Add custom connector).
  4. Lipește URL-ul de conectare copiat la Pasul 1 și confirmă.
  5. Se va deschide o fereastră către BOCP, cu un ecran de aprobare. Ești deja autentificat, deci vezi direct ce ți se cere. Alege conectorul creat la Pasul 2 (sau un conector nou), stabilește accesul — vezi mai jos — și aprobă.
  6. Gata. Nu se copiază nicio parolă nicăieri.

[Ecran: ecranul de aprobare afișat de BOCP la conectarea unei aplicații AI]

În Claude Code

În terminal, în directorul tău de lucru, rulează comanda de adăugare a unui conector, dându-i un nume scurt și URL-ul copiat la Pasul 1:

claude mcp add --transport http bocp https://adresa-ta-bocp/app/rest/mcp/12345/

Apoi, în Claude Code, comanda /mcp îți arată conectorii adăugați și îți permite să pornești autentificarea. Se va deschide același ecran de aprobare din BOCP.

În ChatGPT

Notă: listarea BOCP în catalogul public de aplicații al ChatGPT este în curs de aprobare. Până când este publicată, conectarea se face manual, prin modul dezvoltator. Pașii de mai jos nu depind de listare și vor rămâne valabili și după publicarea ei.

  1. Deschide Settings (Setări) din contul tău ChatGPT.
  2. Intră în secțiunea Apps & Connectors (denumită, în funcție de versiunea interfeței, Apps, Connectors sau Plugins).
  3. Deschide Advanced settings (Setări avansate) și activează Developer mode (Mod dezvoltator). Fără această bifă, opțiunea de adăugare manuală nu apare deloc.
  4. Întoarce-te în lista de aplicații și alege adăugarea unei aplicații manuale (Create / Add custom connector).
  5. Lipește URL-ul de conectare copiat la Pasul 1 și confirmă.
  6. Aprobă conectarea în ecranul afișat de BOCP.

Notă: atât modul dezvoltator, cât și conectorii personalizați în general, depind de tipul de abonament ChatGPT. Dacă opțiunea nu apare în setările tale, contul respectiv nu o permite — verifică la furnizor ce plan este necesar, sau folosește metoda cu date de acces fixe descrisă mai jos.

Ecranul de aprobare

Pentru fiecare familie de date, ecranul de aprobare are o listă. Prima opțiune, selectată implicit, este Păstrează permisiunile actuale ale conectorului:

  • la un conector existent, nu schimbă nimic — reconectarea nu îi ia și nu îi adaugă acces;
  • la un conector nou, înseamnă „fără acces" — asistentul nu va vedea nimic până nu bifezi ceva.

Opțiunea Doar agregate acordă dintr-o dată toate elementele familiei; textul ei arată câte sunt și câte dintre ele sunt financiare. Pentru piloți poți alege Rapoartele tuturor piloților (recomandat), Rapoartele și configurarea tuturor piloților sau o Selecție personalizată, care deschide bifele pe fiecare pilot.

Notă: orice alegere făcută aici se poate rafina ulterior, element cu element, în fila Configurare a conectorului.

Pasul 5 — verifică

Pune asistentului o întrebare simplă, de exemplu: „ce date de business poți citi din BOCP?". Ar trebui să îți enumere exact elementele bifate la Pasul 3 — nici mai multe, nici mai puține.

Apoi întreabă ceva concret din fiecare familie, de exemplu:

  • „Ce trebuie să știu azi despre firmă?" — asistentul primește într-o singură cerere vânzările, comenzile, încasările, plățile, soldul restant și valoarea stocului;
  • „Cum au evoluat încasările și plățile luna aceasta față de luna trecută, pe săptămâni?";
  • „Cât valorează stocul acum față de acum 90 de zile?";
  • „Ce probleme deschise au piloții și de când?".

În BOCP, deschide conectorul și fila Jurnal accesări. Vei vedea fiecare cerere, cu dată, tip, rezultat și adresa de la care a venit — inclusiv cererile respinse. Este locul unde verifici oricând ce a citit efectiv asistentul.

Metoda alternativă: date de acces fixe

Dacă aplicația pe care o folosești nu suportă conectarea prin aprobare, sau dacă vrei să legi un script propriu, fila Acces API a conectorului conține o adresă și o pereche utilizator/parolă generate special pentru el.

Aceste date permit exact aceleași citiri ca și conectarea prin aprobare — nici mai mult. Permisiunile sunt aceleași, bifate în fila Configurare.

Atenție: nu comunica nimănui aceste date și nu le lipi într-o conversație cu un asistent AI. Dacă suspectezi că au ajuns la altcineva, dezactivează conectorul și creează unul nou.

Când apar cifre noi în BOCP

Lista de date disponibile crește în timp. Ce trebuie să faci depinde de ce anume s-a adăugat, iar diferența este importantă:

  • Un indicator sau o valoare la zi în plus — nu trebuie să reconectezi nimic. Elementul nou apare în lista de permisiuni a conectorului. Îl bifezi, salvezi, iar asistentul deja conectat îl vede de la următoarea întrebare. Fiecare răspuns conține și o amprentă a listei de permisiuni, care se schimbă la orice modificare — așa își dă seama asistentul singur că are ceva nou de citit.
  • O funcție nouă a conectorului — este nevoie de reconectare. Aplicațiile AI își citesc lista de unelte o singură dată, la conectare. Când BOCP adaugă o funcție nouă (așa cum s-au adăugat în octombrie 2026 datele de business pe orice perioadă și rapoartele piloților), conexiunile existente continuă să funcționeze, dar cu vechea listă de unelte.

Cum afli că trebuie să reconectezi: în lista Agenți AI și în fereastra conectorului apare un mesaj care spune că acesta folosește setul vechi de funcții. Asistentul primește același aviz în răspunsurile lui și ți-l poate spune în conversație. Mesajul dispare singur după reconectare.

Cum reconectezi: în aplicația AI se șterge conectorul și se adaugă din nou, cu același URL. Pe ecranul de aprobare, opțiunea implicită Păstrează permisiunile actuale lasă neatins tot ce ai bifat deja; alege doar ce vrei în plus, de exemplu Rapoartele tuturor piloților. În Claude Code, aceeași operațiune înseamnă ștergerea și readăugarea conectorului, urmată de /mcp pentru reautentificare.

Probleme frecvente și soluții

  • Aplicația AI spune că nu poate contacta serverul, sau afișează o eroare despre un răspuns care nu este JSON — cel mai frecvent, funcționalitatea nu este activată la nivel de cont (Pasul 1) sau URL-ul a fost copiat incomplet. Dacă ambele sunt în regulă și eroarea persistă în Claude Code, este posibil să fie nevoie de o setare pe serverul care găzduiește BOCP-ul tău; contactează suportul și menționează că este vorba despre descoperirea conectorului MCP.
  • Conectorul se adaugă, dar asistentul spune că nu are acces la date — nu ai bifat nicio permisiune, sau conectorul nu este marcat ca Activ. Vezi Pasul 3. La un conector nou, opțiunea implicită de pe ecranul de aprobare înseamnă „fără acces".
  • Asistentul vede mai puțini indicatori decât te așteptai — vede exact ce ai bifat. Deschide fila Configurare și compară cu declarația.
  • Asistentul nu poate citi rapoartele piloților sau nu cunoaște datele de business pe perioadă, deși în BOCP apare mesajul de reconectare — conexiunea a fost făcută înainte ca aceste funcții să existe. Șterge conectorul din aplicația AI și adaugă-l din nou, cu același URL. Vezi secțiunea Când apar cifre noi în BOCP.
  • Asistentul spune că un pilot nu este acordat — raportul acelui pilot nu este bifat în fila Configurare, sau pilotul nu este activ pe cont (Pilot Transferuri și Pilot Taskuri sunt plătiți). Piloții care nu sunt activi nu apar deloc în lista de permisiuni.
  • Nu găsești BOCP în catalogul de aplicații al ChatGPT — listarea este încă în aprobare. Conectarea se face acum manual, cu modul dezvoltator activat; vezi Pasul 4.
  • Ai adăugat BOCP din catalogul Claude și nu vezi datele firmei — din catalog nu se poate face conectarea, pentru că acolo nu se indică la ce cont te legi. Adaugă-l ca conector personalizat, cu URL-ul de la Pasul 1.
  • Totul funcționa și s-a oprit brusc — verifică dacă abonamentul care include submodulul este în continuare activ. La expirare, accesul se taie complet, inclusiv pentru asistenții deja conectați.
  • Cereri respinse când pui multe întrebări la rând — există o limită de 60 de cereri pe minut per conector. Se reia după un minut.
  • Lipsesc zile din răspuns sau totalurile par mici la prima întrebare — valorile zilnice se calculează progresiv, iar perioadele mai vechi, neconsultate până acum, se completează la prima cerere. Reia întrebarea după câteva minute. Răspunsul conține și numărul de zile pentru care există deja date calculate.
  • Nu recunoști un conector din listă — dezactivează-l imediat și verifică jurnalul lui de accesări.

De știut

Notă: dezactivarea conectorului taie accesul instantaneu, inclusiv pentru aplicațiile AI care fuseseră deja aprobate. Este cel mai rapid mod de a opri totul.

Notă: un asistent AI conectat prin acest modul nu poate scrie nimic în ERP. Nu poate emite, modifica, anula sau șterge documente și nu poate schimba setări — nici setarea piloților, chiar dacă are acces să o citească.

Atenție: cifrele primite prin asistent sunt bune pentru analiză și pentru observarea tendințelor, dar nu țin loc de rapoartele oficiale. Pentru orice valoare care ajunge într-un document, o declarație sau o decizie, verific-o în modulele de raportare ale ERP-ului.

Vezi și

Was this article helpful?

★ ★ ★ ★ ★