Керування Restorm через MCP

Restorm надає сервер MCP (Model Context Protocol). Отже, агент зі штучним інтелектом — Claude Code, Cursor або будь-який клієнт MCP — може читати ваш проєкт, створювати й виконувати запити та керувати інтерфейсом.

Саме це дає змогу попросити «імпортуй цей Swagger, створи сценарій, який перевіряє шлях замовлення, і запусти його» та отримати перевірний результат у застосунку, який ви тримаєте перед очима.

Увімкнення

Сервер увімкнено типово. Керують ним дві речі:

• налаштування Параметри ▸ MCP ▸ Увімкнути сервер MCP;
• абсолютне правило: на машині без дисплея сервер MCP ніколи не запускається, хоч би яким було налаштування. Тож сервер CI не почне виставляти точку входу.

Індикатор MCP у рядку стану блимає на кожен вхідний виклик. Його спливаюче вікно дає змогу призупинити чи відновити роботу сервера на час сеансу й відкрити журнали MCP.

Підключення вашого асистента зі ШІ

Під час запуску Restorm обирає вільний порт, генерує токен доступу, властивий цьому процесу, і записує файл виявлення до тимчасового каталогу системи. Сервер JSON-RPC слухає на 127.0.0.1:<port>/mcp — лише на локальній петлі: будь-який зовнішній викликач отримує 403.

Цей порт і токен ви ніколи не копіюєте самі. Невеликий запускач перекидає місток між стандартним входом і виходом вашого клієнта MCP та сервером HTTP у Restorm: він знаходить поточний екземпляр, підставляє токен і передає ваші виклики. На initialize та tools/list він відповідає миттєво зі вбудованого маніфесту, тож ваш клієнт запускається швидко, не чекаючи на старт Restorm — а потім видає живий список інструментів, щойно пройде перший виклик. Він ніколи не запускає Restorm непомітно: екземпляр, у якому ви вимкнули сервер MCP, залишиться вимкненим, і ви отримаєте чітке повідомлення про помилку.

Що надає підключення ШІ

Підключення асистента до Restorm дає йому повний доступ до ваших інструментів Restorm від вашого імені — виконувати запити до реальних цілей, читати й записувати ваш проєкт і (у Pro) інструменти автоматизації та git. Запити використовують ваші розв’язані секрети, точно як тоді, коли ви керуєте Restorm самі. Токен виявлення властивий екземпляру та доступний для читання лише вашому локальному користувачеві. Підключайте лише тих асистентів, яким довіряєте, і тримайте увімкненими запити на підтвердження у вашому клієнті MCP.

Найпростіший спосіб — прямо із застосунку

Найшвидший шлях не потребує жодного ручного налаштування. Відкрийте спливаюче вікно індикатора MCP (рядок стану) і натисніть «Додати Restorm до вашого агента ШІ». Діалогове вікно показує, клієнт за клієнтом, єдиний рядок, який треба скопіювати:

• Claude Code — команда claude mcp add …, у парі з кнопкою «Додати до Claude Code», яка виконує її за вас, щойно інструмент claude виявлено у вашому PATH;
• Claude Desktop та Cursor — блок mcpServers для вставлення разом із розташуванням файлу конфігурації.

Restorm ніколи не записує файл конфігурації іншого застосунку: кнопка запуску керує лише вашим власним CLI claude. Для інших клієнтів ви вставляєте фрагмент самі.

Плагін Claude Code

Claude Code також може встановити Restorm як плагін із нашого власного маркетплейсу:

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

Плагін реєструє сервер MCP restorm (він спирається на npx -y restorm-mcp) — більше нічого налаштовувати не потрібно.

Налаштування вручну

Волієте написати конфігурацію самі — чи використовуєте інший клієнт? Наведені нижче варіанти охоплюють усі випадки.

Передумови

• Сервер MCP увімкнено — він увімкнений за замовчуванням (Параметри ▸ MCP). На машині без дисплея він ніколи не запускається, хоч би що казало налаштування.
• Екземпляр Restorm запущено — запускач під’єднується до вашого запущеного застосунку, він не створює власного.
• Node.js ≥ 18 для способу через npx нижче.

Варіант A — npx restorm-mcp (рекомендовано)

