Lista uneltelor MCP

Serverul MCP blackbox (https://api.app.blackbox.md/mcp) îi oferă asistentului AI 25 de unelte. Asistentul alege singur unealta potrivită după ce îi descrieți sarcina; dvs. stabiliți, prin permisiunile token-ului, ce unelte are voie să folosească. Token-ul îl creați pe blackbox.md, în „Contul meu” → „Token-uri API” (blackbox.md/account/api-tokens).

Disponibil pentru: titularul contului blackbox.md, printr-un asistent AI conectat cu un token API. Uneltele lucrează doar cu datele contului care a creat token-ul.

Cum citiți tabelele

• Permisiune: codul permisiunii pe care trebuie s-o aibă token-ul; „—” înseamnă că nu e nevoie de niciuna. Ce bifă îi corespunde pe pagina „Token-uri de acces (API)”: Permisiunile token-urilor (scopes).
• Parametri: datele pe care asistentul le trimite uneltei. Nu le scrieți dvs., dar este util să le recunoașteți când clientul AI vă cere aprobarea pentru un apel.
• Limită: câte apeluri sunt permise pentru tot contul, cu toate token-urile la un loc. Aceste limite se numără separat de cele ale panoului app.blackbox.md. În plus, toate uneltele, în afară de whoami și list_vm_plans, au împreună o limită de 120 de apeluri pe minut.
• Sume: câmpurile …_mdl sunt în MDL întregi, iar câmpurile …_bani în bani (1 MDL = 100 de bani).

Comportamentul comun

Pe lângă serverele comandate de dvs., list_servers poate arăta și servere ale companiei la care BLACKBOX v-a dat acces. Când can_manage este false, serverul este doar pentru citire (în panou are insigna „Administrat”), iar uneltele de control nu funcționează pe el. Dacă BLACKBOX v-a acordat drept de administrare, câmpul capabilities arată acțiunile permise; upgrade-ul nu este disponibil pentru aceste servere.

Toate codurile de eroare, cu explicații: Limite și coduri de eroare MCP.

Descoperire și citire

Planurile, cu specificații și prețuri: Planurile VPS: cum alegeți. Numele privat se setează în panou: Redenumirea serverului (nume privat).

list_servers nu conține numărul comenzii. Ca să aflați din ce comandă provine un server, cereți asistentului list_orders și căutați comanda al cărei server_id este egal cu id-ul serverului.

Statusurile din răspunsuri

Uneltele returnează coduri în engleză. Tabelul arată eticheta lor de pe blackbox.md sau, unde site-ul nu are etichetă, ce înseamnă:

Controlul serverului

• power_server. Repornirea este una normală, nu forțată; după reboot, serverul răspunde de regulă în 30–60 de secunde. Pe unele servere ale companiei asupra cărora aveți drept de administrare este posibilă doar repornirea (celelalte acțiuni răspund no_instance_id). Vedeți și Repornirea, oprirea și pornirea serverului.
• reset_server_password. Pe un server „Doar cheie”, parola se schimbă, dar autentificarea SSH cu parolă rămâne dezactivată: Resetarea parolei root.
• run_server_command. Depășirea timpului nu este o eroare: vine timed_out: true, iar procesul poate rula în continuare pe server. Detalii: Rularea comenzilor pe server prin AI.
• get_server_ssh_access. Cheia agentului este una pe server, comună pentru toate token-urile dvs.: Acces SSH și chei SSH prin asistentul AI.
• Upgrade. Doar spre un plan mai mare, niciodată invers. Planurile „VPS hosting” și serverele dedicate răspund not_upgradeable_plan (upgrade prin suport). Dacă soldul nu ajunge, insufficient_balance apare deja la previzualizare. Vedeți Upgrade server: trecerea la un plan mai mare.

Securitate reveal_server_credentials, reset_server_password și get_server_ssh_access returnează parole și chei private în clar. Ele ajung în clientul AI și la furnizorul modelului AI. Acordați servers:credentials doar când este nevoie și cereți asistentului să nu afișeze secretele în conversație.

Chei SSH

Cheile salvate în cont, pe pagina „Chei SSH” (Cheile SSH din cont (blackbox.md)), și cheile instalate pe un server, în /root/.ssh/authorized_keys (Adăugarea și ștergerea cheilor SSH pe server), se gestionează cu unelte diferite. Ștergerea dintr-un loc nu scoate cheia din celălalt.

Protecții împotriva blocării accesului:

• remove_server_ssh_key refuză cheia de administrare (management_key_protected) și ultima cheie a unui server „Doar cheie” (last_key_on_key_only_server).
• set_server_password_auth refuză dezactivarea dacă pe server nu există nicio cheie a dvs. (no_customer_key_installed).

Bani: comenzi, plăți și anulări

Cele trei unelte cer orders:write. Plățile și rambursările trec doar prin sold: asistentul nu poate alimenta soldul și nu poate plăti cu cardul.

Regulile de rambursare sunt aceleași ca pe site: Anularea comenzii și rambursări. Pașii și protecțiile: Comenzi, plăți, anulări și upgrade prin AI.

Ireversibil Cu confirm: true, cancel_order șterge imediat serverul comenzii și toate datele de pe el, fără perioada de grație de 24 de ore a butonului „Șterge definitiv” din panou. Citiți previzualizarea înainte de a confirma.

Parametrii pentru create_order

Asistentul construiește parametrii singur; îi puteți cere explicit planul, sistemul de operare și cheile. Exemplu pentru planul recomandat, cu Ubuntu 24.04 și o cheie salvată în cont:

{
  "source": "static-plan",
  "plan_slug": "vm-iops1-m",
  "config": {
    "kind": "static-plan",
    "plan_id": "vm-iops1-m",
    "os": "ubuntu-24",
    "ssh": { "key_ids": ["ID_CHEIE"] }
  },
  "confirm": false
}

Valorile posibile pentru plan_slug (aceeași valoare se pune și în config.plan_id) sunt mai jos. Planurile VPS au forma vm-FAMILIE-MĂRIME:

Câmpurile din config:

Atenție Puneți în extras doar monitoring. Serverul MCP acceptă și alte coduri de servicii suplimentare și le adaugă la total și la prețul lunar al serverului, dar ele nu se activează automat: în „Contul meu” → „Comenzi” rămân „În curs de activare”. Nu cereți asistentului să adauge în comandă alte servicii suplimentare; pentru ele scrieți suportului. Înainte de confirmare verificați total_mdl din ofertă: trebuie să fie prețul planului, plus 98 MDL dacă ați cerut monitorizarea. Oferta are o singură linie în line_items, cu totalul, deci serviciile nu apar separat.

Configuratorul personalizat (source: configurator) și planurile vechi vps-2, vps-3, vps-4 au fost înlocuite cu planurile fixe: ele răspund configurator_retired, respectiv plan_retired. Pentru un plan vechi, eroarea poate propune un plan vm-… apropiat. Dacă oferta arată provisionable: false, planul este temporar indisponibil, iar confirmarea răspunde plan_unavailable.

Întrebări frecvente

Asistentul spune că nu are o anumită unealtă. De ce? Token-ul nu are permisiunea cerută, așa că unealta este ascunsă. Cereți asistentului să apeleze whoami: câmpul missing_scopes arată ce lipsește. Creați apoi un token nou cu permisiunea respectivă. În textul hint, presetarea apare ca „AI agent — full access”; pe pagină, butonul se numește „AI-administrator — acces complet”.

De ce status este active deși serverul este oprit? status arată doar că serverul este activ în contul dvs. Dacă serverul este pornit sau oprit vedeți în câmpul power_state din get_server.

Pot apela uneltele fără un asistent AI? Da, din orice client MCP sau din cod, dar numai prin adresa MCP: token-urile bbx_pat_… nu funcționează în alte locuri. Vedeți Folosirea MCP din cod (API-uri AI și HTTP).

Ce înseamnă 57800 în balance_bani? Suma este în bani: 57 800 de bani înseamnă 578,00 MDL.