Integrarea AI (MCP): ce este și ce poate face

Cum conectați un asistent AI la contul BLACKBOX, ce poate face pentru dvs. și ce nu poate face.

Integrarea AI vă permite să administrați contul BLACKBOX dintr-un asistent AI, în limbaj obișnuit: serverele, accesul SSH, soldul, comenzile și facturile. Pentru aceasta, BLACKBOX rulează un server MCP numit blackbox, la adresa https://api.app.blackbox.md/mcp. Prezentarea generală este pe pagina blackbox.md/info/mcp, iar token-urile de acces le creați în „Contul meu” → „Token-uri API” (blackbox.md/account/api-tokens).

Disponibil pentru: titularul contului blackbox.md. Panoul app.blackbox.md nu are setări pentru AI: totul se face în contul de pe blackbox.md și în clientul AI.

Ce este MCP

Model Context Protocol (MCP) este un standard deschis prin care un asistent AI se conectează la servicii externe și le folosește „uneltele”. Serverul MCP BLACKBOX îi oferă asistentului unelte pentru un singur cont blackbox.md: al dvs.

Clienți compatibili: Claude (aplicația web și Claude Desktop, prin „Custom connector”, plus Claude Code), Cursor, VS Code cu GitHub Copilot și orice alt client care se conectează la servere MCP la distanță prin HTTP (Streamable HTTP) și permite un antet (header) personalizat.
Autentificare: un token API personal, de forma bbx_pat_…, pe care îl creați pe blackbox.md. Asistentul nu are nevoie de parola contului, de parola root sau de cheia dvs. SSH: îi ajunge token-ul.
Permisiuni: la crearea token-ului bifați ce are voie să facă asistentul. Uneltele pentru care token-ul nu are permisiune nici nu apar în lista asistentului.
Cost: integrarea este gratuită. Token-urile și apelurile MCP nu se taxează; plătiți doar serviciile pe care le comandați.

Conectarea în 3 pași

1. Creați un token

Pe blackbox.md, deschideți „Contul meu” → „Token-uri API” (pagina „Token-uri de acces (API)”).
În cardul „Token nou”, completați „Nume token”, de exemplu „Claude Desktop (laptop)”.
La „Permisiuni”, cele trei permisiuni de citire sunt bifate implicit. Bifați și altele dacă vreți ca asistentul să facă modificări sau apăsați „AI-administrator — acces complet” ca să le bifați pe toate opt.
Apăsați „Creează token”.
Apare cardul „Token-ul dvs. nou”, cu mesajul „Copiați token-ul acum — nu va mai fi afișat din nou.” Apăsați „Copiază” (butonul devine „Copiat!”), păstrați token-ul într-un loc sigur, apoi apăsați „Gata”.

Detalii: Token-uri API: creare, copiere și revocare.

2. Adăugați serverul în clientul AI

Valorile sunt aceleași în toți clienții:

Câmp	Valoare
Nume în configurație	`blackbox` (recomandat)
URL server	`https://api.app.blackbox.md/mcp`
Transport	HTTP (Streamable HTTP)
Antet de autorizare	`Authorization: Bearer bbx_pat_…`
În aplicația Claude („Custom connector”)	antetul `x-api-key`, cu valoarea `bbx_pat_…`, fără cuvântul `Bearer`

În Cursor, serverul se adaugă într-un fișier JSON, în formatul de pe blackbox.md/info/mcp:

{
  "mcpServers": {
    "blackbox": {
      "url": "https://api.app.blackbox.md/mcp",
      "headers": {
        "Authorization": "Bearer bbx_pat_..."
      }
    }
  }
}

Înlocuiți bbx_pat_... cu token-ul dvs. și reporniți clientul dacă o cere. Alți clienți (de exemplu VS Code) folosesc un format puțin diferit. Pașii pentru fiecare client: Conectarea în aplicația Claude (connector personalizat) și Conectarea din Claude Code, Cursor, VS Code și alți clienți.

3. Verificați conexiunea

