A Restorm vezérlése MCP-n keresztül

A Restorm közzétesz egy MCP-kiszolgálót (Model Context Protocol). Egy AI-ügynök — a Claude Code, a Cursor vagy bármelyik MCP-kliens — így képes beolvasni a projektet, kéréseket létrehozni és futtatni, és a felületet vezérelni.

Ez teszi lehetővé az olyan kérést, hogy „importálja ezt a Swaggert, készítsen egy forgatókönyvet, amely leteszteli a megrendelési folyamatot, majd futtassa le”, és hogy az eredmény ellenőrizhető legyen, egy szem előtt tartott alkalmazásban.

Engedélyezés

A kiszolgáló alapértelmezés szerint be van kapcsolva. Két szabályozó elem van:

• a Beállítások ▸ MCP ▸ MCP szerver engedélyezése beállítás;
• egy kivételt nem ismerő szabály: kijelző nélküli gépen az MCP-kiszolgáló soha nem indul el, függetlenül a beállítástól. Egy CI-kiszolgáló így nem kerül abba a helyzetbe, hogy belépési pontot tesz közzé.

Az állapotsor MCP-jelzője minden beérkező híváskor felvillan. A hozzá tartozó popover lehetővé teszi a kiszolgáló felfüggesztését vagy folytatását a munkamenet idejére, valamint az MCP-naplók megnyitását.

Az MI-asszisztens csatlakoztatása

Indításkor a Restorm szabad portot választ, a folyamathoz tartozó hozzáférési tokent generál, és felderítési fájlt ír a rendszer ideiglenes könyvtárába. A JSON-RPC kiszolgáló a 127.0.0.1:<port>/mcp címen figyel — kizárólag a helyi hurkon: bármely külső hívó 403 választ kap.

Ezt a portot és tokent soha nem másolja ki saját maga. Egy kis indító hidat képez az MCP-kliens szabványos be- és kimenete és a Restorm HTTP-kiszolgálója között: megkeresi a futó példányt, beinjektálja a tokent és továbbítja a hívásait. Az initialize és a tools/list kérésre azonnal válaszol egy beépített jegyzékből, így a kliense gyorsan elindul anélkül, hogy megvárná a Restorm elindulását — majd az élő eszközlistát szolgálja ki, amint az első hívás átmegy. Soha nem indítja el csendben a Restormot: az a példány, amelyben az MCP-kiszolgáló ki van kapcsolva, kikapcsolva marad, világos hibaüzenettel.

Mit ad meg egy MI csatlakoztatása

Egy asszisztens Restormhoz csatlakoztatása teljes hozzáférést ad neki a Restorm-eszközeihez az Ön nevében — kérések futtatását valós célpontok ellen, a projekt olvasását és írását, valamint (Pro-ban) az automatizálási és git-eszközöket. A kérések a feloldott titkait használják, pontosan úgy, mint amikor Ön maga vezérli a Restormot. A felderítési token példányhoz kötött, és csak a helyi felhasználója olvashatja. Csak megbízható asszisztenseket csatlakoztasson, és hagyja bekapcsolva az MCP-kliens jóváhagyási kérdéseit.

A legegyszerűbb út — az alkalmazásból

A leggyorsabb út nem igényel semmilyen kézi konfigurálást. Nyissa meg az MCP-jelző popoverét (állapotsor), és kattintson a „Restorm hozzáadása az MI-asszisztenséhez” gombra. Egy párbeszédablak kliensenként bemutatja azt az egyetlen sort, amelyet ki kell másolnia:

• Claude Code — a claude mcp add … parancs, egy „Hozzáadás a Claude Code-hoz” gombbal párosítva, amely lefuttatja Ön helyett, ha a claude CLI megtalálható a PATH-ban;
• Claude Desktop és Cursor — a beillesztendő mcpServers blokk, a konfigurációs fájl helyével együtt.

A Restorm soha nem írja egy másik alkalmazás konfigurációs fájlját: a futtatás gomb csak az Ön saját claude CLI-jét vezérli. A többi kliensnél a részletet Ön maga illeszti be.

A Claude Code-bővítmény

A Claude Code a Restormot bővítményként is telepítheti a saját üzemeltetésű piacterünkről:

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

A bővítmény regisztrálja a restorm MCP-kiszolgálót (az npx -y restorm-mcp parancsra támaszkodik) — nincs más beállítanivaló.

Kézi konfigurálás

Inkább saját maga írná meg a konfigurációt — vagy más klienst használ? Az alábbi lehetőségek minden esetet lefednek.

Előfeltételek

• Az MCP-kiszolgáló engedélyezve van — alapból be van kapcsolva (Beállítások ▸ MCP). Kijelző nélküli gépen sosem indul el, bármit is mondjon a beállítás.
• Fut egy Restorm-példány — az indító az Ön futó alkalmazásához csatlakozik, nem indít újat.
• Node.js ≥ 18 az alábbi npx-módszerhez.

A) lehetőség — npx restorm-mcp (ajánlott)

