Restormin ohjaus MCP:n kautta

Restorm tarjoaa MCP-palvelimen (Model Context Protocol). Tekoälyagentti — Claude Code, Cursor tai mikä tahansa MCP-asiakas — voi siis lukea projektianne, luoda ja suorittaa pyyntöjä sekä ohjata käyttöliittymää.

Juuri tämä tekee mahdolliseksi pyytää ”tuo tämä Swagger, luo skenaario, joka testaa tilauspolun, ja aja se” ja saada todennettava tulos sovelluksessa, joka pysyy koko ajan silmienne edessä.

Käyttöönotto

Palvelin on oletuksena käytössä. Sitä hallitaan kahdella tavalla:

• asetuksella Asetukset ▸ MCP ▸ Ota MCP-palvelin käyttöön;
• ehdottomalla säännöllä: näytöttömällä koneella MCP-palvelin ei käynnisty koskaan, riippumatta asetuksesta. CI-palvelin ei siis päädy avaamaan sisäänpääsypistettä.

Tilapalkin MCP-ilmaisin vilkkuu jokaisella saapuvalla kutsulla. Sen ponnahdusikkunasta voi keskeyttää tai jatkaa palvelinta istunnon ajaksi ja avata MCP-lokit.

Yhdistäkää tekoälyavustajanne

Käynnistyessään Restorm valitsee vapaan portin, luo prosessikohtaisen käyttöoikeustokenin ja kirjoittaa löytötiedoston järjestelmän tilapäishakemistoon. JSON-RPC-palvelin kuuntelee osoitteessa 127.0.0.1:<port>/mcp — vain paikallisessa silmukassa: ulkopuolinen kutsuja saa vastaukseksi 403.

Ette koskaan kopioi tuota porttia tai tokenia itse. Pieni käynnistin siltaa MCP-asiakkaanne vakiosyötteen ja -tulosteen ja Restormin HTTP-palvelimen: se löytää käynnissä olevan instanssin, syöttää tokenin ja välittää kutsunne. Se vastaa initialize- ja tools/list-pyyntöihin heti sisäänrakennetusta manifestista, joten asiakkaanne käynnistyy nopeasti odottamatta Restormin käynnistymistä — ja tarjoaa sitten elävän työkalulistan heti, kun ensimmäinen kutsu menee läpi. Se ei koskaan käynnistä Restormia hiljaisesti: instanssi, jonka MCP-palvelimen olette pysäyttäneet, pysyy pysäytettynä ja antaa selkeän virheilmoituksen.

Mitä tekoälyn yhdistäminen myöntää

Avustajan yhdistäminen Restormiin antaa sille täyden pääsyn Restorm-työkaluihinne teidän puolestanne — pyyntöjen ajamisen oikeisiin kohteisiin, projektinne lukemisen ja kirjoittamisen sekä (Pro-versiossa) automaatio- ja git-työkalut. Pyynnöt käyttävät selvitettyjä salaisuuksianne, aivan kuten silloin kun ohjaatte Restormia itse. Löytötoken on instanssikohtainen ja vain paikallisen käyttäjänne luettavissa. Yhdistäkää vain avustajia, joihin luotatte, ja pitäkää MCP-asiakkaanne hyväksyntäkehotteet päällä.

Helpoin tapa — sovelluksesta

Nopein reitti ei vaadi lainkaan manuaalista määritystä. Avatkaa MCP-ilmaisimen ponnahdusikkuna (tilapalkki) ja napsauttakaa ”Lisää Restorm tekoälyavustajaasi”. Valintaikkuna esittää asiakas asiakkaalta yhden rivin, jonka kopioitte:

• Claude Code — komento claude mcp add … sekä painike ”Lisää Claude Codeen”, joka suorittaa sen puolestanne, kun claude-komentorivityökalu havaitaan PATH-polustanne;
• Claude Desktop ja Cursor — liitettävä mcpServers-lohko sekä asetustiedoston sijainti.

Restorm ei koskaan kirjoita toisen sovelluksen asetustiedostoa: suorituspainike ohjaa vain omaa claude-komentorivityökaluanne. Muille asiakkaille liitätte katkelman itse.

Claude Code -laajennus

Claude Code voi myös asentaa Restormin laajennuksena itse ylläpitämästämme markkinapaikasta:

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

Laajennus rekisteröi restorm-MCP-palvelimen (se nojaa komentoon npx -y restorm-mcp) — mitään muuta ei tarvitse määrittää.

Määritys käsin

Kirjoitatteko mieluummin määrityksen itse — vai käytättekö toista asiakasta? Alla olevat vaihtoehdot kattavat kaikki tapaukset.

Edellytykset

• MCP-palvelin on käytössä — se on oletuksena päällä (Asetukset ▸ MCP). Ilman näyttöä olevalla koneella se ei koskaan käynnisty, riippumatta asetuksesta.
• Restorm-instanssi on käynnissä — käynnistin yhdistää teidän käynnissä olevaan sovellukseenne, se ei käynnistä sellaista itse.
• Node.js ≥ 18 alla olevaa npx-menetelmää varten.

Vaihtoehto A — npx restorm-mcp (suositeltu)

