Sterowanie Restorm przez MCP

Restorm udostępnia serwer MCP (Model Context Protocol). Agent AI — Claude Code, Cursor albo dowolny klient MCP — może więc czytać projekt, tworzyć i uruchamiać żądania oraz sterować interfejsem.

To właśnie pozwala poprosić „zaimportuj ten Swagger, utwórz scenariusz, który testuje ścieżkę zamówienia, i uruchom go” i otrzymać weryfikowalny wynik, w aplikacji, którą cały czas ma się przed oczami.

Włączanie

Serwer jest włączony domyślnie. Obowiązują dwa mechanizmy nadzoru:

• ustawienie Ustawienia ▸ MCP ▸ Włącz serwer MCP;
• zasada bezwzględna: na maszynie bez wyświetlacza serwer MCP nigdy nie uruchamia się, niezależnie od ustawienia. Serwer CI nie zacznie więc przypadkiem udostępniać punktu wejścia.

Wskaźnik MCP na pasku stanu mruga przy każdym przychodzącym wywołaniu. Jego okno podręczne pozwala wstrzymać albo wznowić działanie serwera na czas sesji, a także otworzyć dzienniki MCP.

Podłączanie asystenta AI

Przy uruchomieniu Restorm wybiera wolny port, generuje token dostępu właściwy dla procesu i zapisuje plik odkrywania w katalogu tymczasowym systemu. Serwer JSON-RPC nasłuchuje na 127.0.0.1:<port>/mcp — wyłącznie w pętli lokalnej: każdy wywołujący z zewnątrz otrzymuje 403.

Tego portu ani tokena nigdy nie kopiuje Pan/Pani samodzielnie. Niewielki program uruchamiający tworzy pomost między standardowym wejściem i wyjściem Pana/Pani klienta MCP a serwerem HTTP aplikacji Restorm: odnajduje działającą instancję, wstrzykuje token i przekazuje Pana/Pani wywołania. Na initialize i tools/list odpowiada natychmiast z wbudowanego manifestu, dzięki czemu Pana/Pani klient uruchamia się szybko, bez czekania na start Restorm — a następnie udostępnia rzeczywistą listę narzędzi, gdy tylko przejdzie pierwsze wywołanie. Nigdy nie uruchamia Restorm po cichu: instancja, w której serwer MCP został wyłączony, pozostaje wyłączona, wraz z jasnym komunikatem o błędzie.

Co daje podłączenie AI

Podłączenie asystenta do Restorm daje mu pełny dostęp do Pana/Pani narzędzi Restorm w imieniu Pana/Pani — uruchamianie żądań wobec prawdziwych celów, odczyt i zapis Pana/Pani projektu oraz (w edycji Pro) narzędzia automatyzacji i git. Żądania używają Pana/Pani rozwiązanych sekretów, dokładnie tak, jak wtedy, gdy osobiście steruje Pan/Pani Restorm. Token odkrywania jest właściwy dla instancji i może go odczytać jedynie lokalny użytkownik Pana/Pani. Proszę podłączać wyłącznie asystentów, którym Pan/Pani ufa, i pozostawić włączone monity zatwierdzania w swoim kliencie MCP.

Najprościej — z poziomu aplikacji

Najszybsza droga nie wymaga żadnej ręcznej konfiguracji. Proszę otworzyć okno podręczne wskaźnika MCP (pasek stanu) i kliknąć „Dodaj Restorm do swojego asystenta AI”. Okno dialogowe przedstawia, klient po kliencie, jedyny wiersz do skopiowania:

• Claude Code — polecenie claude mcp add …, w parze z przyciskiem „Dodaj do Claude Code”, który uruchamia je za Pana/Panią, gdy narzędzie claude zostanie wykryte w zmiennej PATH Pana/Pani;
• Claude Desktop i Cursor — blok mcpServers do wklejenia, wraz z lokalizacją pliku konfiguracyjnego.

Restorm nigdy nie zapisuje pliku konfiguracyjnego innej aplikacji: przycisk uruchomienia steruje wyłącznie Pana/Pani własnym CLI claude. W przypadku pozostałych klientów wkleja Pan/Pani fragment samodzielnie.

Wtyczka Claude Code

Claude Code może też zainstalować Restorm jako wtyczkę, z naszego własnego marketplace’u:

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

Wtyczka rejestruje serwer MCP restorm (opiera się na npx -y restorm-mcp) — nic więcej nie trzeba konfigurować.

Konfiguracja ręczna

Woli Pan/Pani napisać konfigurację samodzielnie — albo używa Pan/Pani innego klienta? Poniższe opcje obejmują każdy przypadek.

Wymagania wstępne

• Serwer MCP jest włączony — domyślnie jest włączony (Ustawienia ▸ MCP). Na maszynie bez wyświetlacza nigdy się nie uruchamia, niezależnie od ustawienia.
• Instancja Restorm jest uruchomiona — program uruchamiający łączy się z Pana/Pani działającą aplikacją, sam żadnej nie tworzy.
• Node.js ≥ 18 dla poniższej metody npx.

Opcja A — npx restorm-mcp (zalecana)

