Token-uri API: creare, copiere și revocare

Pagina „Token-uri de acces (API)” (blackbox.md/account/api-tokens, „Contul meu” → „Token-uri API”) creează token-urile cu care un asistent AI (Claude, Cursor, VS Code etc.) se conectează la contul dvs. prin MCP. Descrierea de pe pagină: „Creați un token pentru a conecta un asistent AI (Claude Desktop, Cursor etc.) la contul dvs. blackbox.md prin MCP. Token-ul oferă acces doar la datele pe care le permiteți explicit mai jos.” Token-urile se gestionează doar aici: panoul app.blackbox.md nu are o astfel de pagină.

Disponibil pentru: orice client autentificat pe blackbox.md. Un token acționează în numele contului dvs., numai cu permisiunile bifate la creare.

Cum creați un token

1. Autentificați-vă pe blackbox.md și apăsați „Cont client” în bara de sus (pe telefon se vede doar pictograma contului).
2. În meniul din stânga alegeți „Token-uri API”. Pe telefon și pe tabletă, meniul se deschide cu butonul „Meniu cont”. Linkul „Cum funcționează — ghid complet →” de sub titlu deschide prezentarea integrării AI (blackbox.md/info/mcp).
3. În cardul „Token nou”, completați „Nume token” cu numele clientului AI sau al dispozitivului, de exemplu „Claude Desktop (laptop)”. Numele este obligatoriu și are 1–80 de caractere.
4. La „Permisiuni” bifați ce poate face asistentul. Primele trei permisiuni (doar citire) sunt bifate deja. Permisiunile scrise cu roșu sunt riscante: permit modificări sau accesul la parolele serverelor. Când bifați una, sub ea apare avertismentul „Atenție: cu această permisiune asistentul AI va putea … Acordați-o doar clienților în care aveți încredere — token-ul poate fi revocat oricând.”
5. Apăsați „Creează token”. Cât timp se lucrează, butonul arată „Se creează…”.
6. Deasupra formularului apare cardul „Token-ul dvs. nou”. Copiați token-ul imediat (vedeți secțiunea următoare). Formularul se golește, iar la „Permisiuni” rămân bifate din nou cele trei permisiuni de citire.

Ce unelte deblochează fiecare permisiune găsiți în Permisiunile token-urilor (scopes). Ce permisiuni cere o anumită sarcină: Exemple de sarcini pentru asistentul AI și permisiunile necesare.

Presetarea „AI-administrator — acces complet”

Butonul „AI-administrator — acces complet” de deasupra listei de permisiuni bifează toate cele 8 permisiuni. Cât timp toate sunt bifate, sub listă apare textul: „Acces complet: asistentul va putea rula orice comandă ca root pe serverele dvs., vedea parole și chei și cheltui din sold. Exact ce are nevoie un administrator AI — nu trebuie să îi mai dați nimic în afară de token.” După presetare puteți debifa orice permisiune înainte de „Creează token”.

Risc Permisiunea „Rulează orice comandă ca root pe serverele mele” dă acces root la toate serverele dvs., iar permisiunea „Plasează și modifică comenzi în numele meu” permite cheltuieli din sold. Oricine are token-ul îl poate folosi de oriunde, până îl revocați. Pentru sarcini care doar citesc date, creați un token separat, fără permisiuni roșii.

Cum copiați token-ul

Cardul „Token-ul dvs. nou” arată token-ul complet o singură dată.

1. Citiți avertismentul „Copiați token-ul acum — nu va mai fi afișat din nou.”

2. Apăsați „Copiază”. Timp de două secunde butonul arată „Copiat!”. Dacă textul butonului nu se schimbă, browserul nu permite copierea automată: selectați token-ul cu mouse-ul și copiați-l manual.

3. Lipiți token-ul în clientul AI sau într-un manager de parole.

