Upravljanje Restormom putem MCP-a

Restorm izlaže MCP poslužitelj (Model Context Protocol). AI agent — Claude Code, Cursor ili bilo koji MCP klijent — može dakle čitati vaš projekt, stvarati i izvoditi zahtjeve te upravljati sučeljem.

To omogućuje da zatražite „uvezi ovaj Swagger, izradi scenarij koji testira tijek narudžbe i pokreni ga” i dobijete provjerljiv rezultat, u aplikaciji koju držite pred očima.

Aktivacija

Poslužitelj je uključen prema zadanome. Dvije razine upravljanja:

• postavka Postavke ▸ MCP ▸ Omogući MCP poslužitelj;
• apsolutno pravilo: na računalu bez zaslona MCP poslužitelj se nikada ne pokreće, bez obzira na postavku. CI poslužitelj se dakle ne zatječe u položaju da izlaže ulaznu točku.

MCP pokazatelj u traci stanja trepće pri svakom dolaznom pozivu. Njegov skočni prozorčić omogućuje privremeno zaustavljanje ili nastavak rada poslužitelja za tu sjednicu te otvaranje MCP zapisa.

Povezivanje vašeg AI asistenta

Pri pokretanju Restorm bira slobodan port, generira pristupni token svojstven procesu i zapisuje datoteku za otkrivanje u privremeni direktorij sustava. JSON-RPC poslužitelj sluša na 127.0.0.1:<port>/mcp — samo na lokalnoj petlji: svaki vanjski pozivatelj dobiva 403.

Taj port ni token nikada ne kopirate sami. Mali pokretač premošćuje standardni ulaz i izlaz vašeg MCP klijenta i Restormov HTTP poslužitelj: pronalazi pokrenutu instancu, ubacuje token i prosljeđ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 popis alata čim prođe prvi poziv. Nikada tiho ne pokreće Restorm: instanca kojoj ste isključili MCP poslužitelj ostaje isključena, uz jasnu poruku o pogrešci.

Što omogućuje povezivanje AI-ja

Povezivanje asistenta s Restormom daje mu potpuni pristup vašim Restorm alatima u vaše ime — izvršavanje zahtjeva prema stvarnim odredištima, čitanje i pisanje vašeg projekta te (u Pro izdanju) alate za automatizaciju i git. Zahtjevi koriste vaše razriješene tajne, jednako kao kad sami upravljate Restormom. Token za otkrivanje svojstven je instanci i može ga čitati samo vaš lokalni korisnik. Povezujte samo asistente kojima vjerujete i držite uključenima upite za odobrenje vašeg MCP klijenta.

Najjednostavnije — iz aplikacije

Najbrži put ne zahtijeva nikakvu ručnu konfiguraciju. Otvorite skočni prozorčić MCP pokazatelja (traka stanja) i kliknite „Dodaj Restorm svojem AI agentu”. Dijaloški okvir prikazuje, klijent po klijent, jedini redak koji treba kopirati:

• Claude Code — naredba claude mcp add …, uz gumb „Dodaj u Claude Code” koji je izvodi umjesto vas kada je alat claude pronađen u vašem PATH-u;
• Claude Desktop i Cursor — blok mcpServers za lijepljenje, zajedno s lokacijom konfiguracijske datoteke.

Restorm nikada ne zapisuje konfiguracijsku datoteku druge aplikacije: gumb za pokretanje upravlja isključivo vašim vlastitim claude CLI-jem. Za ostale klijente isječak lijepite sami.

Plugin za Claude Code

Claude Code može Restorm instalirati i kao plugin, s našeg vlastitog marketplacea:

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

Plugin registrira MCP poslužitelj restorm (oslanja se na npx -y restorm-mcp) — ništa se drugo ne treba postavljati.

Ručna konfiguracija

Radije sami pišete konfiguraciju — ili koristite drugog klijenta? Opcije u nastavku pokrivaju svaki slučaj.

Preduvjeti

