Upravljanje Restormom preko MCP-a

Restorm izlaže MCP server (Model Context Protocol). AI agent — Claude Code, Cursor ili bilo koji MCP klijent — može dakle da čita vaš projekat, pravi i izvršava zahteve i upravlja interfejsom.

To je ono što omogućava da zatražite „uvezi ovaj Swagger, napravi scenario koji testira tok naručivanja i pokreni ga” i da dobijete proverljiv rezultat, u aplikaciji koju držite pred očima.

Uključivanje

Server je podrazumevano uključen. Dva nivoa upravljanja:

• podešavanje Podešavanja ▸ MCP ▸ Omogući MCP server;
• apsolutno pravilo: na mašini bez ekrana MCP server se nikada ne pokreće, bez obzira na podešavanje. CI server se dakle ne zatiče u situaciji da izlaže ulaznu tačku.

MCP indikator u statusnoj traci trepće pri svakom dolaznom pozivu. Njegov popover omogućava da server privremeno zaustavite ili nastavite za tu sesiju i da otvorite MCP zapise.

Povezivanje vašeg AI asistenta

Pri pokretanju Restorm bira slobodan port, generiše pristupni token svojstven procesu i upisuje datoteku za otkrivanje u privremeni direktorijum sistema. JSON-RPC server sluša na 127.0.0.1:<port>/mcp — isključivo na lokalnoj petlji: svaki spoljašnji pozivalac dobija 403.

Taj port ni token nikada ne kopirate sami. Mali pokretač premošćava standardni ulaz i izlaz vašeg MCP klijenta i Restorm HTTP server: pronalazi pokrenutu instancu, ubacuje token i prosleđuje vaše pozive. Na initialize i tools/list odgovara odmah iz ugrađenog manifesta, pa se vaš klijent pokreće brzo bez čekanja da se Restorm podigne — a zatim poslužuje živi spisak alata čim prođe prvi poziv. Nikada tiho ne pokreće Restorm: instanca kojoj ste isključili MCP server ostaje isključena, uz jasnu poruku o grešci.

Šta omogućava povezivanje AI-ja

Povezivanje asistenta sa Restormom daje mu potpun pristup vašim Restorm alatima u vaše ime — izvršavanje zahteva prema stvarnim odredištima, čitanje i pisanje vašeg projekta i (u Pro izdanju) alate za automatizaciju i git. Zahtevi koriste vaše razrešene tajne, isto kao kada sami upravljate Restormom. Token za otkrivanje svojstven je instanci i može ga čitati samo vaš lokalni korisnik. Povezujte samo asistente kojima verujete i držite uključenim upite za odobrenje vašeg MCP klijenta.

Najlakši način — iz aplikacije

Najbrži put ne zahteva nikakvo ručno podešavanje. Otvorite popover MCP indikatora (statusna traka) i kliknite na „Dodaj Restorm u svog AI asistenta”. Dijalog prikazuje, klijent po klijent, jedini red za kopiranje:

• Claude Code — komandu claude mcp add …, uparenu sa dugmetom „Dodaj u Claude Code” koje je izvršava umesto vas kada se alat claude otkrije na vašem PATH-u;
• Claude Desktop i Cursor — blok mcpServers za lepljenje, sa lokacijom datoteke konfiguracije.

Restorm nikada ne upisuje datoteku konfiguracije druge aplikacije: dugme za izvršavanje upravlja samo vašim sopstvenim alatom claude. Za ostale klijente, isečak lepite sami.

Dodatak za Claude Code

Claude Code može i da instalira Restorm kao dodatak (plugin), sa našeg samostalno hostovanog tržišta:

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

Dodatak registruje MCP server restorm (oslanja se na npx -y restorm-mcp) — ništa drugo ne treba podešavati.

Ručno podešavanje

Više volite da sami napišete konfiguraciju — ili koristite drugog klijenta? Opcije ispod pokrivaju svaki slučaj.

Preduslovi

• MCP server je omogućen — podrazumevano je uključen (Podešavanja ▸ MCP). Na mašini bez ekrana nikada se ne pokreće, šta god podešavanje govorilo.
• Instanca Restorma je pokrenuta — pokretač se povezuje na vašu pokrenutu aplikaciju, ne pokreće je sam.
• Node.js ≥ 18 za npx metod ispod.

Opcija A — npx restorm-mcp (preporučeno)

Bez instalacije, bez putanje za održavanje, radi sa bilo kojim klijentom i na svakom OS-u. Usmerite svog klijenta na nju:

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