4. Folosiți datele din caseta „Conectarea unui client AI” („Adăugați această conexiune în setările Claude Desktop / Cursor (sau orice client compatibil MCP):”):

   Rând	Valoare
   „URL server”	https://api.app.blackbox.md/mcp
   „Antet de autorizare”	Authorization: Bearer bbx_pat_… (cu token-ul dvs. complet)

5. Apăsați „Gata”. Cardul se închide, iar token-ul nu mai poate fi afișat. Același lucru se întâmplă dacă reîncărcați pagina sau plecați de pe ea.

Un token are forma bbx_pat_ urmat de 43 de caractere (litere, cifre, - și _). Pașii pentru fiecare client: Conectarea în aplicația Claude (connector personalizat) (acolo token-ul se pune în antetul x-api-key, fără „Bearer”) și Conectarea din Claude Code, Cursor, VS Code și alți clienți.

Important BLACKBOX nu păstrează token-ul în clar, ci doar o amprentă criptografică a lui. Nici noi nu vi-l putem arăta din nou. Dacă l-ați pierdut, creați un token nou și revocați-l pe cel vechi.

Lista token-urilor

Sub formular, tabelul arată toate token-urile, de la cel mai nou:

Când nu aveți niciun token, pagina arată „Nu aveți încă token-uri de acces.”

Cum revocați un token

1. În tabel, apăsați „Revocă” pe rândul token-ului.
2. Se deschide fereastra „Revocați token-ul?” cu textul „Revocați acest token? Orice client AI care îl folosește va pierde accesul imediat.”
3. Apăsați „Revocă” ca să confirmați sau „Anulează” ca să renunțați.
4. Butonul arată „Se revocă…”. Apoi rândul devine gri, iar în locul butonului apare cuvântul „Revocă”, scris cu gri, cursiv. Dacă rândul rămâne neschimbat, revocarea nu a reușit: reîncărcați pagina și încercați din nou.

Revocarea are efect imediat: la următoarea cerere, clientul AI primește eroarea token not recognised (revoked, expired, or unknown). Revocarea nu se poate anula. Token-urile revocate nu se pot șterge: rămân în listă, gri.

Când nu mai funcționează un token

Implicit, token-urile nu expiră, iar pagina nu vă permite să setați o dată de expirare. Înlocuiți-le periodic: creați un token nou, puneți-l în client și revocați-l pe cel vechi.

Limite și erori

Erorile pe care le primește clientul AI la conectare sunt explicate în Limite și coduri de eroare MCP.

Întrebări frecvente

Am închis cardul înainte să copiez token-ul. Îl pot recupera? Nu. Creați un token nou și revocați-l pe cel necopiat, ca să nu rămână în listă un token pe care nu îl folosiți.

Cum adaug o permisiune unui token existent? Nu se poate. Creați un token nou cu permisiunile necesare, înlocuiți-l în clientul AI, apoi revocați-l pe cel vechi.

Primesc un email când se creează sau se revocă un token? Nu, nu se trimite niciun email. Verificați periodic lista și coloana „Ultima utilizare” și revocați token-urile pe care nu le recunoașteți.

De ce „Ultima utilizare” arată încă „niciodată”? Prima folosire se înregistrează imediat, dar pagina nu se actualizează singură: reîncărcați-o. Dacă tot vedeți „niciodată”, clientul AI nu s-a conectat încă cu acest token: verificați adresa și antetul din setările clientului.

Pot crea sau revoca token-uri prin asistentul AI ori din panou? Nu. Token-urile se creează și se revocă doar pe această pagină, în contul blackbox.md.

Pot folosi token-ul și pentru alt API? Nu. Token-ul este acceptat doar la adresa MCP https://api.app.blackbox.md/mcp.

Câte token-uri să creez? Câte unul pentru fiecare client AI sau dispozitiv, cu un nume clar. Dacă pierdeți laptopul, revocați doar token-ul lui. Mai multe recomandări în Securitatea token-urilor și a agenților AI.