Без встановлення, без шляху, яким треба керувати, працює з будь-яким клієнтом і на кожній ОС. Спрямуйте свого клієнта на нього:

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

Куди помістити цей фрагмент, залежить від вашого клієнта:

• Claude Desktop — Параметри ▸ Розробник ▸ Редагувати конфігурацію, або файл claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Параметри ▸ MCP ▸ Додати, або ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, або .mcp.json у вашому проєкті.

macOS: node не знайдено з GUI-застосунку

У macOS GUI-застосунки (Claude Desktop, Cursor…) не успадковують PATH вашого термінала. Якщо node не встановлено у стандартному розташуванні, клієнт не може запустити сервер і завершується помилкою env: node: No such file or directory — навіть із абсолютним шляхом до npx, оскільки npx перезапускає node через PATH. Найнадійніше рішення — Варіант B нижче: спрямуйте node — за потреби з абсолютним шляхом — прямо на вкладений запускач, оминаючи npx.

Варіант B — запускач, що постачається з застосунком (без npm)

Кожне встановлення Restorm постачає той самий запускач як вкладений ресурс, тож ви можете спрямувати node прямо на нього, без npm:

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

<path-to> — це каталог ресурсів застосунку:

• 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; $SNAP/resources/restorm-resources/mcp-launcher.mjs для Snap.

Варіант C — прямий HTTP

Прочитайте порт і токен із файлу виявлення, а потім надсилайте свої запити JSON-RPC із заголовком Authorization: Bearer <token>.

Де шукає запускач

Запускач і застосунок мають узгодити каталог виявлення. Обидва за замовчуванням використовують restorm-mcp у тимчасовому каталозі системи; якщо ви задаєте змінну середовища RESTORM_MCP_DIR, надайте їй однакове значення з обох боків (потрібно лише тоді, коли Restorm працює під менеджером служб з іншим тимчасовим каталогом).

Кілька екземплярів

Кілька копій Restorm можуть працювати паралельно. Кожен виклик приймає зарезервований ключ __session, щоб позначити потрібний екземпляр. Картину доповнюють інструменти list-instances, create_instance та terminate_instance.

Родини інструментів

Читання · навігація · проєкт · запис · середовища та секрети · імпорт · виконання · сценарії · екземпляри · автоматизація інтерфейсу (знімок екрана, запит до DOM, введення, комбінації клавіш, теми, розташування).

Також надано чотири ресурси: restorm://project, restorm://tree, restorm://active-tab і restorm://request/{id}.

Повний перелік: Інструменти MCP.

Що безкоштовне, а що належить до Pro

Сам сервер MCP ніколи не обмежують. Кожен інструмент перевіряє власну можливість у момент виклику.

• Видання Community — усе керування запитами: виконати, скасувати, прочитати відповіді та історію, читати потоки, надсилати повідомлення, імпортувати за URL, відкривати й закривати вкладки, керувати проєктами, писати в дерево, керувати середовищами та змінними, швидкими параметрами, обраним, а також шість інструментів брандмауера.
• Видання Pro — область сценаріїв (зокрема й читання), знімки, уся автоматизація інтерфейсу, теми, міні-браузер, розташування workbench, кілька екземплярів та інструменти git.

Обмежений інструмент лишається в переліку — його підпис має суфікс (Restorm Pro) — і повертає явну, придатну для машинного читання помилку замість того, щоб зникнути.

Безпека

• Локальна петля й токен: сервер слухає лише на 127.0.0.1, а токен порівнюється за сталий час.
• Секрети: агент отримує розв’язане значення секрету, так само як і решта застосунку — він керує Restorm від вашого імені, з вашими власними секретами. Те, що гарантує тип «Секрет», лишається чинним: значення не вирушає ні до проєкту, ні до експорту, ні до неавторизованої сторонньої служби.
• Справжні мережеві наслідки: run_request справді викликає ціль. Роль запобіжника відіграє потік підтверджень вашого клієнта MCP — тримайте його увімкненим.
• Брандмауер діє: виклик, запущений агентом до невідомого джерела, спричиняє такий самий запит на дозвіл, як і ваш власний.
• Журналювання: кожен виклик з’являється в журналах MCP разом зі своїм запитом і відповіддю.