Gde ovaj isečak ide zavisi od vašeg klijenta:

• Claude Desktop — Podešavanja ▸ Programer ▸ Izmeni konfiguraciju, ili datoteka claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Podešavanja ▸ MCP ▸ Dodaj, ili ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, ili .mcp.json u vašem projektu.

macOS: node nije pronađen iz GUI aplikacije

Na macOS-u, GUI aplikacije (Claude Desktop, Cursor…) ne nasleđuju PATH vašeg terminala. Ako node nije instaliran na standardnoj lokaciji, klijent ne uspeva da pokrene server i javlja env: node: No such file or directory — čak i sa apsolutnom putanjom do npx, jer npx ponovo pokreće node preko PATH-a. Najpouzdanije rešenje je Opcija B ispod: usmerite node — sa apsolutnom putanjom ako je potrebno — pravo na priloženi pokretač, zaobilazeći npx.

Opcija B — pokretač priložen uz aplikaciju (bez npm-a)

Svaka instalacija Restorma isporučuje isti pokretač kao priloženi resurs, pa node možete usmeriti pravo na njega, bez npm-a:

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

<path-to> je direktorijum resursa aplikacije:

• 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); unutar montirane slike za AppImage; $SNAP/resources/restorm-resources/mcp-launcher.mjs za Snap.

Opcija C — direktan HTTP

Pročitajte port i token iz datoteke za otkrivanje, pa šaljite svoje JSON-RPC zahteve sa zaglavljem Authorization: Bearer <token>.

Gde pokretač traži

Pokretač i aplikacija moraju se složiti oko direktorijuma za otkrivanje. Oba podrazumevano koriste restorm-mcp unutar privremenog direktorijuma sistema; ako postavite promenljivu okruženja RESTORM_MCP_DIR, dodelite joj istu vrednost na obe strane (potrebno samo ako Restorm radi pod upraviteljem servisa sa drugačijim privremenim direktorijumom).

Više instanci

Više Restorma može da radi uporedo. Svaki poziv prihvata rezervisani ključ __session za označavanje ciljane instance. Sliku upotpunjuju alati list-instances, create_instance i terminate_instance.

Porodice alata

Čitanje · navigacija · projekat · pisanje · okruženja i tajne · uvoz · izvršavanje · scenariji · instance · automatizacija interfejsa (snimak ekrana, DOM upit, unos, prečice, teme, raspored).

Izložene su i četiri resursa: restorm://project, restorm://tree, restorm://active-tab i restorm://request/{id}.

Kompletan popis: MCP alati.

Šta je besplatno, a šta je Pro

Sam MCP server nikada nije ograničen. Svaki alat proverava svoju mogućnost u trenutku poziva.

• Izdanje Community — sve upravljanje zahtevima: izvršavanje, otkazivanje, čitanje odgovora i istorije, čitanje tokova, slanje poruka, uvoz sa URL-a, otvaranje i zatvaranje kartica, upravljanje projektima, pisanje u stablo, upravljanje okruženjima i promenljivama, brza podešavanja, omiljene stavke i šest alata zaštitnog zida.
• Izdanje Pro — oblast scenarija (uključujući i čitanje), snimci, cela automatizacija interfejsa, teme, mini pregledač, raspored workbencha, više instanci i git alati.

Ograničen alat ostaje na listi — njegov natpis nosi sufiks (Restorm Pro) — i vraća izričitu grešku čitljivu i za mašinu, umesto da nestane.

Bezbednost

• Lokalna petlja i token: server sluša samo na 127.0.0.1, a token se poredi u konstantnom vremenu.
• Tajne: agent dobija razrešenu vrednost tajne, isto kao i ostatak aplikacije — on upravlja Restormom u vaše ime, nad vašim sopstvenim tajnama. Ono što tip Tajna jemči ostaje tačno: vrednost ne odlazi ni u projekat, ni u izvoz, ni ka neovlašćenoj usluzi treće strane.
• Stvarni mrežni efekti: run_request zaista poziva cilj. Ulogu zaštitne ograde igra tok odobravanja vašeg MCP klijenta — držite ga aktivnim.
• Zaštitni zid se primenjuje: poziv koji agent pokrene ka nepoznatom poreklu izaziva isti zahtev za odobrenje kao i vaš.
• Beleženje: svaki poziv pojavljuje se u MCP zapisima, sa svojim zahtevom i svojim odgovorom.