Pilotimi i Restorm përmes MCP

Restorm ekspozon një server MCP (Model Context Protocol). Një agjent IA — Claude Code, Cursor, ose çdo klient MCP — mund pra ta lexojë projektin tuaj, të krijojë dhe të ekzekutojë kërkesa, dhe të pilotojë ndërfaqen.

Kjo është ajo që lejon të kërkoni «importo këtë Swagger, krijo një skenar që teston rrugën e porosisë dhe nise atë» dhe të merrni një rezultat të verifikueshëm, brenda një aplikacioni që e mbani para syve.

Aktivizimi

Serveri është i aktivizuar si parazgjedhje. Dy drejtime:

• rregullimi Parametrat ▸ MCP ▸ Aktivizo serverin MCP;
• një rregull absolut: mbi një makinë pa ekran, serveri MCP nuk niset kurrë, cilido qoftë rregullimi. Një server CI-je nuk përfundon pra duke ekspozuar një pikë hyrjeje.

Treguesi MCP i shiritit të gjendjes pulson në çdo thirrje hyrëse. Dritarja e tij e vogël lejon të pezullohet ose të rifillohet serveri për sesionin dhe të hapen regjistrat MCP.

Lidhja e asistentit tuaj IA

Në nisje, Restorm zgjedh një portë të lirë, gjeneron një token qasjeje specifik për procesin dhe shkruan një skedar zbulimi brenda drejtorisë së përkohshme të sistemit. Serveri JSON-RPC dëgjon në 127.0.0.1:<port>/mcp — vetëm në lakun lokal: çdo thirrës i jashtëm merr një 403.

Këtë portë dhe këtë token nuk i kopjoni kurrë vetë. Një nisës i vogël bën urën mes hyrjes dhe daljes standarde të klientit tuaj MCP dhe serverit HTTP të Restorm: gjen instancën në ekzekutim, injekton token-in dhe përcjell thirrjet tuaja. U përgjigjet menjëherë initialize dhe tools/list nga një manifest i integruar, kështu që klienti juaj niset shpejt pa pritur nisjen e Restorm — dhe më pas shërben listën reale të veglave sapo të kalojë një thirrje. Nuk e nis kurrë Restorm në heshtje: një instancë të cilës i keni ndalur serverin MCP mbetet e ndalur, me një mesazh gabimi të qartë.

Çfarë lejon lidhja e një IA-je

Lidhja e një asistenti me Restorm i jep atij qasje të plotë te veglat tuaja Restorm në emrin tuaj — ekzekutimin e kërkesave kundrejt objektivave realë, leximin dhe shkrimin e projektit tuaj dhe (në Pro) veglat e automatizimit dhe të git-it. Kërkesat përdorin sekretet tuaja të zgjidhura, saktësisht si kur e drejtoni vetë Restorm. Token-i i zbulimit është specifik për instancën dhe i lexueshëm vetëm nga përdoruesi juaj lokal. Lidhni vetëm asistentë që u besoni dhe mbajini të ndezura kërkesat për miratim të klientit tuaj MCP.

Mënyra më e thjeshtë — nga aplikacioni

Rruga më e shpejtë nuk kërkon asnjë konfigurim manual. Hapni dritaren e vogël të treguesit MCP (shiriti i gjendjes) dhe klikoni «Shto Restorm te asistenti juaj i IA-së». Një dialog paraqet, klient pas klienti, të vetmin rresht për ta kopjuar:

• Claude Code — komandën claude mcp add …, të shoqëruar me një buton «Shto te Claude Code» që e ekzekuton për ju kur vegla claude zbulohet në PATH-in tuaj;
• Claude Desktop dhe Cursor — blloku mcpServers për ta ngjitur, me vendndodhjen e skedarit të konfigurimit.

Restorm nuk e shkruan kurrë skedarin e konfigurimit të një aplikacioni tjetër: butoni i ekzekutimit drejton vetëm veglën tuaj claude. Për klientët e tjerë, e ngjitni vetë fragmentin.

Shtojca e Claude Code

Claude Code mund ta instalojë gjithashtu Restorm si shtojcë (plugin), nga tregu ynë i vetëstrehuar:

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

Shtojca regjistron serverin MCP restorm (mbështetet në npx -y restorm-mcp) — asgjë tjetër për të rregulluar.

Konfigurimi manual

Preferoni ta shkruani vetë konfigurimin — ose përdorni një klient tjetër? Opsionet e mëposhtme mbulojnë çdo rast.

Parakushtet

• Serveri MCP është aktiv — është i ndezur si parazgjedhje (Parametrat ▸ MCP). Në një makinë pa ekran, nuk niset kurrë, çfarëdo që të thotë parametri.
• Një instancë e Restorm është në ekzekutim — nisësi lidhet me aplikacionin tuaj në ekzekutim, nuk krijon ndonjë të tillë.
• Node.js ≥ 18 për metodën npx më poshtë.

Opsioni A — npx restorm-mcp (i rekomanduar)

Pa instalim, pa shteg për t’u menaxhuar, funksionon me çdo klient dhe në çdo OS. Drejtojeni klientin tuaj drejt tij:

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

