Řízení aplikace Restorm přes MCP

Restorm nabízí server MCP (Model Context Protocol). Agent s AI — Claude Code, Cursor nebo kterýkoli klient MCP — tedy může číst váš projekt, vytvářet a spouštět požadavky a řídit rozhraní.

Právě díky tomu lze zadat „naimportuj tenhle Swagger, vytvoř scénář, který otestuje objednávkový proces, a spusť ho“ a dostat ověřitelný výsledek — v aplikaci, kterou máte celou dobu před očima.

Zapnutí

Server je ve výchozím stavu zapnutý. Řídí ho dvě věci:

• nastavení Nastavení ▸ MCP ▸ Povolit MCP server;
• absolutní pravidlo: na počítači bez displeje se server MCP nikdy nespustí, bez ohledu na nastavení. Server CI se tedy nikdy neocitne v roli vystaveného koncového bodu.

Indikátor MCP ve stavovém řádku blikne při každém příchozím volání. Jeho vyskakovací panel umožňuje server pro danou relaci pozastavit nebo obnovit a otevřít protokoly MCP.

Připojení asistenta AI

Při spuštění si Restorm zvolí volný port, vygeneruje přístupový token vlastní danému procesu a zapíše zjišťovací soubor do dočasného adresáře systému. Server JSON-RPC naslouchá na 127.0.0.1:<port>/mcp — výhradně na lokální smyčce: každý volající zvenčí dostane 403.

Tento port ani token nikdy nekopírujete sami. Malý spouštěč překlenuje standardní vstup a výstup vašeho klienta MCP a server HTTP aplikace Restorm: najde běžící instanci, vloží token a přeposílá vaše volání. Na initialize a tools/list odpovídá okamžitě z vestavěného manifestu, takže váš klient naběhne rychle, aniž by čekal na start Restormu — a jakmile projde první volání, poskytne živý seznam nástrojů. Restorm nikdy nespustí potichu: instance, u které jste server MCP vypnuli, zůstane vypnutá, s jasnou chybovou zprávou.

Co uděluje připojení AI

Připojení asistenta k Restormu mu dává plný přístup k vašim nástrojům Restorm vaším jménem — spouštět požadavky vůči skutečným cílům, číst a zapisovat váš projekt a (v edici Pro) nástroje automatizace a git. Požadavky používají vaše vyřešené tajné hodnoty, přesně jako když Restorm řídíte vy sami. Zjišťovací token je vázaný na instanci a čitelný pouze vaším místním uživatelem. Připojujte jen asistenty, kterým důvěřujete, a ponechte zapnuté schvalovací výzvy svého klienta MCP.

Nejjednodušší způsob — přímo z aplikace

Nejrychlejší cesta nevyžaduje žádnou ruční konfiguraci. Otevřete vyskakovací panel indikátoru MCP (stavový řádek) a klikněte na „Přidat Restorm do vašeho agenta AI“. Dialogové okno vám klient po klientovi ukáže jediný řádek, který stačí zkopírovat:

• Claude Code — příkaz claude mcp add …, doplněný tlačítkem „Přidat do Claude Code“, které jej za vás spustí, jakmile je nástroj claude nalezen ve vaší PATH;
• Claude Desktop a Cursor — blok mcpServers ke vložení, spolu s umístěním konfiguračního souboru.

Restorm nikdy nezapisuje konfigurační soubor jiné aplikace: tlačítko spuštění řídí pouze vaše vlastní CLI claude. U ostatních klientů úryvek vložíte sami.

Plugin pro Claude Code

Claude Code umí Restorm nainstalovat také jako plugin, z našeho vlastního tržiště:

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

Plugin zaregistruje server MCP restorm (opírá se o npx -y restorm-mcp) — nic dalšího není třeba nastavovat.

Ruční konfigurace

Chcete si konfiguraci napsat sami — nebo používáte jiného klienta? Níže uvedené možnosti pokrývají všechny případy.

Předpoklady

• Server MCP je zapnutý — ve výchozím stavu je zapnutý (Nastavení ▸ MCP). Na stroji bez displeje se nikdy nespustí, ať už je nastavení jakékoli.
• Instance Restormu běží — spouštěč se připojuje k vaší běžící aplikaci, sám žádnou nespouští.
• Node.js ≥ 18 pro níže uvedený způsob přes npx.

Varianta A — npx restorm-mcp (doporučeno)