Ei asennusta, ei hallittavaa polkua, toimii minkä tahansa asiakkaan kanssa ja kaikilla käyttöjärjestelmillä. Osoittakaa asiakkaanne siihen:

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

Mihin tuo katkelma kuuluu, riippuu asiakkaastanne:

• Claude Desktop — Asetukset ▸ Kehittäjä ▸ Muokkaa asetuksia, tai tiedosto claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Asetukset ▸ MCP ▸ Lisää, tai ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, tai .mcp.json projektissanne.

macOS: node ei löydy GUI-sovelluksesta

macOS:ssä graafiset sovellukset (Claude Desktop, Cursor…) eivät peri päätteenne PATH-muuttujaa. Jos node ei ole asennettu vakiosijaintiin, asiakas ei onnistu käynnistämään palvelinta ja ilmoittaa env: node: No such file or directory — jopa absoluuttisella npx-polulla, koska npx käynnistää node-ohjelman uudelleen PATH-muuttujan kautta. Luotettavin ratkaisu on alla oleva Vaihtoehto B: osoittakaa node — tarvittaessa absoluuttisella polulla — suoraan mukana tulevaan käynnistimeen ja ohittakaa npx.

Vaihtoehto B — sovelluksen mukana tuleva käynnistin (ilman npm:ää)

Jokainen Restorm-asennus toimittaa saman käynnistimen mukana tulevana resurssina, joten voitte osoittaa node-komennon suoraan siihen ilman npm:ää:

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

<path-to> on sovelluksen resurssihakemisto:

• 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); liitetyn levykuvan sisällä AppImagen tapauksessa; $SNAP/resources/restorm-resources/mcp-launcher.mjs Snapille.

Vaihtoehto C — suora HTTP

Lukekaa portti ja token löytötiedostosta ja lähettäkää JSON-RPC-pyyntönne otsakkeella Authorization: Bearer <token>.

Mistä käynnistin etsii

Käynnistimen ja sovelluksen on oltava yksimielisiä löytöhakemistosta. Molemmat käyttävät oletuksena hakemistoa restorm-mcp järjestelmän tilapäishakemiston alla; jos asetatte ympäristömuuttujan RESTORM_MCP_DIR, antakaa sille sama arvo molemmilla puolilla (tarpeen vain, jos Restorm on käynnissä palvelunhallinnan alla, jolla on eri tilapäishakemisto).

Useita instansseja

Useita Restorm-instansseja voi olla käynnissä rinnakkain. Jokainen kutsu hyväksyy varatun avaimen __session, jolla kohdeinstanssi nimetään. Työkalut list-instances, create_instance ja terminate_instance täydentävät kokonaisuuden.

Työkaluperheet

Luku · navigointi · projekti · kirjoitus · ympäristöt ja salaisuudet · tuonti · suoritus · skenaariot · instanssit · käyttöliittymän automatisointi (kuvakaappaus, DOM-kysely, syöttö, pikanäppäimet, teemat, asettelu).

Tarjolla on myös neljä resurssia: restorm://project, restorm://tree, restorm://active-tab ja restorm://request/{id}.

Täydellinen luettelo: MCP-työkalujen luettelo.

Mikä on ilmaista ja mikä Pro

MCP-palvelinta itseään ei ole koskaan rajoitettu. Jokainen työkalu tarkistaa oman käyttöoikeutensa kutsuhetkellä.

• Community-editio — kaikki pyyntöjen ohjaus: suoritus, peruutus, vastausten ja historian luku, virtojen luku, viestien lähetys, tuonti URL-osoitteesta, välilehtien avaus ja sulkeminen, projektien hallinta, puuhun kirjoittaminen, ympäristöjen ja muuttujien hallinta, pika-asetukset, suosikit sekä kuusi palomuurityökalua.
• Pro-editio — skenaarioalue (myös luku), kaappaukset, koko käyttöliittymän automatisointi, teemat, miniselain, workbenchin asettelu, useat instanssit ja git-työkalut.

Rajoitettu työkalu pysyy listattuna — sen nimessä on jälkiliite (Restorm Pro) — ja palauttaa selkeän, koneluettavan virheen sen sijaan, että katoaisi.

Tietoturva

• Paikallinen silmukka ja token: palvelin kuuntelee vain osoitteessa 127.0.0.1, ja token vertaillaan vakioajassa.
• Salaisuudet: agentti saa salaisuuden ratkaistun arvon, aivan kuten muukin sovellus — se ohjaa Restormia teidän puolestanne, teidän omilla salaisuuksillanne. Se, minkä Salaisuus -tyyppi takaa, pätee edelleen: arvo ei päädy projektiin, vientiin eikä valtuuttamattomalle kolmannen osapuolen palvelulle.
• Todelliset verkkovaikutukset: run_request kutsuu oikeasti kohdetta. Suojana toimii oman MCP-asiakkaanne hyväksyntävirta — pitäkää se päällä.
• Palomuuri pätee: agentin käynnistämä kutsu tuntemattomaan alkuperään aiheuttaa saman lupapyynnön kuin omanne.
• Lokitus: jokainen kutsu näkyy MCP-lokeissa pyyntöineen ja vastauksineen.