Controlul Restorm prin MCP

Restorm expune un server MCP (Model Context Protocol). Un agent IA — Claude Code, Cursor sau orice client MCP — poate deci citi proiectul dumneavoastră, crea și executa cereri și controla interfața.

Este ceea ce permite să cereți „importă acest Swagger, creează un scenariu care testează parcursul de comandă și lansează-l” și să obțineți un rezultat verificabil, într-o aplicație pe care o păstrați sub ochi.

Activare

Serverul este activat implicit. Două mecanisme de guvernanță:

• setarea Setări ▸ MCP ▸ Activează serverul MCP;
• o regulă absolută: pe o mașină fără afișaj, serverul MCP nu pornește niciodată, oricare ar fi setarea. Un server de CI nu ajunge deci să expună un punct de intrare.

Indicatorul MCP din bara de stare clipește la fiecare apel sosit. Popoverul său permite suspendarea sau reluarea serverului pentru sesiune și deschiderea jurnalelor MCP.

Conectarea asistentului dumneavoastră IA

La pornire, Restorm alege un port liber, generează un token de acces propriu procesului și scrie un fișier de descoperire în directorul temporar al sistemului. Serverul JSON-RPC ascultă pe 127.0.0.1:<port>/mcp — numai pe bucla locală: orice apelant din exterior primește un 403.

Nu copiați niciodată dumneavoastră acel port sau acel token. Un mic lansator face puntea între intrarea și ieșirea standard ale clientului dumneavoastră MCP și serverul HTTP al Restorm: găsește instanța în curs, injectează tokenul și transmite apelurile dumneavoastră. Răspunde instantaneu la initialize și tools/list dintr-un manifest încorporat, astfel încât clientul dumneavoastră pornește repede, fără să aștepte pornirea Restorm — apoi servește lista reală de instrumente de îndată ce trece un apel. Nu pornește niciodată Restorm în tăcere: o instanță al cărei server MCP l-ați oprit rămâne oprită, cu un mesaj de eroare clar.

Ce permite conectarea unei IA

Conectarea unui asistent la Restorm îi acordă acces complet la instrumentele dumneavoastră Restorm în numele dumneavoastră — executarea de cereri către ținte reale, citirea și scrierea proiectului dumneavoastră și (în Pro) instrumentele de automatizare și de git. Cererile folosesc secretele dumneavoastră rezolvate, exact ca atunci când conduceți Restorm dumneavoastră înșivă. Tokenul de descoperire este propriu instanței și poate fi citit doar de utilizatorul dumneavoastră local. Conectați doar asistenți în care aveți încredere și păstrați active solicitările de aprobare ale clientului dumneavoastră MCP.

Cel mai simplu — din aplicație

Calea cea mai rapidă nu necesită nicio configurare manuală. Deschideți popoverul indicatorului MCP (bara de stare) și faceți clic pe „Adăugați Restorm la agentul dumneavoastră IA”. O fereastră prezintă, client cu client, singura linie de copiat:

• Claude Code — comanda claude mcp add …, însoțită de un buton „Adaugă la Claude Code” care o execută în locul dumneavoastră atunci când instrumentul claude este detectat în PATH-ul dumneavoastră;
• Claude Desktop și Cursor — blocul mcpServers de lipit, împreună cu amplasarea fișierului de configurare.

Restorm nu scrie niciodată fișierul de configurare al altei aplicații: butonul de execuție conduce doar propriul dumneavoastră CLI claude. Pentru ceilalți clienți, lipiți fragmentul dumneavoastră înșivă.

Pluginul Claude Code

Claude Code poate de asemenea instala Restorm ca plugin, din propriul nostru marketplace:

/plugin marketplace add Monsieur-Dev/restorm
/plugin install restorm@restorm-marketplace

Pluginul înregistrează serverul MCP restorm (se bazează pe npx -y restorm-mcp) — nimic altceva de configurat.

Configurarea manuală

Preferați să scrieți configurația dumneavoastră înșivă — sau folosiți alt client? Opțiunile de mai jos acoperă toate cazurile.

Cerințe prealabile

• Serverul MCP este activat — este activat în mod implicit (Setări ▸ MCP). Pe o mașină fără afișaj, nu pornește niciodată, indiferent ce spune setarea.
• O instanță Restorm este în execuție — lansatorul se conectează la aplicația dumneavoastră în execuție, nu creează una.
• Node.js ≥ 18 pentru metoda npx de mai jos.

Varianta A — npx restorm-mcp (recomandată)

Fără instalare, fără cale de gestionat, funcționează cu orice client și pe orice sistem de operare. Îndreptați-vă clientul spre ea:

{
  "mcpServers": {
    "restorm": {
      "command": "npx",
      "args": ["-y", "restorm-mcp"]
    }
  }
}

Unde ajunge acest fragment depinde de clientul dumneavoastră:

• Claude Desktop — Setări ▸ Dezvoltator ▸ Editează configurația, sau fișierul claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Setări ▸ MCP ▸ Adaugă, sau ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, sau un .mcp.json în proiectul dumneavoastră.

macOS: node negăsit dintr-o aplicație GUI

Pe macOS, aplicațiile GUI (Claude Desktop, Cursor…) nu moștenesc variabila PATH a terminalului dumneavoastră. Dacă node nu este instalat într-o locație standard, clientul nu reușește să pornească serverul și eșuează cu env: node: No such file or directory — chiar și cu o cale absolută către npx, deoarece npx relansează node prin PATH. Soluția cea mai fiabilă este Varianta B de mai jos: îndreptați node — cu o cale absolută dacă este necesar — direct spre lansatorul livrat împreună cu aplicația, ocolind npx.

Varianta B — lansatorul livrat împreună cu aplicația (fără npm)

Fiecare instalare Restorm livrează același lansator ca resursă inclusă, astfel încât puteți îndrepta node direct spre el, fără npm:

{
  "mcpServers": {
    "restorm": {
      "command": "node",
      "args": ["<path-to>/restorm-resources/mcp-launcher.mjs"]
    }
  }
}

<path-to> este directorul de resurse al aplicației:

• macOS — /Applications/Restorm.app/Contents/Resources/restorm-resources/mcp-launcher.mjs
• Windows — %LOCALAPPDATA%\Programs\restorm\resources\restorm-resources\mcp-launcher.mjs
• Linux — /opt/Restorm/resources/restorm-resources/mcp-launcher.mjs (.deb/.rpm); în interiorul imaginii montate pentru un AppImage; $SNAP/resources/restorm-resources/mcp-launcher.mjs pentru Snap.

Varianta C — HTTP direct

Citiți portul și tokenul din fișierul de descoperire, apoi trimiteți cererile JSON-RPC cu un antet Authorization: Bearer <token>.

Unde caută lansatorul

Lansatorul și aplicația trebuie să convină asupra directorului de descoperire. Ambele folosesc în mod implicit restorm-mcp sub directorul temporar al sistemului; dacă setați variabila de mediu RESTORM_MCP_DIR, dați-i aceeași valoare pe ambele părți (necesar doar dacă Restorm rulează sub un gestionar de servicii cu un director temporar diferit).

Mai multe instanțe

Mai multe instanțe Restorm pot rula în paralel. Fiecare apel acceptă o cheie rezervată __session pentru a desemna instanța vizată. Instrumentele list-instances, create_instance și terminate_instance completează tabloul.

Familiile de instrumente

Citire · navigare · proiect · scriere · medii și secrete · import · execuție · scenarii · instanțe · automatizarea interfeței (captură de ecran, interogare DOM, introducere de text, scurtături, teme, dispunere).

Sunt expuse de asemenea patru resurse: restorm://project, restorm://tree, restorm://active-tab și restorm://request/{id}.

Inventar complet: Instrumente MCP.

Ce este gratuit și ce este Pro

Serverul MCP în sine nu este niciodată restricționat. Fiecare instrument își verifică propria capacitate în momentul apelului.

• Ediția Community — tot controlul cererilor: executare, anulare, citirea răspunsurilor și a istoricului, citirea fluxurilor, trimiterea de mesaje, importul de la un URL, deschiderea și închiderea filelor, gestionarea proiectelor, scrierea în arbore, gestionarea mediilor și a variabilelor, a setărilor rapide, a favoritelor, precum și cele șase instrumente de firewall.
• Ediția Pro — domeniul scenarii (inclusiv la citire), capturile, toată automatizarea interfeței, temele, mini browserul, dispunerea workbench-ului, instanțele multiple și instrumentele git.

Un instrument restricționat rămâne listat — denumirea sa poartă sufixul (Restorm Pro) — și returnează o eroare explicită și lizibilă pentru mașină, în loc să dispară.

Securitate

• Buclă locală și token: serverul ascultă numai pe 127.0.0.1, iar tokenul este comparat în timp constant.
• Secrete: un agent primește valoarea rezolvată a unui secret, la fel ca restul aplicației — el pilotează Restorm în numele dumneavoastră, cu propriile dumneavoastră secrete. Ceea ce garantează tipul Secret rămâne adevărat: valoarea nu pleacă nici în proiect, nici într-un export, nici spre un serviciu terț neautorizat.
• Efecte de rețea reale: run_request apelează cu adevărat ținta. Fluxul de aprobare al clientului dumneavoastră MCP este cel care joacă rolul de parapet — păstrați-l activ.
• Firewallul se aplică: un apel declanșat de un agent către o origine necunoscută provoacă aceeași cerere de autorizare ca și al dumneavoastră.
• Jurnalizare: fiecare apel apare în jurnalele MCP, cu cererea și răspunsul său.