MCP로 Restorm 제어하기

Restorm은 MCP(Model Context Protocol) 서버를 제공합니다. 따라서 AI 에이전트 — Claude Code, Cursor, 또는 어떤 MCP 클라이언트든 — 가 프로젝트를 읽고, 요청을 만들어 실행하고, 인터페이스를 조작할 수 있습니다.

이 덕분에 “이 Swagger를 가져와서 주문 과정을 테스트하는 시나리오를 만들고 실행해 줘”라고 부탁하고, 눈앞에 두고 지켜보는 애플리케이션 안에서 검증할 수 있는 결과를 얻게 됩니다.

활성화

서버는 기본적으로 활성화되어 있습니다. 두 가지 통제 수단이 있습니다.

설정 ▸ MCP ▸ MCP 서버 활성화 설정.
절대 규칙: 디스플레이가 없는 컴퓨터에서는 설정이 어떻든 MCP 서버가 결코 시작되지 않습니다. 따라서 CI 서버가 진입점을 노출하게 되는 일은 없습니다.

상태 바의 MCP 표시기는 호출이 들어올 때마다 깜박입니다. 그 팝오버에서는 이번 세션 동안 서버를 일시 중지하거나 재개할 수 있고, MCP 로그를 열 수 있습니다.

상태 바의 MCP 표시기와 그 팝오버: 서버의 수신 포트, 연결된 세션의 이름, 그리고 “MCP 서버 중지”와 “로그 보기” 동작

에이전트 연결하기

시작할 때 Restorm은 빈 포트를 하나 고르고, 프로세스 고유의 접근 토큰을 생성하고, 시스템의 임시 디렉터리에 탐색 파일을 씁니다. JSON-RPC 서버는 127.0.0.1:<port>/mcp 에서, 로컬 루프백에서만 수신합니다. 외부에서 호출하면 403 을 받습니다.

방법 A — 런처(권장)

작은 프록시 하나가 MCP 클라이언트의 표준 입력과 Restorm의 HTTP 서버 사이를 잇습니다.

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

런처는 실행 중인 인스턴스를 찾아내고 토큰을 주입하며, Restorm을 조용히 실행하는 일은 결코 없습니다. MCP 서버를 꺼 둔 인스턴스는 그대로 꺼진 채로 남고, 명확한 오류 메시지가 표시됩니다.

방법 B — HTTP 직접 호출

탐색 파일에서 포트와 토큰을 읽고, Authorization: Bearer <token> 헤더와 함께 JSON-RPC 요청을 보내십시오.

여러 인스턴스

여러 개의 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 로그에 나타납니다.