Ku shkon ky fragment varet nga klienti juaj:

• Claude Desktop — Parametrat ▸ Zhvillues ▸ Modifiko konfigurimin, ose skedari claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Parametrat ▸ MCP ▸ Shto, ose ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, ose një .mcp.json në projektin tuaj.

macOS: node nuk u gjet nga një aplikacion GUI

Në macOS, aplikacionet GUI (Claude Desktop, Cursor…) nuk e trashëgojnë PATH e terminalit tuaj. Nëse node nuk është i instaluar në një vendndodhje standarde, klienti nuk arrin ta nisë serverin dhe dështon me env: node: No such file or directory — edhe me një shteg absolut drejt npx, sepse npx e rinis node përmes PATH. Zgjidhja më e besueshme është Opsioni B më poshtë: drejtojeni node — me një shteg absolut nëse nevojitet — drejtpërdrejt te nisësi i përfshirë, duke anashkaluar npx.

Opsioni B — nisësi i përfshirë në aplikacion (pa npm)

Çdo instalim i Restorm përfshin të njëjtin nisës si burim i paketuar, kështu që mund ta drejtoni node drejtpërdrejt te ai, pa npm:

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

<path-to> është drejtoria e burimeve të aplikacionit:

• 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); brenda imazhit të montuar për një AppImage; $SNAP/resources/restorm-resources/mcp-launcher.mjs për Snap-in.

Opsioni C — HTTP i drejtpërdrejtë

Lexoni portën dhe token-in brenda skedarit të zbulimit dhe pastaj dërgoni kërkesat tuaja JSON-RPC me një kokë Authorization: Bearer <token>.

Ku kërkon nisësi

Nisësi dhe aplikacioni duhet të pajtohen për drejtorinë e zbulimit. Të dy përdorin si parazgjedhje restorm-mcp nën drejtorinë e përkohshme të sistemit; nëse caktoni variablën e mjedisit RESTORM_MCP_DIR, jepini asaj të njëjtën vlerë në të dy anët (e nevojshme vetëm nëse Restorm ekzekutohet nën një menaxher shërbimesh me një drejtori të përkohshme të ndryshme).

Disa instanca

Disa Restorm mund të punojnë paralelisht. Çdo thirrje pranon një çelës të rezervuar __session për të treguar instancën e synuar. Veglat list-instances, create_instance dhe terminate_instance e plotësojnë tabloen.

Familjet e veglave

Lexim · lundrim · projekt · shkrim · mjedise dhe sekrete · importim · ekzekutim · skenarë · instanca · automatizim i ndërfaqes (pamje ekrani, pyetje DOM, shkrim, shkurtore, tema, paraqitje).

Ekspozohen gjithashtu katër burime: restorm://project, restorm://tree, restorm://active-tab dhe restorm://request/{id}.

Inventari i plotë: Veglat MCP.

Çfarë është falas dhe çfarë është Pro

Vetë serveri MCP nuk kufizohet kurrë. Çdo vegël e verifikon aftësinë e vet në çastin e thirrjes.

• Botimi Community — i gjithë pilotimi i kërkesave: ekzekutimi, anulimi, leximi i përgjigjeve dhe i historikut, leximi i flukseve, dërgimi i mesazheve, importimi nga një URL, hapja dhe mbyllja e skedave, menaxhimi i projekteve, shkrimi brenda pemës, menaxhimi i mjediseve dhe i variablave, cilësimet e shpejta, të preferuarat dhe gjashtë veglat e murit të zjarrit.
• Botimi Pro — fusha e skenarëve (edhe në lexim), pamjet e ekranit, i gjithë automatizimi i ndërfaqes, temat, mini-shfletuesi, paraqitja e workbench-it, instancat e shumëfishta dhe veglat git.

Një vegël e kufizuar mbetet e renditur — titulli i saj mban prapashtesën (Restorm Pro) — dhe kthen një gabim të qartë e të lexueshëm nga makina, në vend që të zhduket.

Siguria

• Laku lokal dhe token-i: serveri dëgjon vetëm në 127.0.0.1 dhe token-i krahasohet në kohë konstante.
• Sekretet: një agjent merr vlerën e zgjidhur të një sekreti, njësoj si pjesa tjetër e aplikacionit — ai e piloton Restorm në emrin tuaj, mbi sekretet tuaja. Ajo që garanton tipi Sekret mbetet e vërtetë: vlera nuk shkon as në projekt, as në një eksport, as drejt një shërbimi të paautorizuar të palës së tretë.
• Efekte reale në rrjet: run_request e thërret vërtet cakun. Është fluksi i miratimit i klientit tuaj MCP ai që luan rolin e mbrojtësit — mbajeni aktiv.
• Muri i zjarrit zbatohet: një thirrje e nisur nga një agjent drejt një origjine të panjohur shkakton të njëjtën kërkesë autorizimi si e juaja.
• Regjistrimi: çdo thirrje shfaqet brenda regjistrave MCP, me kërkesën dhe përgjigjen e vet.