• MCP poslužitelj je omogućen — po zadanome je uključen (Postavke ▸ MCP). Na stroju bez zaslona nikada se ne pokreće, što god postavka govorila.
• Instanca Restorma je pokrenuta — pokretač se povezuje na vašu pokrenutu aplikaciju, ne pokreće je sam.
• Node.js ≥ 18 za npx metodu u nastavku.

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

Bez instalacije, bez putanje za održavanje, radi s bilo kojim klijentom i na svakom OS-u. Usmjerite svojeg klijenta na nju:

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

Gdje taj isječak ide ovisi o vašem klijentu:

• Claude Desktop — Postavke ▸ Razvojni programer ▸ Uredi konfiguraciju, ili datoteka claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Postavke ▸ 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 nasljeđuju PATH vašeg terminala. Ako node nije instaliran na standardnoj lokaciji, klijent ne uspijeva pokrenuti poslužitelj i prijavljuje env: node: No such file or directory — čak i s apsolutnom putanjom do npx-a, jer npx ponovno pokreće node putem PATH-a. Najpouzdanije je rješenje Opcija B u nastavku: usmjerite node — s apsolutnom putanjom ako je potrebno — izravno na priloženi pokretač, zaobilazeći npx.

Opcija B — pokretač priložen u aplikaciji (bez npm-a)

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

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

<path-to> je direktorij 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 — izravni HTTP

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

Gdje pokretač traži

Pokretač i aplikacija moraju se složiti oko direktorija za otkrivanje. Oba po zadanome koriste restorm-mcp unutar privremenog direktorija sustava; ako postavite varijablu okruženja RESTORM_MCP_DIR, dodijelite joj istu vrijednost na objema stranama (potrebno samo ako Restorm radi pod upraviteljem usluga s drugačijim privremenim direktorijem).

Više instanci

Više Restorma može raditi usporedo. Svaki poziv prihvaća rezervirani ključ __session za označavanje ciljane instance. Sliku dopunjuju alati list-instances, create_instance i terminate_instance.

Obitelji alata

Čitanje · navigacija · projekt · pisanje · okruženja i tajne · uvoz · izvođenje · scenariji · instance · automatizacija sučelja (snimka zaslona, DOM upit, unos, prečaci, teme, raspored).

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

Potpun popis: MCP alati.

Što je besplatno, a što je Pro

Sam MCP poslužitelj nikada nije ograničen. Svaki alat pri pozivu provjerava vlastitu mogućnost.

• Izdanje Community — cjelokupno upravljanje zahtjevima: izvođenje, otkazivanje, čitanje odgovora i povijesti, čitanje tokova, slanje poruka, uvoz s URL-a, otvaranje i zatvaranje kartica, upravljanje projektima, pisanje u stablo, upravljanje okruženjima i varijablama, brze postavke, favoriti i šest alata vatrozida.
• Izdanje Pro — područje scenarija (uključujući čitanje), snimke, cjelokupna automatizacija sučelja, teme, mini preglednik, raspored workbencha, više instanci i git alati.

Ograničen alat ostaje na popisu — njegov natpis nosi sufiks (Restorm Pro) — i vraća izričitu pogrešku čitljivu stroju umjesto da nestane.

Sigurnost

• Lokalna petlja i token: poslužitelj sluša samo na 127.0.0.1, a token se uspoređuje u konstantnom vremenu.
• Tajne: agent prima razriješenu vrijednost tajne, jednako kao i ostatak aplikacije — on upravlja Restormom u vaše ime, nad vašim vlastitim tajnama. Ono što tip Tajna jamči ostaje istinito: vrijednost ne odlazi ni u projekt, ni u izvoz, ni prema neovlaštenoj usluzi treće strane.
• Stvarni mrežni učinci: run_request doista poziva odredište. Ulogu zaštitne ograde igra tijek odobravanja vašeg MCP klijenta — držite ga uključenim.
• Vatrozid vrijedi: poziv koji agent pokrene prema nepoznatom podrijetlu izaziva isti zahtjev za odobrenjem kao i vaš.
• Bilježenje: svaki se poziv pojavljuje u MCP zapisima, sa svojim zahtjevom i svojim odgovorom.