conecteaza-symbai

name	conecteaza-symbai
description	Configurează sau repară conexiunea MCP Symbai (Claude Code / Codex) prin Symbai Connect + OAuth nominal și explică DE CE lipsesc tool-uri. La „nu apar tool-urile Symbai", „văd puține tool-uri / lipsesc furnizorii, meniurile", „acces refuzat", „401", „am schimbat calculatorul".

Conectează sau repară Symbai

Scop: serverul symbai să apară conectat și să funcționeze direct, fără configurare tehnică făcută de utilizator.

Regula de aur: citește starea, nu o deduce

Pentru Accounting, inclusiv firme care nu au POS, urmează fluxul Accounting din același Connect. Pachetul se descarcă din Accounting → Setări → Integrări → Symbai Connect; autentificarea firmei se face cu contul Accounting. Pașii POS de mai jos se aplică numai conexiunilor POS. La utilizarea ambelor produse, păstrează toate conexiunile și verifică separat identitatea fiecăreia.

Simptomul („nu merge", „nu văd tool-urile", „scrie blocat") nu spune cauza. Cauza o spune serverul Symbai, iar tu o ai la un apel distanță. Nu porni niciodată de la o listă de cauze posibile și nu alege una ca să ai ce răspunde — un motiv plauzibil spus pe un ton sigur trimite omul să repare altceva decât ce e stricat, iar el pierde o zi.

1. Apelează connection_status (serverul MCP local al Symbai Connect). Merge chiar și când toate celelalte tool-uri refuză — exact pentru asta există.
2. Citește blocul conectare:
   • stare — verdictul: ok, neactivat, oprit_de_symbai, fara_legatura, blocat_local, offline, fara_date_pos.
   • explicatie — cauza exactă, trimisă de serverul Symbai, cu pasul de reparare în ea.
   • caDeFacut — pașii care decurg din starea reală a acestui calculator.
3. Spune omului ce scrie în explicatie, cu cuvintele lui. Dacă explicatie e goală sau neclară, spune că motivul nu e cunoscut și treci la Pachetul personalizat. Nu completa golul cu o ipoteză.

Repară singur, nu doar explica

connect_repair (același server local) face ce ar fi făcut omul în panou:

• cere Symbai o reverificare imediată a accesului — folosește-l îndată ce proprietarul tocmai a reacordat accesul, altfel starea rămâne „oprit" până la următoarea verificare automată;
• dacă licența e bună și mai lipsește doar autentificarea, o pornește el: se deschide browserul, iar omul doar se loghează și apasă „Permite accesul";
• întoarce ce s-a rezolvat și ce a mai rămas de făcut.

Cu doar_verifica: true reverifică și raportează, fără să deschidă browserul. Pe un calculator cu doi asistenți instalați, unealta întreabă pe care să-l repare — răspunde cu asistent: "claude-code" sau asistent: "codex", cel în care lucrezi ACUM. Autentificarea pornește și se întoarce imediat; rezultatul apare la următorul connection_status, în conectare.autentificare.

Ordinea normală când cineva zice „nu-mi merge": connection_status → dacă lipsește un acces, cere-l proprietarului → după ce l-a dat, connect_repair.

Dacă uneltele astea nu există

Agentul de pe calculator și pachetul ăsta de skill-uri se actualizează separat, deci poți primi skill-ul înaintea agentului. Recunoști situația așa: connect_repair nu apare în lista de unelte, sau connection_status răspunde fără blocul conectare.

Atunci nu improviza o cauză. Spune-i omului că verificarea automată nu e disponibilă pe versiunea de agent instalată la el, arată-i textul brut din licenta.explicatie dacă există, și trimite-l în panoul local http://127.0.0.1:5196, unde găsește aceleași informații și butonul Conectează.

Fluxul unic pentru angajat

1. Proprietarul intră în Hub → Acces AI, alege angajatul și locația POS exacte, selectează permisiunile și acordă accesul.
2. Angajatul intră în POS cu propriul cont și deschide Conectează un asistent AI. Dialogul îi arată starea calculatorului lui: legat, oprit (cu motiv) sau cu un pachet descărcat și neinstalat.
3. Descarcă ultimul Pachet personalizat Symbai Connect pentru sistemul său și îl instalează pe calculatorul pe care va lucra.
4. În panoul Symbai Connect apasă Conectează lângă Codex sau Claude Code — sau lasă asistentul să cheme connect_repair.
5. Browserul se deschide automat. Angajatul se autentifică cu emailul și parola contului POS, nu cu PIN-ul de la casă, apoi aprobă accesul.
6. Symbai Connect configurează aplicația și mută în siguranță rezultatul în profilul angajatului. După confirmarea succesului, angajatul deschide o sesiune nouă în Codex sau Claude Code.

Nu cere niciodată utilizatorului să editeze fișiere, să ruleze comenzi MCP sau să copieze un mesaj, URL, cod, header ori token. Nu trimite tokenul proprietarului unui angajat.

Un acces acordat leagă un singur calculator. O instalare nouă îl înlocuiește pe cel vechi, iar o descărcare nouă anulează activarea din pachetul descărcat anterior: dacă omul are deja un pachet nefolosit, spune-i să-l instaleze pe acela, nu să descarce încă unul.

Verificare

1. Confirmă că pluginul symbai-core este instalat și activ.
2. Deschide o sesiune nouă după conectare.
3. Apelează list_brands; un răspuns valid confirmă conexiunea.
4. Dacă un tool spune „permisiune insuficientă", conexiunea funcționează: proprietarul verifică modulul acordat, iar rolul și alocările POS live pot limita suplimentar accesul.
5. Apelează verifica_conexiune: îți spune tokenul, modulele, SQL, profilul, plafoanele, câte tool-uri vezi și — pentru un cont de angajat — arieAngajat. Citește-l ÎNAINTE să tragi orice concluzie despre tool-uri lipsă.

Văd puține tool-uri / lipsesc module întregi (furnizori, meniuri, P&L…)

NU e o limită a sesiunii și NU înseamnă „Symbai nu poate". Catalogul are peste 1600 de tool-uri; un cont cu rol complet și arie completă le vede pe toate cele din grant. Cauzele, în ordinea frecvenței — toate se citesc din verifica_conexiune:

1. Aria de angajat (arieAngajat.restransa: true) — contul e alocat doar pe o PARTE din unitățile active (branduri / locații / gestiuni permise). Atunci rămân doar tool-urile cu verificare de arie, iar tooluriCuArieCompleta arată câte ar fi altfel. Remediu, în aplicație, de un administrator cu rol complet (de regulă proprietarul): Personal → fișa angajatului → pe fiecare axă limitată bifează unitățile active lipsă sau apasă «Permite toate». Unitățile dezactivate/arhivate nu contează. Efectul apare la următoarea pornire a sesiunii (reconectare) — spune-i explicit să repornească.
2. Rolul POS — modulele se derivă generos din permisiunile rolului; un rol îngust (ospătar, bucătar) vede doar modulele domeniului lui, iar uneltele sensibile (salarii, contracte, registru de casă, jurnal, blocare perioadă, infrastructura din Setări) cer exact permisiunea paginii echivalente. Ștergerile de perioadă, GDPR-ul și forțările tehnice sunt doar pentru rolul complet. Remediu: configureaza-roluri (completează rolul), nu SQL.
3. Profilul de tool-uri al tokenului (restaurant / fabrică / construcții / hotel / marketing) — ascunde domeniile din afara verticalei; se schimbă din Hub → Acces AI (revocă și acordă din nou cu profilul dorit).
4. Modulele grantului din Hub → Acces AI — ce n-a bifat proprietarul nu apare.

Conexiuni vechi cu token invalid (ex. o intrare „symbai-vechi" cu 0 tool-uri) se elimină din lista MCP; nu explică nimic despre cea nouă.

Ce înseamnă fiecare verdict

Le folosești după ce ai citit stare și explicatie, ca să traduci — nu ca să ghicești.

• oprit_de_symbai — Symbai a răspuns și a refuzat. Motivul e în explicatie și conține deja pasul potrivit. Dacă cere un acces nou de la proprietar, acela trebuie dat întâi; un pachet nou descărcat înainte nu ajută.
• fara_legatura — calculatorul nu ajunge la Symbai, iar perioada de funcționare offline s-a încheiat. Symbai nu a refuzat nimic. Verifică internetul, firewall-ul și dacă hub.symbai.app se rezolvă de pe acel calculator. Nu reinstala și nu cere un acces nou — ai repara ceva ce nu e stricat.
• blocat_local — problema e pe calculatorul acela (de obicei cheia dispozitivului, după o schimbare de cont Windows), nu o decizie a Symbai. Ce anume, scrie în explicatie.
• neactivat — calculatorul nu e legat de niciun cont. Pachet personalizat din POS.
• offline — nu ajunge la Symbai acum, dar nu i s-a luat nimic: merge în perioada de grație. Verifică internetul. Nu reinstala nimic.
• fara_date_pos — activat, dar fără adresa datelor din POS: pachetul e mai vechi decât fluxul actual. Un Pachet personalizat nou o aduce.
• ok — accesul e valid. Dacă tot lipsesc tool-urile, e nevoie de o sesiune nouă.

Alte situații

• 401 după ce mergea: cheamă connect_repair — de cele mai multe ori doar autentificarea a expirat.
• Angajat inactiv: proprietarul reactivează contul POS, apoi acordă din nou accesul nominal.
• Calculator schimbat: instalează Pachetul personalizat pe noul calculator; îl înlocuiește automat pe cel vechi.
• Configurație manuală veche detectată: Symbai Connect indică intrarea veche symbai; elimină doar acea intrare din lista MCP, apoi reia conectarea. Nu afișa utilizatorului comenzi sau configurații.
• Doar PIN disponibil: utilizatorul își setează parola contului din Personal, apoi reia conectarea.

Accesul POS nu înlocuiește grantul proprietarului. Accesul final este intersecția dintre grant, consimțământul din browser, rolul POS live și alocările live. Nu ocoli o permisiune lipsă prin SQL sau clickuri riscante.