MCP로 Restorm 제어하기

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

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

활성화

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

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

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

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

AI 어시스턴트 연결하기

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

이 포트나 토큰을 직접 복사하는 일은 없습니다. 작은 런처가 MCP 클라이언트의 표준 입출력과 Restorm의 HTTP 서버 사이를 잇습니다. 실행 중인 인스턴스를 찾아 토큰을 주입하고 호출을 전달합니다. 내장 매니페스트를 이용해 initialize와 tools/list에 즉시 응답하므로, Restorm이 부팅될 때까지 기다리지 않고도 클라이언트가 빠르게 시작하며, 첫 호출이 통과하면 실제 도구 목록을 제공합니다. Restorm을 조용히 실행하는 일은 결코 없습니다. MCP 서버를 꺼 둔 인스턴스는 그대로 꺼진 채로 남고, 명확한 오류 메시지가 표시됩니다.

가장 쉬운 방법 — 앱에서

가장 빠른 방법은 수동 구성이 전혀 필요 없습니다. (상태 바의) MCP 표시기 팝오버를 열고 “Restorm을 AI 어시스턴트에 추가” 를 클릭하십시오. 대화 상자가 클라이언트별로, 복사할 한 줄을 안내합니다.

Claude Code — claude mcp add … 명령. “Claude Code에 추가” 버튼이 함께 제공되어, claude CLI가 PATH에서 감지되면 그 명령을 대신 실행해 줍니다.
Claude Desktop 과 Cursor — 붙여 넣을 mcpServers 블록과 구성 파일의 위치.

“Restorm을 AI 어시스턴트에 추가” 대화 상자: Claude Code, Claude Desktop, Cursor 세 개의 섹션이 세로로 쌓여 있고, 각각에 복사할 줄이 표시됩니다. Claude Code 섹션에는 원클릭 실행 버튼도 제공됩니다

Restorm은 다른 앱의 구성 파일을 결코 쓰지 않습니다. 실행 버튼은 오직 사용자 본인의 claude CLI만 구동합니다. 다른 클라이언트의 경우에는 스니펫을 직접 붙여 넣으십시오.

Claude Code 플러그인

Claude Code는 저희가 자체 호스팅하는 마켓플레이스에서 Restorm을 플러그인으로 설치할 수도 있습니다.

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

이 플러그인은 restorm MCP 서버를 등록합니다(npx -y restorm-mcp 를 사용합니다) — 그 밖에 설정할 것은 없습니다.

직접 손으로 구성하기

구성을 직접 작성하고 싶거나 다른 클라이언트를 사용하시나요? 아래 옵션이 모든 경우를 다룹니다.

사전 요구 사항

MCP 서버가 활성화되어 있어야 합니다 — 기본적으로 켜져 있습니다(설정 ▸ MCP). 디스플레이가 없는 머신에서는 설정과 무관하게 결코 시작되지 않습니다.
Restorm 인스턴스가 실행 중이어야 합니다 — 런처는 사용자의 실행 중인 앱에 연결하며, 새로 띄우지 않습니다.
아래 npx 방법에는 Node.js ≥ 18 이 필요합니다.

방법 A — `npx restorm-mcp` (권장)

설치도, 관리할 경로도 없으며, 어떤 클라이언트에서든 모든 OS에서 동작합니다. 클라이언트를 여기로 가리키십시오.

{
  "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.

방법 B — 앱에 함께 제공되는 런처 (npm 불필요)

Restorm 설치본에는 모두 동일한 런처가 번들 리소스로 포함되어 있어, npm 없이 node를 바로 그것으로 가리킬 수 있습니다.

{
  "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의 경우 $SNAP/resources/restorm-resources/mcp-launcher.mjs.

방법 C — HTTP 직접 호출

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

런처가 찾는 위치

런처와 앱은 탐색 디렉터리에 대해 일치해야 합니다. 둘 다 기본적으로 시스템 임시 디렉터리 아래의 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 로그에 나타납니다.