Bez instalacji, bez ścieżki do zarządzania, działa z dowolnym klientem i w każdym systemie operacyjnym. Proszę skierować na nią swojego klienta:

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

Gdzie trafia ten fragment, zależy od Pana/Pani klienta:

• Claude Desktop — Ustawienia ▸ Deweloper ▸ Edytuj konfigurację, albo plik claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Ustawienia ▸ MCP ▸ Dodaj, albo ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, albo .mcp.json w Pana/Pani projekcie.

macOS: nie znaleziono node z aplikacji GUI

W systemie macOS aplikacje GUI (Claude Desktop, Cursor…) nie dziedziczą zmiennej PATH z Pana/Pani terminala. Jeśli node nie jest zainstalowany w standardowej lokalizacji, klient nie może uruchomić serwera i zgłasza env: node: No such file or directory — nawet z bezwzględną ścieżką do npx, ponieważ npx ponownie uruchamia node poprzez PATH. Najpewniejszym obejściem jest Opcja B poniżej: należy skierować node — w razie potrzeby ze ścieżką bezwzględną — bezpośrednio na dołączony program uruchamiający, z pominięciem npx.

Opcja B — program uruchamiający dołączony do aplikacji (bez npm)

Każda instalacja Restorm dostarcza ten sam program uruchamiający jako dołączony zasób, więc może Pan/Pani skierować node bezpośrednio na niego, bez npm:

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

<path-to> to katalog zasobów aplikacji:

• 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); wewnątrz zamontowanego obrazu w przypadku AppImage; $SNAP/resources/restorm-resources/mcp-launcher.mjs dla Snapa.

Opcja C — bezpośrednio przez HTTP

Proszę odczytać port i token z pliku odkrywania, a następnie wysyłać żądania JSON-RPC z nagłówkiem Authorization: Bearer <token>.

Gdzie szuka program uruchamiający

Program uruchamiający i aplikacja muszą uzgodnić katalog odkrywania. Oba domyślnie używają restorm-mcp w katalogu tymczasowym systemu; jeśli ustawi Pan/Pani zmienną środowiskową RESTORM_MCP_DIR, proszę nadać jej tę samą wartość po obu stronach (potrzebne tylko wtedy, gdy Restorm działa pod menedżerem usług z innym katalogiem tymczasowym).

Wiele instancji

Równolegle może działać kilka instancji Restorm. Każde wywołanie przyjmuje zarezerwowany klucz __session wskazujący instancję docelową. Obraz uzupełniają narzędzia list-instances, create_instance i terminate_instance.

Rodziny narzędzi

Odczyt · nawigacja · projekt · zapis · środowiska i sekrety · import · wykonanie · scenariusze · instancje · automatyzacja interfejsu (zrzut ekranu, zapytanie do DOM, wprowadzanie danych, skróty, motywy, układ).

Udostępniane są także cztery zasoby: restorm://project, restorm://tree, restorm://active-tab oraz restorm://request/{id}.

Pełny wykaz: Narzędzia MCP.

Co jest darmowe, a co należy do planu Pro

Sam serwer MCP nigdy nie jest ograniczony. Każde narzędzie sprawdza własną możliwość w momencie wywołania.

• Edycja Community — całe sterowanie żądaniami: uruchamianie, anulowanie, odczyt odpowiedzi i historii, odczyt strumieni, wysyłanie wiadomości, import z adresu URL, otwieranie i zamykanie zakładek, zarządzanie projektami, zapis w drzewie, zarządzanie środowiskami i zmiennymi, szybkie ustawienia, ulubione oraz sześć narzędzi zapory.
• Edycja Pro — obszar scenariuszy (również w trybie odczytu), przechwytywania, cała automatyzacja interfejsu, motywy, mini-przeglądarka, układ workbencha, wiele instancji oraz narzędzia git.

Narzędzie objęte ograniczeniem nadal pozostaje na liście — jego nazwa nosi sufiks (Restorm Pro) — i zwraca jednoznaczny, czytelny maszynowo błąd, zamiast zniknąć.

Bezpieczeństwo

• Pętla lokalna i token: serwer nasłuchuje wyłącznie na 127.0.0.1, a token jest porównywany w stałym czasie.
• Sekrety: agent otrzymuje rozwiązaną wartość sekretu, tak samo jak reszta aplikacji — steruje Restormem w imieniu użytkownika, na jego własnych sekretach. To, co gwarantuje typ Sekret, pozostaje w mocy: wartość nie trafia ani do projektu, ani do eksportu, ani do nieuprawnionej usługi zewnętrznej.
• Rzeczywiste skutki sieciowe: run_request naprawdę wywołuje cel. Rolę zabezpieczenia odgrywa proces zatwierdzania własnego klienta MCP — warto utrzymać go włączony.
• Zapora obowiązuje: wywołanie wyzwolone przez agenta w stronę nieznanego źródła powoduje takie samo żądanie autoryzacji jak wywołanie użytkownika.
• Rejestrowanie: każde wywołanie pojawia się w dziennikach MCP, wraz z żądaniem i odpowiedzią.