conecteaza-symbai

Conectează / repară conexiunea Symbai (MCP)

Scop: serverul MCP symbai să apară conectat în sesiunile Claude Code ale utilizatorului, cu tool-urile lui (list_brands, raport_vanzari, gaseste_in_aplicatie etc.).

Ce îți trebuie de la utilizator

• URL-ul instanței: https://<subdomeniu>.symbai.app/mcp (subdomeniul restaurantului lui).
• Tokenul symbai_mcp_... — îl creează din portalul Hub (hub.symbai.app) → secțiunea „Acces AI (Claude Code)". Se afișează o singură dată, la creare. Dacă nu-l mai are: să revoce tokenul vechi din portal și să creeze altul (30 de secunde) — tokenul NU se poate recupera.

Configurarea corectă (încearcă în ordine)

1. Terminal cu CLI — dacă comanda claude există în terminal (verifică cu claude --version prin Bash):

   claude mcp add --transport http --scope user symbai <URL> --header "Authorization: Bearer <TOKEN>"
   

   --scope user e important: fără el, conexiunea se leagă de folderul curent și sesiunile pornite din alt folder nu o văd.

2. Fără CLI (tipic: aplicația Claude Desktop, tab-ul Code) — editează direct fișierul .claude.json din folderul home al utilizatorului (Windows: C:\Users\<nume>\.claude.json; macOS/Linux: ~/.claude.json). În obiectul "mcpServers" de la nivelul rădăcină al JSON-ului (creează-l dacă lipsește) adaugă:

   "symbai": { "type": "http", "url": "<URL>", "headers": { "Authorization": "Bearer <TOKEN>" } }
   

   Păstrează restul fișierului neatins. Imediat după salvare, cere-i utilizatorului să închidă complet și să redeschidă aplicația — configurația se citește la pornire, iar aplicația poate suprascrie fișierul dacă sesiunea continuă mult după editare.

Capcana #1 — claude_desktop_config.json (NU-l folosi)

claude_desktop_config.json (Windows: %APPDATA%\Claude\; macOS: ~/Library/Application Support/Claude/) este fișierul aplicației Claude Desktop (tab-ul Chat) și acceptă DOAR servere locale stdio (command + args). O intrare HTTP symbai pusă acolo nu funcționează și produce la pornirea aplicației eroarea:

"Some MCP servers could not be loaded ... are not valid MCP server configurations and were skipped: symbai"

Dacă utilizatorul vede eroarea asta: deschide fișierul, șterge intrarea symbai din mcpServers (doar intrarea, nu restul fișierului), salvează. Apoi fă configurarea corectă de mai sus.

Verificare (în ordine)

1. Instanța e activă? POST la <URL> fără header de autorizare → trebuie HTTP 401 cu mesajul „Lipsește tokenul". Dacă primești 404/HTML → URL greșit (verifică subdomeniul); timeout → problemă de internet.
2. Tokenul e valid? Același POST cu headerul Authorization: Bearer <TOKEN> și body JSON-RPC initialize → trebuie HTTP 200. Dacă primești tot 401 → token revocat/expirat/copiat greșit → regenerare din portal.
3. După restart, într-o sesiune NOUĂ: /mcp trebuie să arate serverul symbai conectat, iar tool-urile Symbai devin disponibile.

Alte cauze frecvente

• Aplicația nu a fost repornită complet — conexiunile MCP se încarcă la pornirea sesiunii; închide de tot aplicația (nu doar fereastra) și redeschide.
• Config în scope local, alt folder — claude mcp add rulat FĂRĂ --scope user; re-adaugă cu --scope user.
• „Permisiune insuficientă" la un tool — conexiunea e OK; modulul de scriere nu e bifat pe token → portal Hub → Acces AI → butonul „Permisiuni" pe token (se aplică în ~1 minut).
• Accesul s-a oprit brusc după ce mergea — tokenul a fost revocat (din portal sau de echipa Symbai) ori a expirat → verifică în portal, regenerează.