Nincs telepítés, nincs kezelendő elérési út, bármely klienssel és minden operációs rendszeren működik. Irányítsa rá a klienst:

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

Hogy ez a részlet hová kerül, az a kliensétől függ:

• Claude Desktop — Beállítások ▸ Fejlesztő ▸ Konfiguráció szerkesztése, vagy a claude_desktop_config.json fájl (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Beállítások ▸ MCP ▸ Hozzáadás, vagy ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, vagy egy .mcp.json a projektjében.

macOS: a node nem található egy grafikus alkalmazásból

macOS rendszeren a grafikus alkalmazások (Claude Desktop, Cursor…) nem öröklik a terminál PATH értékét. Ha a node nincs szabványos helyre telepítve, a kliens nem tudja elindítani a kiszolgálót, és a következő hibát adja: env: node: No such file or directory — még az npx abszolút elérési útjával is, mivel az npx a PATH alapján újraindítja a node-ot. A legmegbízhatóbb megoldás az alábbi B) lehetőség: irányítsa a node-ot — szükség esetén abszolút elérési úttal — közvetlenül a mellékelt indítóra, megkerülve az npx-et.

B) lehetőség — az alkalmazással szállított indító (npm nélkül)

Minden Restorm-telepítés ugyanazt az indítót szállítja mellékelt erőforrásként, így az node-ot közvetlenül rá irányíthatja, npm nélkül:

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

A <path-to> az alkalmazás erőforrás-könyvtára:

• 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); AppImage esetén a csatolt lemezképen belül; $SNAP/resources/restorm-resources/mcp-launcher.mjs a Snaphez.

C) lehetőség — közvetlen HTTP

Olvassa ki a portot és a tokent a felderítési fájlból, majd küldje a JSON-RPC kéréseket egy Authorization: Bearer <token> fejléccel.

Hol keres az indító

Az indítónak és az alkalmazásnak egyet kell értenie a felderítési könyvtárban. Mindkettő alapból a restorm-mcp könyvtárat használja a rendszer ideiglenes könyvtára alatt; ha beállítja a RESTORM_MCP_DIR környezeti változót, adja neki ugyanazt az értéket mindkét oldalon (csak akkor szükséges, ha a Restorm eltérő ideiglenes könyvtárral rendelkező szolgáltatáskezelő alatt fut).

Több példány

Több Restorm is futhat párhuzamosan. Minden hívás elfogad egy fenntartott __session kulcsot a megcélzott példány megjelölésére. A képet a list-instances, a create_instance és a terminate_instance eszköz teszi teljessé.

Az eszközcsaládok

Olvasás · navigáció · projekt · írás · környezetek és titkok · import · futtatás · forgatókönyvek · példányok · a felület automatizálása (képernyőkép, DOM-lekérdezés, beírás, billentyűparancsok, témák, elrendezés).

Négy erőforrás szintén közzé van téve: restorm://project, restorm://tree, restorm://active-tab és restorm://request/{id}.

A teljes jegyzék: MCP-eszközök.

Mi ingyenes és mi Pro

Maga az MCP-kiszolgáló soha nem korlátozott. Minden eszköz a hívás pillanatában ellenőrzi a saját képességét.

• Community kiadás — a kérések teljes vezérlése: futtatás, megszakítás, a válaszok és az előzmények olvasása, folyamok olvasása, üzenetek küldése, importálás URL-ből, lapok megnyitása és bezárása, a projektek kezelése, írás a fába, a környezetek és a változók kezelése, a gyorsbeállítások, a kedvencek és a hat tűzfaleszköz.
• Pro kiadás — a forgatókönyvek területe (az olvasással együtt), a felvételek, a felület teljes automatizálása, a témák, a miniböngésző, a workbench elrendezése, a több példány és a git-eszközök.

A korlátozott eszköz továbbra is szerepel a listában — a megnevezése a (Restorm Pro) utótagot kapja —, és nem tűnik el, hanem beszédes, gép által is olvasható hibát ad vissza.

Biztonság

• Helyi hurok és token: a kiszolgáló csak a 127.0.0.1 címen figyel, a token összehasonlítása pedig állandó időben történik.
• Titkok: az ügynök a titok feloldott értékét kapja meg, ugyanúgy, mint az alkalmazás többi része — a felhasználó nevében, a saját titkaival vezérli a Restormot. Amit a Titok típus garantál, az továbbra is igaz: az érték nem kerül sem a projektbe, sem exportba, sem jogosulatlan külső szolgáltatáshoz.
• Valódi hálózati hatások: a run_request tényleg meghívja a célt. A védőkorlát szerepét az MCP-kliens jóváhagyási folyamata játssza — érdemes bekapcsolva hagyni.
• A tűzfal érvényes: az ügynök által ismeretlen eredet felé kezdeményezett hívás ugyanazt az engedélykérést váltja ki, mint a felhasználó saját hívása.
• Naplózás: minden hívás megjelenik az MCP-naplókban, a kérésével és a válaszával együtt.