Žádná instalace, žádná cesta ke správě, funguje s libovolným klientem a na každém OS. Nasměrujte na ni svého klienta:

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

Kam tento úryvek patří, závisí na vašem klientovi:

• Claude Desktop — Nastavení ▸ Vývojář ▸ Upravit konfiguraci, nebo soubor claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Nastavení ▸ MCP ▸ Přidat, nebo ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, nebo .mcp.json ve vašem projektu.

macOS: node nenalezen z GUI aplikace

V systému macOS nedědí GUI aplikace (Claude Desktop, Cursor…) PATH vašeho terminálu. Pokud node není nainstalován ve standardním umístění, klientovi se nepodaří spustit server a zobrazí env: node: No such file or directory — a to i s absolutní cestou k npx, protože npx znovu spouští node prostřednictvím PATH. Nejspolehlivějším řešením je Varianta B níže: nasměrujte node — v případě potřeby s absolutní cestou — přímo na přibalený spouštěč a obejděte tak npx.

Varianta B — spouštěč přibalený v aplikaci (bez npm)

Každá instalace Restormu obsahuje tentýž spouštěč jako přibalený prostředek, takže na něj můžete nasměrovat node přímo, bez npm:

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

<path-to> je adresář prostředků aplikace:

• 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); uvnitř připojeného obrazu u AppImage; $SNAP/resources/restorm-resources/mcp-launcher.mjs u Snapu.

Varianta C — přímé HTTP

Přečtěte si port a token ze zjišťovacího souboru a poté odesílejte své požadavky JSON-RPC s hlavičkou Authorization: Bearer <token>.

Kde spouštěč hledá

Spouštěč a aplikace se musí shodnout na zjišťovacím adresáři. Oba ve výchozím stavu používají restorm-mcp v dočasném adresáři systému; pokud nastavíte proměnnou prostředí RESTORM_MCP_DIR, nastavte ji na stejnou hodnotu na obou stranách (potřebné jen tehdy, běží-li Restorm pod správcem služeb s odlišným dočasným adresářem).

Několik instancí

Souběžně může běžet několik aplikací Restorm. Každé volání přijímá vyhrazený klíč __session, kterým se určí cílová instance. Obrázek doplňují nástroje list-instances, create_instance a terminate_instance.

Rodiny nástrojů

Čtení · navigace · projekt · zápis · prostředí a tajemství · import · spouštění · scénáře · instance · automatizace rozhraní (snímek obrazovky, dotaz na DOM, psaní, klávesové zkratky, motivy, rozvržení).

Nabízeny jsou také čtyři zdroje: restorm://project, restorm://tree, restorm://active-tab a restorm://request/{id}.

Úplný přehled: Nástroje MCP.

Co je zdarma a co je Pro

Samotný server MCP nikdy omezený není. Každý nástroj si svou vlastní možnost ověřuje v okamžiku volání.

• Edice Community — celé řízení požadavků: spouštění, rušení, čtení odpovědí a historie, čtení streamů, odesílání zpráv, import z URL, otevírání a zavírání karet, správa projektů, zápis do stromu, správa prostředí a proměnných, rychlá nastavení, oblíbené a šest nástrojů firewallu.
• Edice Pro — doména scénářů (a to i pro čtení), snímky, celá automatizace rozhraní, motivy, mini prohlížeč, rozvržení workbenchu, více instancí a nástroje git.

Omezený nástroj zůstává ve výpisu — jeho název nese příponu (Restorm Pro) — a místo aby zmizel, vrátí výslovnou chybu čitelnou i strojově.

Bezpečnost

• Lokální smyčka a token: server naslouchá jen na 127.0.0.1 a token se porovnává v konstantním čase.
• Tajemství: agent dostává vyhodnocenou hodnotu tajemství, stejně jako zbytek aplikace — řídí Restorm vaším jménem a s vašimi vlastními tajemstvími. To, co typ Tajný klíč zaručuje, platí dál: hodnota neodchází ani do projektu, ani do exportu, ani k neoprávněné službě třetí strany.
• Skutečné síťové účinky: run_request cíl opravdu zavolá. Roli pojistky hraje schvalovací tok vašeho klienta MCP — nechte si ho zapnutý.
• Firewall platí: volání spuštěné agentem na neznámý origin vyvolá tutéž žádost o povolení jako volání vaše.
• Zaznamenávání: každé volání se objeví v protokolech MCP, se svým požadavkem i odpovědí.