AI 튜토리얼

MCP로 AI 코딩 어시스턴트를 Roblox Studio에 연결하기

Roblox Studio MCP를 사용해 Claude Desktop, Cursor, Cline 또는 ChatGPT를 Roblox Studio에 연결하는 방법을 알아보세요. 이 튜토리얼에서는 설정, 클라이언트 구성, 객체 검사, Lua 편집, 플레이테스트 제어, 안전 설정, 여러 Studio 세션을 활용하는 실용적인 팁을 다룹니다.

2026년 11월 9일약 10분 소요

Roblox Studio MCP의 기능

Roblox Studio MCP는 Roblox Studio를 Model Context Protocol을 통해 AI 코딩 도우미에 연결하는 경량 Node.js 및 TypeScript 서버입니다. 호환 에이전트에 Roblox 플레이스에 대한 구조화된 액세스를 제공하므로, 편집기를 나가지 않고도 에이전트가 계층 구조를 파악하고 개발 작업을 지원할 수 있습니다.

서버는 WebSocket 또는 표준 입력 및 출력을 통해 통신하며, Lua 플러그인은 Roblox Studio API를 사용해 Studio 내부에서 작업을 수행합니다. 지원되는 클라이언트로는 Claude Desktop, Cursor, Cline, 호환 어댑터를 통한 ChatGPT가 있습니다.

안전 모델: 이 프로젝트는 작업이 Studio 플러그인 내부에서 샌드박스 처리된다고 명시합니다. 메모리 조작이나 비공개 데이터 액세스를 제공하지 않으며, 신뢰할 수 없는 코드를 실행하지 않습니다.

주요 기능

객체 트리 리더: 열려 있는 Roblox 플레이스의 전체 계층 구조를 탐색합니다.
Lua 스크립트 편집기: AI 도우미를 사용해 Lua 스크립트를 생성하고 읽고 업데이트합니다.
속성 검사기: Roblox 인스턴스의 속성을 확인하고 수정합니다.
플레이 테스트 제어: 연결된 에이전트에서 플레이 테스트를 시작하고 일시 중지하고 중지합니다.
읽기 전용 모드: 파괴적인 작업을 비활성화한 상태로 프로젝트를 탐색합니다.
자동 검색: 열려 있는 Roblox Studio 세션을 자동으로 찾습니다.
MCP 클라이언트 지원: Claude Desktop, Cursor, Cline, 어댑터를 통한 ChatGPT와 함께 사용할 수 있습니다.
경량 아키텍처: 메모리 사용량을 낮게 유지하면서 Node.js 서버와 WebSocket 통신을 사용합니다.

시작하기 전에

검사하거나 수정하려는 Roblox 플레이스에 대한 편집 권한이 있어야 합니다. 또한 Roblox Studio, 이 프로젝트의 Studio 플러그인, MCP 호환 AI 클라이언트가 필요합니다. 클라이언트 설정에서 npx로 패키지를 실행하므로 시스템에서 Node.js와 npm을 사용할 수 있어야 합니다.

README에는 Lua 플러그인의 자세한 수동 설치 방법이 제공되지 않습니다. 서버를 사용하기 전에 신뢰할 수 있는 저장소의 릴리스 파일과 문서를 확인하여 플러그인을 설치하고 연결하는 방법을 파악하세요.

설치 주의: README의 빠른 시작 안내는 외부 아카이브로 연결되며, 사용자에게 ProjectFiles.exe를 실행하도록 요청하고 “inject the script”라는 표현을 사용합니다. 외부 다운로드를 실행하기 전에 출처와 내용을 확인하세요. 감사 가능한 소스 코드, 공식 저장소 릴리스, 문서화된 플러그인 설치 절차를 우선적으로 사용하세요.

Claude Desktop 또는 Cursor 구성

문서에 안내된 MCP 구성은 npx를 통해 서버를 직접 시작합니다. Claude Desktop에서는 claude_desktop_config.json을 열고, Cursor에서는 MCP 설정을 여세요.

다음 서버 정의를 추가하세요.

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

-y 인수는 대화형 패키지 설치 확인 없이 npx가 계속 진행하도록 합니다. 구성을 저장한 후 AI 클라이언트를 다시 시작하면 새 MCP 서버를 불러올 수 있습니다.

연결 완료

Roblox Studio를 엽니다.
편집 권한이 있는 플레이스를 엽니다.
이 프로젝트의 Studio 플러그인이 설치되어 활성화되어 있는지 확인합니다.
Claude Desktop 또는 Cursor에 MCP 구성을 저장합니다.
AI 도우미를 다시 시작합니다.
클라이언트에서 사용할 수 있는 MCP 통합 또는 도구 목록에 roblox-studio 서버가 표시되는지 확인합니다.

기본 사용법

객체 트리 읽기

에이전트가 Studio와 통신할 수 있는지 확인하는 비파괴적 요청부터 시작하세요.

내 Roblox 플레이스의 객체 트리를 보여 줘.

에이전트는 MCP 서버를 호출하고 Studio에서 계층 구조를 가져온 다음 결과를 요약하거나 표시해야 합니다. 플레이스를 변경할 필요가 없으므로 첫 번째 테스트로 유용합니다.

인스턴스 검사

계층 구조를 확인한 후 도우미에게 특정 객체를 검사하도록 요청하세요. 예를 들면 다음과 같습니다.

객체 트리에서 SpawnLocation을 찾아 속성을 보여 줘.

가능하면 정확한 인스턴스 이름을 사용하세요. 같은 이름의 객체가 여러 개라면 도우미가 원하는 인스턴스를 식별할 수 있도록 계층 구조상의 위치를 함께 지정하세요.

Lua 스크립트 작업

