Integrare AI · MCP

Controlați-vă infrastructura cu AI

Conectați asistentul AI (Claude Desktop, Cursor sau orice client compatibil MCP) direct la contul dvs. blackbox.md. Întrebați despre servere, sold și facturi și controlați-vă serverele — în limbaj natural. Accesul este limitat de un token personal pe care îl puteți revoca oricând.

Creează token API Contactați-ne

Conectare în 3 pași

Creați un token de acces

Autentificați-vă și deschideți „Token-uri API". Alegeți permisiunile (implicit — doar citire) — sau apăsați presetarea „AI-administrator — acces complet" dacă vreți ca asistentul să vă administreze serverele. Dați-i un nume și creați token-ul: asistentul nu are nevoie de nimic altceva în afară de acest token. Se afișează o singură dată — copiați-l imediat.

Adăugați conexiunea în clientul AI

Deschideți setările Claude Desktop, Cursor sau ale altui client compatibil MCP și adăugați serverul BLACKBOX cu adresa și token-ul în antetul Authorization (vezi exemplul de mai jos).

Reporniți clientul și întrebați

După repornire, asistentul AI vede uneltele BLACKBOX. Întrebați-l pur și simplu despre serverele sau facturile dvs. — va apela singur unealta potrivită.

Exemplu de configurare

Înlocuiți bbx_pat_... cu token-ul creat de dvs. Adresa de conectare este aceeași pentru toți clienții:

Adresa serverului MCP

https://api.app.blackbox.md/mcp

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

Conectare prin conector în aplicația Claude (claude.ai / Claude Desktop)

În dialogul „Custom connector" al aplicației Claude, antetul Authorization este rezervat pentru OAuth și nu poate fi setat. De aceea token-ul se trimite în antetul personalizat x-api-key — serverul BLACKBOX îl acceptă exact ca pe Authorization: Bearer.

Settings → Connectors → Add custom connector. URL server: https://api.app.blackbox.md/mcp.
Secțiunea „OAuth client": nu completați nimic (lăsați opțiunea implicită, fără Client ID).
Secțiunea „Request headers" → Add header: nume x-api-key, valoare — token-ul dvs. bbx_pat_… (fără cuvântul Bearer), „Required" bifat.
Salvați și conectați-vă. Dacă anterior apărea eroarea „Couldn't register with BlackBox's sign-in service", token-ul nu ajungea la server; după adăugarea antetului eroarea dispare.

Sunt acceptate și antetele x-api-token, x-auth-token, api-key și x-access-token. În Claude Code (terminal) și Cursor folosiți în continuare Authorization: Bearer, ca în exemplul de mai sus.

Exemple de întrebări

Asistentul nu are nevoie nici de parolă, nici de o cheie SSH de la dvs. — doar de token: accesul la server îl obține singur, prin conexiunea noastră securizată.

„Arată-mi serverele mele BLACKBOX și statusul lor"
„Care este soldul meu și ce facturi am neplătite?"
„Instalează nginx pe serverul meu"

Unelte disponibile

Fiecare unealtă necesită permisiunea corespunzătoare a token-ului. Unealta nu este disponibilă dacă nu ați acordat token-ului acea permisiune.

Unealtă	Ce face	Permisiune	Status
Lista serverelor	Toate serverele dvs. cu statusul lor	`servers:read`	Disponibil
Detalii server	Status, adresă IP, stare alimentare	`servers:read`	Disponibil
Sold	Soldul curent al portofelului	`billing:read`	Disponibil
Tranzacții	Istoricul alimentărilor și plăților	`billing:read`	Disponibil
Comenzi	Lista comenzilor dvs.	`billing:read`	Disponibil
Facturi	Lista facturilor dvs.	`billing:read`	Disponibil
Control alimentare	Repornire / oprire / pornire	`servers:power`	Disponibil
Acces la server	Vizualizare și resetare parolă root	`servers:credentials`	Disponibil
Comandă și plată	Creează și plătește o comandă din sold	`orders:write`	Disponibil
Lista cheilor SSH `list_ssh_keys`	Toate cheile SSH înregistrate de dvs.	`ssh_keys:read`	Disponibil
Adaugă cheie SSH `add_ssh_key`	Înregistrează o nouă cheie publică SSH	`ssh_keys:write`	Disponibil
Șterge cheie SSH `delete_ssh_key`	Șterge una dintre cheile dvs. SSH	`ssh_keys:write`	Disponibil
Adaugă cheie pe server `add_server_ssh_key`	Trimite o cheie SSH salvată pe un server deja activ	`servers:credentials`	Disponibil
Autentificare cu parolă `set_server_password_auth`	Activează/dezactivează login SSH cu parolă pe server	`servers:credentials`	Disponibil
Chei pe server `list_server_ssh_keys`	Lista cheilor SSH instalate pe server	`servers:credentials`	Disponibil
Șterge cheie de pe server `remove_server_ssh_key`	Șterge una dintre cheile SSH instalate pe server	`servers:credentials`	Disponibil
Acces SSH `get_server_ssh_access`	Emite o cheie SSH pe care o instalăm noi pe server	`servers:credentials`	Disponibil
Rulează comandă `run_server_command`	Rulează o comandă ca root pe serverul dvs.	`servers:exec`	Disponibil

Uneltele de control (alimentare, acces, comenzi) se lansează treptat. Acțiunile care cheltuiesc bani sau modifică serverul necesită întotdeauna o confirmare explicită în clientul dvs. AI.

La comandă, dacă atașați cel puțin o cheie SSH, autentificarea cu parolă prin SSH este dezactivată implicit (config.ssh.password_auth). Parola de consolă rămâne disponibilă.

Serverele dvs.

AI-ul vede lista serverelor, statusul și adresele IP — doar cele care vă aparțin.

Sold și facturi

Întrebați despre soldul portofelului, istoricul tranzacțiilor, comenzi și facturi neplătite.

Acces controlat

Token-ul este limitat la permisiunile alese și legat doar de contul dvs. Revocare într-un singur clic.

Standard MCP

Protocolul deschis Model Context Protocol — funcționează cu Claude Desktop, Cursor și alți clienți.

Întrebări frecvente

Ce este MCP?

Model Context Protocol este un standard deschis care permite asistenților AI să se conecteze în siguranță la servicii externe printr-un set de „unelte". BLACKBOX oferă un astfel de server MCP pentru contul dvs.

Poate AI-ul să-mi cheltuie banii?

Implicit, token-ul oferă acces doar de citire. Acțiunile care cheltuiesc bani (crearea și plata comenzilor) necesită permisiunea separată orders:write ȘI o confirmare explicită în clientul dvs. AI la fiecare apel. Nu acordați această permisiune dacă nu doriți această posibilitate.

Cine îmi vede datele?

Doar clientul AI și furnizorul acestuia căruia i-ați dat token-ul. Permisiunea „Acces la server" transmite parolele serverelor către clientul AI — acordați-o în cunoștință de cauză.

Cum revoc accesul?

Deschideți „Token-uri API" în cont și revocați token-ul dorit. Încetează să funcționeze imediat. Puteți avea mai multe token-uri cu permisiuni diferite.

Ce clienți sunt suportați?

Orice client compatibil MCP: Claude Desktop, Cursor și alții. Conectarea se face prin adresa serverului și token-ul din antetul Authorization.

Creați un token și conectați-vă

Crearea unui token este gratuită și durează un minut. Începeți cu acces doar de citire și extindeți permisiunile după nevoie.

Contactați-ne Vezi planurile VPS