Ga naar inhoud

Restorm besturen via MCP

Restorm biedt een MCP-server (Model Context Protocol). Een AI-agent — Claude Code, Cursor, of elke MCP-client — kan dus uw project lezen, verzoeken maken en uitvoeren, en de interface besturen.

Daarmee kunt u vragen “importeer deze Swagger, maak een scenario dat het besteltraject test en start het”, en een verifieerbaar resultaat krijgen, in een applicatie die u onder ogen houdt.

De server is standaard ingeschakeld. Er zijn twee besturingslagen:

  • de instelling Instellingen ▸ MCP ▸ MCP-server inschakelen;
  • een absolute regel: op een machine zonder beeldscherm start de MCP-server nooit, wat de instelling ook is. Een CI-server komt dus niet in de situatie dat hij een eindpunt aanbiedt.

De MCP-indicator in de statusbalk knippert bij elke inkomende aanroep. Met de popover kunt u de server voor de sessie pauzeren of weer hervatten en de MCP-logboeken openen.

De MCP-indicator in de statusbalk en zijn popover: de luisterpoort van de server, de naam van de verbonden sessie, en de acties “MCP-server stoppen” en “Logboeken bekijken”

Bij het starten kiest Restorm een vrije poort, genereert het een procesgebonden accesstoken, en schrijft het een detectiebestand in de tijdelijke map van het systeem. De JSON-RPC-server luistert op 127.0.0.1:<poort>/mcpuitsluitend op de loopback: elke aanroeper van buiten krijgt een 403.

Een kleine proxy vormt de brug tussen de standaardinvoer van uw MCP-client en de HTTP-server van Restorm:

{
"mcpServers": {
"restorm": {
"command": "node",
"args": ["scripts/mcp-launcher.mjs"]
}
}
}

Die vindt de actieve instantie, injecteert het token, en start Restorm nooit stilletjes op: een instantie waarvan u de MCP-server hebt uitgezet, blijft uit, met een duidelijke foutmelding.

Lees de poort en het token uit het detectiebestand en verstuur uw JSON-RPC-verzoeken met een header Authorization: Bearer <token>.

Er kunnen meerdere Restorm-instanties naast elkaar draaien. Elke aanroep accepteert een gereserveerde sleutel __session om de bedoelde instantie aan te wijzen. De tools list-instances, create_instance en terminate_instance maken het geheel af.

Lezen · navigeren · project · schrijven · omgevingen en geheimen · import · uitvoeren · scenario’s · instanties · de interface automatiseren (schermafbeelding, DOM-query, invoer, sneltoetsen, thema’s, indeling).

Er worden ook vier resources aangeboden: restorm://project, restorm://tree, restorm://active-tab en restorm://request/{id}.

Volledige inventaris: MCP-tools.

De MCP-server zelf is nooit beperkt. Elke tool controleert bij de aanroep zijn eigen mogelijkheid.

  • Community-editie — de volledige besturing van verzoeken: uitvoeren, annuleren, responsen en geschiedenis lezen, streams lezen, berichten versturen, importeren vanaf een URL, tabbladen openen en sluiten, projecten beheren, in de boom schrijven, omgevingen en variabelen beheren, de snelle instellingen, de favorieten, en de zes firewalltools.
  • Pro-editie — het domein scenario’s (ook lezend), de schermafbeeldingen, de volledige automatisering van de interface, de thema’s, de minibrowser, de indeling van de workbench, de meerdere instanties, en de git-tools.

Een beperkte tool blijft in de lijst staan — het opschrift krijgt het achtervoegsel (Restorm Pro) — en geeft een expliciete, machineleesbare fout in plaats van te verdwijnen.

  • Loopback en token: de server luistert alleen op 127.0.0.1, en het token wordt in constante tijd vergeleken.
  • Geheimen: een agent krijgt de opgeloste waarde van een geheim, net als de rest van de applicatie — hij bestuurt Restorm namens u, op uw eigen geheimen. Wat het type Geheim garandeert, blijft gelden: de waarde gaat niet mee in het project, niet in een export, en niet naar een niet toegestane derde dienst.
  • Echte netwerkeffecten: run_request roept het doelwit daadwerkelijk aan. Het is de goedkeuringsflow van uw MCP-client die de rol van vangrail speelt — houd die actief.
  • De firewall geldt: een aanroep die een agent naar een onbekende oorsprong doet, leidt tot hetzelfde verzoek om toestemming als uw eigen aanroep.
  • Logging: elke aanroep verschijnt in de MCP-logboeken, met zijn verzoek en zijn respons.