서버는 AI 에이전트를 통해 Lua 스크립트를 생성하고 읽고 업데이트할 수 있습니다. 신중한 작업 흐름은 기존 스크립트를 읽는 것부터 시작합니다.

ServerScriptService 아래의 스크립트를 읽고 어떤 작업을 하는지 설명해 줘. 아무것도 변경하지 마.

현재 구현을 이해한 후에는 범위를 명확히 정한 수정을 요청하세요.

선택한 Lua 스크립트에 명확한 오류 처리를 추가하도록 업데이트해 줘. 적용하기 전에 제안된 변경 사항을 보여 줘.

정확한 도구와 확인 과정은 연결된 MCP 클라이언트에 따라 달라집니다. 수정을 허용하기 전에 생성된 Lua 코드를 주의 깊게 검토하세요.

플레이 테스트 제어

Roblox Studio MCP에는 플레이 테스트를 실행하고 일시 중지하고 중지하는 제어 기능이 포함되어 있습니다. 요청 예시는 다음과 같습니다.

현재 플레이스의 플레이 테스트를 시작해 줘.

현재 플레이 테스트를 일시 중지해 줘.

플레이 테스트를 중지해 줘.

서버가 세션을 검색하고 통신할 수 있도록 이 명령을 실행하는 동안 Roblox Studio를 열어 두세요.

서버 구성

이 프로젝트는 네트워크, 안전, 로깅 및 시간 제한 동작을 제어하는 환경 변수를 제공합니다.

RBX_MCP_PORT는 WebSocket 포트를 설정합니다. 기본값은 44755입니다.
RBX_MCP_SAFE_MODE를 true로 설정하면 파괴적인 작업을 비활성화할 수 있습니다.
RBX_MCP_LOG_LEVEL에는 debug, info, warn 또는 error를 사용할 수 있습니다.
RBX_MCP_TIMEOUT은 요청 제한 시간을 밀리초 단위로 설정합니다.

읽기 전용 탐색 사용

익숙하지 않은 플레이스의 구조를 파악하거나 아키텍처 정보만 필요한 경우 안전 모드를 활성화하세요.

RBX_MCP_SAFE_MODE=true

안전 모드를 활성화하면 파괴적인 작업을 허용하지 않고 어시스턴트를 탐색에 사용할 수 있습니다. 여러 Studio 인스턴스가 열려 있고 의도하지 않은 변경의 위험을 줄이려는 경우에도 이 설정을 권장합니다.

로깅으로 문제 해결

클라이언트가 연결되지 않거나 요청 시간이 초과되면 로그 수준을 일시적으로 높이세요.

RBX_MCP_LOG_LEVEL=debug

검색 및 통신 문제를 조사할 때는 디버그 로깅을 사용한 다음 info, warn 또는 error로 되돌리세요.

요청 제한 시간 조정

규모가 큰 플레이스나 작업 속도가 느린 경우 더 긴 요청 시간이 필요할 수 있습니다. RBX_MCP_TIMEOUT을 원하는 밀리초 단위 기간으로 설정하세요. README에서는 특정 값을 권장하지 않으므로 작업과 환경에 따라 신중하게 조정하세요.

고급 워크플로 팁

읽기 전용 요청부터 시작: 에이전트에게 편집을 요청하기 전에 객체 트리를 가져오고 속성을 확인하세요.
모든 변경의 범위 지정: 정확한 스크립트나 인스턴스의 이름을 지정하고 의도한 결과를 설명하세요.
미리 보기 요청: 적용하기 전에 어시스턴트에게 제안된 Lua 또는 속성 변경 사항을 설명해 달라고 요청하세요.
감사에 안전 모드 사용: 아키텍처를 분석하거나 익숙하지 않은 프로젝트를 검토할 때 RBX_MCP_SAFE_MODE=true로 설정하세요.
여러 세션에 주의: 서버는 열려 있는 여러 Studio 인스턴스를 자동으로 검색할 수 있습니다. 사용하려는 플레이스를 명확히 지정하고 탐색 중에는 안전 모드를 활성화된 상태로 유지하세요.
복구 옵션 유지: AI 지원 편집을 수행하기 전에 플레이스를 저장하고 평소 사용하는 버전 관리 또는 백업 워크플로를 이용하세요.
명시적인 프롬프트 사용: 각 작업을 더 쉽게 검토할 수 있도록 검사, 수정, 플레이테스트를 별도의 요청으로 나누세요.

문제 해결 체크리스트

Roblox Studio가 열려 있고 해당 플레이스에 대한 편집 권한이 있는지 확인하세요.
필요한 Lua 플러그인이 설치되어 활성화되어 있는지 확인하세요.
MCP 클라이언트 구성 파일의 JSON이 유효한지 확인하세요.
MCP 설정을 변경한 후 Claude Desktop 또는 Cursor를 다시 시작하세요.
클라이언트 프로세스에서 Node.js와 npx를 사용할 수 있는지 확인하세요.
기본 WebSocket 포트 44755를 사용할 수 있는지 확인하세요.
더 많은 진단 정보를 수집하려면 RBX_MCP_LOG_LEVEL=debug로 설정하세요.
정상적인 요청에 더 많은 시간이 필요한 경우 RBX_MCP_TIMEOUT을 늘리세요.

결론

Roblox Studio MCP는 Roblox 개발 환경과 MCP 호환 AI 어시스턴트 사이를 연결합니다. 구성하면 객체 트리를 노출하고, 속성을 확인하며, Lua 스크립트를 편집하고, 플레이테스트를 제어할 수 있습니다. 읽기 전용 탐색부터 시작하고 생성된 변경 사항을 모두 확인하며, 플레이스를 수정하지 않고 분석하려는 경우에는 항상 안전 모드를 사용하세요.