Scrieți asistentului: „Apelează whoami”. Unealta whoami nu cere nicio permisiune. Ea confirmă că token-ul funcționează și arată ce permisiuni are și care îi lipsesc (missing_scopes). Dacă lipsește o permisiune de care aveți nevoie, creați un token nou: permisiunile unui token existent nu se pot extinde.

Dacă clientul AI raportează eroarea invalid_token, vedeți Limite și coduri de eroare MCP.

Ce poate face asistentul

Domeniu	Ce poate face	Permisiunea necesară
Planuri	listează planurile VPS, cu resursele și prețurile lor	niciuna
Servere	listează serverele dvs., cu statusul, adresa IP și starea alimentării	„Citește lista și statusul serverelor mele” (`servers:read`)
Alimentare	repornește, oprește și pornește serverul	„Controlează alimentarea serverelor (repornire/oprire/pornire)” (`servers:power`)
Acces la server	afișează sau resetează parola root; primește acces SSH direct, cu o cheie pe care BLACKBOX o instalează pe server; adaugă, listează și șterge cheile SSH de pe server; activează sau dezactivează autentificarea SSH cu parolă	„Vizualizează parolele/accesul serverelor” (`servers:credentials`)
Rularea comenzilor	rulează orice comandă ca `root`, de exemplu instalează nginx	„Rulează orice comandă ca root pe serverele mele” (`servers:exec`)
Cheile SSH din cont	le listează; le adaugă și le șterge	„Citește lista cheilor mele SSH” (`ssh_keys:read`); „Adaugă și șterge cheile mele SSH” (`ssh_keys:write`)
Sold și facturare	citește soldul, tranzacțiile, comenzile și facturile	„Citește soldul, facturile și comenzile” (`billing:read`)
Comenzi și plăți	calculează prețul și plasează o comandă, o plătește din sold, anulează o comandă, face upgrade unui server	„Plasează și modifică comenzi în numele meu” (`orders:write`)

Ca să găsească un server, asistentul are nevoie și de servers:read. Lista completă a uneltelor, cu parametri și limite: Lista uneltelor MCP. Ce permite fiecare permisiune: Permisiunile token-urilor (scopes).

Atenție Cu orders:write, asistentul poate cheltui din sold și poate anula comenzi. Anularea unei comenzi cu server activ șterge serverul imediat, cu toate datele, fără perioadă de grație. Permisiunile servers:credentials și servers:exec dau acces root la toate serverele dvs. Acordați-le doar când chiar aveți nevoie de ele.

Ce nu poate face asistentul

Acțiune	Unde o faceți
Crearea și revocarea token-urilor	blackbox.md, „Token-uri API”
Alimentarea soldului și plata cu cardul	blackbox.md: Alimentarea soldului
Plata facturilor	Plata automată a facturilor din sold sau Plata prin transfer bancar și rechizitele BLACKBOX
Tichetele de suport	blackbox.md, „Ajutor și suport”: Deschiderea unui tichet de suport
Monitorizarea, alertele și DNS	panoul app.blackbox.md: Pagina „Monitorizare”, Gestionarea înregistrărilor DNS din panou
Consola web sau VNC	nu există pentru clienți; vă conectați prin SSH, iar dacă pierdeți accesul, scrieți suportului
Reinstalarea sistemului de operare	la cerere, prin suport: Sistemele de operare disponibile
Trecerea la un plan mai mic (downgrade)	nu este posibilă nici în panou; comandați un server nou pe planul dorit și mutați datele
Redenumirea serverului	panoul: Redenumirea serverului (nume privat)
Ștergerea programată, cu 24 de ore în care o puteți anula	panoul: Ștergerea definitivă a unui server

De asemenea, asistentul nu are acces la profil, la parola contului, la datele de facturare și nici la ștergerea contului.

Nu există API REST

