Knowledgebase

Cum conectez un asistent AI (Claude sau ChatGPT) 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?" ș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
  • Conectarea în Claude (aplicația web)
  • Conectarea în Claude Code
  • Conectarea în ChatGPT
  • Metoda alternativă, cu date de acces fixe
  • 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.

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, în coloana din stânga, ai lista completă a indicatorilor de business, fiecare cu bifa lui. În dreapta, declarația AI se completează automat pe măsură ce bifezi — enumeră exact ce va putea citi conectorul. 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 în stânga și declarația generată în dreapta]

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.

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)

  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 ș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

  1. Deschide Settings (Setări) din contul tău.
  2. Caută secțiunea Connectors sau Apps, în funcție de versiunea interfeței.
  3. Alege adăugarea unui conector personalizat și lipește URL-ul de la Pasul 1.
  4. Aprobă conectarea în ecranul afișat de BOCP.

Notă: posibilitatea de a adăuga conectori personalizați depinde de tipul de abonament ChatGPT pe care îl ai. 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.

Pasul 5 — verifică

Pune asistentului o întrebare simplă, de exemplu: „ce indicatori 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, de exemplu „cum au evoluat facturile emise luna aceasta față de luna trecută?".

Î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.

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.
  • Asistentul vede mai puțini indicatori decât te așteptai — vede exact ce ai bifat. Deschide fila Configurare și compară cu declarația din dreapta.
  • 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.

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?

★ ★ ★ ★ ★