Exemple de sarcini pentru asistentul AI și permisiunile necesare

Formulări gata de folosit pentru servere, chei SSH, comenzi și sold, cu uneltele folosite și permisiunile pe care trebuie să le aibă token-ul.

Aici găsiți formulări gata de folosit pentru asistentul AI conectat la contul dvs. prin MCP (https://api.app.blackbox.md/mcp). Pentru fiecare sarcină sunt indicate uneltele pe care le apelează asistentul și permisiunile de care are nevoie token-ul. Permisiunile le alegeți la crearea token-ului, în „Contul meu” → „Token-uri API” (blackbox.md/account/api-tokens).

Disponibil pentru: titularul contului blackbox.md, cu un asistent AI conectat printr-un token API (Conectarea în aplicația Claude (connector personalizat) sau Conectarea din Claude Code, Cursor, VS Code și alți clienți).

Începeți cu „Apelează whoami”

La începutul fiecărei sesiuni, scrieți asistentului: „Apelează whoami”. Unealta whoami nu cere nicio permisiune.
Asistentul confirmă că token-ul funcționează și vă arată ce permisiuni are (scopes) și ce permisiuni îi lipsesc (missing_scopes). Dacă nu lipsește nimic, unealta răspunde „All scopes granted — every tool is available.”
Dacă lipsește o permisiune de care are nevoie sarcina dvs., creați un token nou cu permisiunea respectivă și înlocuiți-l în clientul AI. Permisiunile unui token existent nu se pot extinde. Vedeți Permisiunile token-urilor (scopes).

Uneltele pentru care token-ul nu are permisiune nici nu apar în lista asistentului. De aceea, uneori asistentul spune doar că „nu are” unealta potrivită.

Exemplele de pe blackbox.md/info/mcp

Pagina blackbox.md/info/mcp publică trei exemple de cereri:

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

Le găsiți și în tabelele de mai jos, cu permisiunile necesare.

Permisiunile din tabele

Cod	Bifa din formularul „Token nou”	Bifată implicit
`servers:read`	„Citește lista și statusul serverelor mele”	da
`billing:read`	„Citește soldul, facturile și comenzile”	da
`ssh_keys:read`	„Citește lista cheilor mele SSH”	da
`servers:power`	„Controlează alimentarea serverelor (repornire/oprire/pornire)”	nu
`servers:credentials`	„Vizualizează parolele/accesul serverelor”	nu
`servers:exec`	„Rulează orice comandă ca root pe serverele mele”	nu
`orders:write`	„Plasează și modifică comenzi în numele meu”	nu

Butonul „AI-administrator — acces complet” bifează toate permisiunile, inclusiv „Adaugă și șterge cheile mele SSH” (ssh_keys:write).

Sarcini gata de folosit

Scrieți sarcina cu cuvintele dvs.: formulările de mai jos sunt modele. Dacă aveți mai multe servere, numiți serverul (numele din panou sau adresa IP). Asistentul îl găsește singur cu list_servers, de aceea sarcinile pe server cer și servers:read.

Citire

Sarcina	Ce scrieți	Unelte	Permisiuni
Serverele și statusul lor	„Arată-mi serverele mele BLACKBOX și statusul lor”	`list_servers`, `get_server`	`servers:read`
Soldul și facturile neplătite	„Care este soldul meu și ce facturi am neplătite?”	`get_balance`, `list_invoices`	`billing:read`
Ultimele tranzacții	„Arată-mi ultimele 10 tranzacții din sold”	`list_transactions`	`billing:read`
Planuri și prețuri	„Ce planuri VPS aveți cu 4 vCPU și cât costă?”	`list_vm_plans`	niciuna

Servere și acces

Sarcina	Ce scrieți	Unelte	Permisiuni
Repornire cu verificare	„Repornește serverul meu și spune-mi când răspunde din nou”	`power_server`, apoi `get_server`	`servers:power`, `servers:read`
Spațiul pe disc	„Arată-mi cât spațiu este ocupat pe discul serverului meu și cele mai mari 20 de directoare”	`run_server_command`	`servers:exec`, `servers:read`
Instalarea nginx	„Instalează nginx pe serverul meu”	`run_server_command`	`servers:exec`, `servers:read`
Doar cheia de pe laptop, fără parolă	„Pe serverul meu lasă doar cheia SSH «Laptop» din cont și dezactivează autentificarea cu parolă. Arată-mi întâi ce vei face și așteaptă confirmarea mea.”	`list_ssh_keys`, `add_server_ssh_key`, apoi `set_server_password_auth`; pentru celelalte chei, `list_server_ssh_keys` și `remove_server_ssh_key`	`servers:credentials`, `servers:read`, `ssh_keys:read`
Ștergerea unei chei vechi	„Ce chei SSH sunt instalate pe serverul meu? Șterge-o pe cea numită old-laptop.”	`list_server_ssh_keys`, apoi `remove_server_ssh_key`	`servers:credentials`, `servers:read`
Comandă SSH pentru rsync	„Dă-mi o comandă SSH ca să copiez fișiere cu rsync pe serverul meu”	`get_server_ssh_access`	`servers:credentials`, `servers:read`

Repornirea: power_server doar acceptă cererea. Asistentul verifică apoi cu get_server că starea power_state este running. SSH și serviciile pot avea nevoie de încă 30–60 de secunde.
Cheile: pe server, o cheie se recunoaște după comentariul de la sfârșitul liniei ei (de exemplu old-laptop). Cheile salvate pe pagina „Chei SSH” asistentul le găsește după nume, cu list_ssh_keys. „Cheie de administrare (blackbox.md)” rămâne întotdeauna pe server și nu se poate șterge.
rsync: asistentul primește o cheie SSH dedicată, pe care BLACKBOX o instalează pe server, și o comandă ssh gata de folosit. Detalii: Acces SSH și chei SSH prin asistentul AI.

Bani și comenzi

Sarcina	Ce scrieți	Unelte	Permisiuni
Ofertă pentru un server nou	„Fă o ofertă pentru un server Standard M cu Ubuntu 24.04 și cheia mea SSH, apoi așteaptă confirmarea mea”	`list_vm_plans`, `list_ssh_keys`, `create_order` fără confirmare	`orders:write`, `ssh_keys:read`
Plata unei comenzi	„Achită din sold comanda BBX-2026-000123”	`list_orders`, apoi `pay_order`	`orders:write`, `billing:read`
Cât se returnează la anulare	„Cât mi s-ar returna dacă anulez comanda BBX-2026-000123? Nu anula nimic încă.”	`list_orders`, apoi `cancel_order` fără confirmare	`orders:write`, `billing:read`
Upgrade după verificarea prețului	„Fă upgrade serverului la planul următor, dar arată-mi întâi prețul”	`get_server_resize_options`, apoi `resize_server` fără confirmare	`servers:read`, `orders:write`

Oferta: create_order fără confirmare doar calculează totalul și nu creează nimic. După acordul dvs., asistentul repetă apelul cu confirm=true, iar comanda apare în „Comenzi” cu statusul „Nou”. Banii se retrag abia la pay_order.
Plata și anularea: asistentul găsește comanda după număr cu list_orders, care îi dă și totalul curent, cerut de pay_order.
Upgrade-ul: doar spre un plan mai mare din aceeași familie, cu plata din sold. La confirmare serverul repornește, iar întreruperea durează câteva minute.

Toate detaliile: Comenzi, plăți, anulări și upgrade prin AI.

Bani și acțiuni ireversibile: cereți întâi o previzualizare

Instrucțiunile pe care BLACKBOX le dă asistentului stabilesc când vă cere acordul și când acționează direct. Sunt instrucțiuni, nu o blocare tehnică, de aceea cereți și dvs. pauza în mesaj.

Situația	Ce face asistentul
Bani: plasarea comenzii (`create_order` cu `confirm=true`), plata (`pay_order`), upgrade-ul (`resize_server` cu `confirm=true`)	vă cere confirmarea
Date și acces: anularea comenzii (`cancel_order` cu `confirm=true`), ștergerea unei chei de pe server, dezactivarea autentificării cu parolă, înlocuirea cheii de acces SSH a asistentului	vă cere confirmarea
Restul: citirea datelor, comenzile pe server, instalarea programelor, repornirea pe care ați cerut-o	acționează direct și vă spune rezultatul

Cum lucrați în siguranță:

Cereți întâi oferta sau previzualizarea și adăugați în cerere „așteaptă confirmarea mea”.
Citiți ce vă arată asistentul: totalul în MDL, planul și sistemul de operare; la anulare, suma returnată în sold și dacă se șterge un server; la chei, ce chei rămân pe server.
Confirmați explicit, într-un mesaj separat.
Când clientul AI vă cere aprobarea pentru apel, verificați că parametrii sunt cei confirmați.

Formulări care opresc asistentul înainte de pasul important:

Fă o ofertă și așteaptă confirmarea mea înainte de a plasa sau a plăti comanda.
Arată-mi doar previzualizarea anulării, fără să confirmi nimic.
Spune-mi ce chei vei șterge și ce rămâne pe server, apoi așteaptă confirmarea mea.
Arată-mi comanda pe care vrei s-o rulezi și așteaptă confirmarea mea.

Important Fereastra de aprobare o afișează clientul AI, nu BLACKBOX. Nu alegeți pentru unelte opțiunea de a le permite întotdeauna, fără întrebare, mai ales pentru create_order, pay_order, cancel_order, resize_server, remove_server_ssh_key, set_server_password_auth și run_server_command. Înainte să dezactivați autentificarea cu parolă, verificați într-un terminal nou că vă conectați cu propria cheie: clienții nu au consolă web sau VNC (Activarea și dezactivarea autentificării SSH cu parolă).

Ireversibil Dacă o comandă are un server, anularea ei confirmată șterge serverul imediat, cu toate datele, fără perioadă de grație. Cereți întotdeauna întâi previzualizarea: Comenzi, plăți, anulări și upgrade prin AI.

Sarcini lungi

Asistentul așteaptă o singură comandă pe server cel mult 300 de secunde (implicit 60). Când timpul expiră, rezultatul vine cu timed_out: true, iar comanda poate rula în continuare pe server. Pentru lucrări lungi (actualizarea sistemului, un backup, o compilare), cereți explicit pornirea în fundal, cu nohup sau systemd-run:

Pornește în fundal, cu nohup, actualizarea sistemului pe serverul meu, cu ieșirea în /root/upgrade.log, și nu aștepta să se termine.

Mai târziu:

Verifică dacă actualizarea de pe serverul meu s-a terminat și arată-mi ultimele 30 de rânduri din /root/upgrade.log.

După timed_out: true, nu cereți repetarea aceleiași comenzi: cereți întâi o verificare. Detalii: Rularea comenzilor pe server prin AI.

Ce nu poate face asistentul

Sarcina	Unde o faceți
Tichetele de suport	blackbox.md, „Contul meu” → „Ajutor și suport”: Deschiderea unui tichet de suport
Alimentarea soldului	blackbox.md: Alimentarea soldului
Plata facturilor	Plata automată a facturilor din sold sau Plata prin transfer bancar și rechizitele BLACKBOX
Înregistrările DNS	panoul app.blackbox.md: Gestionarea înregistrărilor DNS din panou
Monitorizarea și alertele	panoul: Pagina „Monitorizare”
Redenumirea serverului	panoul: Redenumirea serverului (nume privat)
Reinstalarea sistemului de operare	la cerere, prin suport: Sistemele de operare disponibile

Lista completă: Integrarea AI (MCP): ce este și ce poate face.

Întrebări frecvente

Asistentul spune că nu are unealta potrivită sau primește missing_scope. Ce fac? Token-ul nu are permisiunea necesară; eroarea o numește. Creați un token nou cu acea permisiune și înlocuiți-l în clientul AI: Token-uri API: creare, copiere și revocare.

Trebuie să-i dau asistentului id-ul serverului? Nu. Numiți serverul după nume sau adresa IP; asistentul ia id-ul din list_servers. Pentru asta token-ul are nevoie de servers:read.

Pot folosi un singur token pentru toate exemplele? Da, cu „AI-administrator — acces complet”. Este mai sigur să folosiți zilnic un token doar pentru citire și să creați un token cu acces complet doar când aveți nevoie de el: Securitatea token-urilor și a agenților AI.

Asistentul primește rate_limited. De ce? Ați depășit limita unei unelte. Previzualizările se numără și ele: create_order acceptă 20 de apeluri pe oră, cancel_order 5 în 5 minute, resize_server 3 în 10 minute. Așteptați și nu repetați apelul în buclă: Limite și coduri de eroare MCP.