Token-urile bbx_pat_… funcționează doar la adresa https://api.app.blackbox.md/mcp. BLACKBOX nu oferă clienților un API REST: celelalte adrese ale site-ului și ale panoului acceptă doar sesiunea din browser și resping token-ul. Dacă vreți să automatizați ceva din propriul cod, folosiți tot MCP: Folosirea MCP din cod (API-uri AI și HTTP).

Exemple de cereri

Ce scrieți asistentului	Permisiunile necesare
„Arată-mi serverele mele BLACKBOX și statusul lor”	`servers:read`
„Care este soldul meu și ce facturi am neplătite?”	`billing:read`
„Instalează nginx pe serverul meu”	`servers:read`, `servers:exec`
„Ce planuri VPS aveți cu 4 vCPU și cât costă?”	niciuna
„Repornește serverul meu și spune-mi când răspunde din nou”	`servers:read`, `servers:power`
„Ce chei SSH sunt instalate pe serverul meu?”	`servers:read`, `servers:credentials`
„Fă upgrade serverului la planul următor, dar arată-mi întâi prețul”	`servers:read`, `orders:write`

Primele trei exemple sunt cele de pe blackbox.md/info/mcp. Mai multe: Exemple de sarcini pentru asistentul AI și permisiunile necesare.

Ce date vede furnizorul AI

Tot ce întorc uneltele ajunge în clientul AI și la furnizorul care rulează modelul AI: lista serverelor, adresele IP, soldul, facturile, rezultatul comenzilor rulate pe server și, dacă ați acordat servers:credentials, parolele root și cheile de acces la servere. Folosiți un furnizor AI în care aveți încredere și acordați permisiunile de acces doar când este nevoie. În jurnalul de acțiuni, BLACKBOX notează doar că s-a rulat o comandă, fără textul ei și fără rezultat.

Securitate Token-ul este o cheie de acces la contul dvs.: oricine îl are poate face, de oriunde, tot ce îi permit permisiunile. Nu-l puneți în chat-uri, capturi de ecran sau depozite git. Creați câte un token pentru fiecare client sau dispozitiv și revocați-l cu „Revocă” când nu mai aveți nevoie de el; accesul se oprește imediat. Schimbarea parolei contului blackbox.md dezactivează toate token-urile create înainte. Mai multe: Securitatea token-urilor și a agenților AI.

Întrebări frecvente

Ce clienți AI funcționează? Orice client care se conectează la servere MCP la distanță prin HTTP și vă lasă să adăugați un antet personalizat: aplicația Claude (prin „Custom connector”, cu antetul x-api-key), Claude Code, Cursor, VS Code cu GitHub Copilot și alții. Aplicațiile care permit doar conectarea prin OAuth (autentificare cu un cont, fără antet) nu se pot conecta: serverul BLACKBOX acceptă numai token-ul.

Este contra cost? Nu. Integrarea și token-urile sunt gratuite. Plătiți doar serviciile comandate, inclusiv cele comandate prin asistent.

Poate asistentul să-mi cheltuie banii? Doar din sold și doar dacă token-ul are permisiunea orders:write. Uneltele pentru comenzi, anulări și upgrade arată implicit doar o previzualizare (prețul sau suma de rambursat) și acționează abia la confirmare, iar o comandă se plătește printr-un pas separat, care trece doar dacă suma indicată este exact prețul curent. Asistentul nu poate alimenta soldul și nu poate plăti cu cardul. Este instruit să vă ceară acordul înainte de orice cheltuială, dar fereastra de confirmare o afișează clientul AI, așa că nu activați aprobarea automată pentru aceste unelte. Detalii: Comenzi, plăți, anulări și upgrade prin AI.

Trebuie să-i dau asistentului parola root sau cheia mea SSH? Nu. Asistentul lucrează pe server prin conexiunea securizată BLACKBOX și are nevoie doar de token. Vedeți Cheile BLACKBOX de pe serverul dvs..

Pot conecta mai mulți asistenți sau mai multe dispozitive? Da. Creați câte un token pentru fiecare, cu permisiunile potrivite. Îi puteți revoca separat, fără să-i afectați pe ceilalți.