Điều khiển Restorm qua MCP

Restorm cung cấp một máy chủ MCP (Model Context Protocol). Nhờ đó một tác nhân AI — Claude Code, Cursor, hay bất kỳ client MCP nào — có thể đọc dự án của bạn, tạo và chạy các yêu cầu, và điều khiển giao diện.

Đây chính là thứ cho phép bạn nói “hãy nhập tệp Swagger này, tạo một kịch bản kiểm thử hành trình đặt hàng rồi chạy nó” và nhận về một kết quả kiểm chứng được, trong một ứng dụng mà bạn vẫn nhìn thấy trước mắt.

Bật lên

Máy chủ được bật theo mặc định. Có hai cơ chế quản trị:

• thiết lập Cài đặt ▸ MCP ▸ Bật máy chủ MCP;
• một quy tắc tuyệt đối: trên một máy không có màn hình, máy chủ MCP không bao giờ khởi động, bất kể cấu hình ra sao. Nhờ vậy một máy chủ CI sẽ không vô tình phơi ra một điểm vào.

Chỉ báo MCP trên thanh trạng thái nhấp nháy ở mỗi lời gọi đi vào. Cửa sổ bật lên của nó cho phép tạm dừng hoặc tiếp tục máy chủ trong phiên làm việc, và mở nhật ký MCP.

Kết nối một tác nhân

Lúc khởi động, Restorm chọn một cổng còn trống, sinh một token truy cập riêng cho tiến trình, và ghi một tệp khám phá vào thư mục tạm của hệ thống. Máy chủ JSON-RPC lắng nghe trên 127.0.0.1:<port>/mcp — chỉ trên vòng lặp cục bộ: mọi bên gọi từ bên ngoài đều nhận về 403.

Phương án A — bộ khởi chạy (khuyến nghị)

Một proxy nhỏ làm cầu nối giữa đầu vào chuẩn của client MCP của bạn và máy chủ HTTP của Restorm:

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

Nó phát hiện thể hiện đang chạy, chèn token vào, và không bao giờ khởi động Restorm một cách âm thầm: một thể hiện mà bạn đã tắt máy chủ MCP thì vẫn tắt, kèm một thông báo lỗi rõ ràng.

Phương án B — HTTP trực tiếp

Hãy đọc cổng và token trong tệp khám phá, rồi gửi các yêu cầu JSON-RPC của bạn kèm header Authorization: Bearer <jeton>.

Nhiều thể hiện

Nhiều bản Restorm có thể chạy song song. Mỗi lời gọi chấp nhận một khóa dành riêng __session để chỉ định thể hiện cần nhắm tới. Các công cụ list-instances, create_instance và terminate_instance hoàn thiện bức tranh.

Các họ công cụ

Đọc · điều hướng · dự án · ghi · môi trường và bí mật · nhập dữ liệu · chạy · kịch bản · thể hiện · tự động hóa giao diện (chụp màn hình, truy vấn DOM, nhập liệu, phím tắt, chủ đề, bố cục).

Ngoài ra còn có bốn tài nguyên được cung cấp: restorm://project, restorm://tree, restorm://active-tab và restorm://request/{id}.

Danh sách đầy đủ: Công cụ MCP.

Cái gì miễn phí và cái gì thuộc bản Pro

Bản thân máy chủ MCP không bao giờ bị hạn chế. Mỗi công cụ tự kiểm tra năng lực của mình vào lúc được gọi.

• Bản Community — toàn bộ việc điều khiển yêu cầu: chạy, hủy, đọc phản hồi và lịch sử, đọc luồng, gửi thông điệp, nhập từ một URL, mở và đóng tab, quản lý dự án, ghi vào cây, quản lý môi trường và biến, cài đặt nhanh, mục yêu thích, cùng sáu công cụ tường lửa.
• Bản Pro — mảng kịch bản (kể cả ở chế độ đọc), chụp màn hình, toàn bộ phần tự động hóa giao diện, chủ đề, trình duyệt mini, bố cục workbench, nhiều thể hiện, và các công cụ git.

Một công cụ bị hạn chế vẫn được liệt kê — tên của nó mang hậu tố (Restorm Pro) — và trả về một lỗi rõ ràng, máy đọc được, thay vì biến mất.

Bảo mật

• Vòng lặp cục bộ và token: máy chủ chỉ lắng nghe trên 127.0.0.1, và token được so sánh trong thời gian hằng.
• Bí mật: một tác nhân nhận giá trị đã giải quyết của một bí mật, giống như phần còn lại của ứng dụng — nó điều khiển Restorm thay mặt bạn, trên chính các bí mật của bạn. Những gì kiểu Bí mật bảo đảm vẫn đúng: giá trị không đi vào dự án, không vào một bản xuất, cũng không tới một dịch vụ bên thứ ba chưa được phép.
• Có tác động mạng thật: run_request thực sự gọi tới đích. Chính luồng phê duyệt của client MCP của bạn mới đóng vai trò rào chắn — hãy giữ nó luôn bật.
• Tường lửa vẫn được áp dụng: một lời gọi do tác nhân kích hoạt tới một nguồn gốc lạ sẽ gây ra đúng lời hỏi cấp phép như khi bạn tự gọi.
• Ghi nhật ký: mọi lời gọi đều xuất hiện trong nhật ký MCP, kèm yêu cầu và phản hồi của nó.