VRChat MCP의 개요
VRChat MCP는 GitHub 사용자 sawa-zen이 만든 것으로, 커뮤니티가 문서화한 VRChat API를 통해 MCP 클라이언트가 VRChat 계정에서 작업하게 해 줍니다. 도구는 친구와 알림을 나열하고, 아바타, 월드, 그룹을 검색하며, 친구 요청 보내기, 아바타 변경, 인스턴스 생성, 그룹 가입, 즐겨찾기 추가, 초대 요청 같은 작업을 수행합니다.
MIT 라이선스의 TypeScript로 npm에 vrchat-mcp로 게시되어 있으며 README는 영어, 일본어, 한국어로 제공됩니다. GitHub 스타는 약 71개, 2026년 11월 5일까지 한 주간 npm 다운로드는 33회입니다. 마지막 npm 릴리스인 0.15.0은 2025년 4월 29일에 나왔고, 그 뒤로는 의존성 업데이트 커밋만 있었으며 가장 최근은 2026년 2월 3일입니다.
VRChat MCP 설치 방법
npx vrchat-mcpVRChat MCP, 쓸 만한 가치가 있습니까?
VRChat MCP는 작고 직접적인 래퍼입니다. README에는 친구, 아바타, 월드, 인스턴스, 그룹, 즐겨찾기, 초대, 알림에 걸친 17개 도구가 나오며, 각각 커뮤니티 SDK인 vrchat을 호출해 원본 JSON을 돌려줍니다. 어떤 친구가 온라인인지 같은 질문과 간단한 작업에는 충분합니다. 여러 도구가 계정을 읽기만 하지 않고 변경하므로, 에이전트의 실수는 사용자 이름으로 보낸 친구 요청, 바뀐 아바타, 가입한 그룹이 됩니다.
가장 큰 위험은 인증입니다. README는 보조 명령으로 한 번 로그인한 뒤 받은 인증 쿠키를 VRCHAT_AUTH_TOKEN에 붙여 넣게 하고, 유효 기간이 매우 길다고 경고합니다. MCP 설정을 읽을 수 있는 사람은 누구나 만료될 때까지 계정을 쓸 수 있습니다. 코드는 VRCHAT_PASSWORD와 VRCHAT_TOTP_SECRET 조합도 받는데, 이는 비밀번호와 2단계 인증 비밀을 한곳에 두어 2단계 로그인의 의미를 없앱니다.
플랫폼 위험도 마찬가지로 현실적입니다. VRChat의 Creator Guidelines는 API를 공개 사용용으로 문서화하지 않으며, 엔드포인트는 예고 없이 바뀌고, 문제를 일으키는 애플리케이션은 사용자와 함께 제재를 받는다고 밝힙니다. 또 HTTP 429를 포함한 오류에는 속도 제한과 백오프를 요구합니다. 우리가 소스를 읽은 바로는 재시도나 백오프 로직이 없고, 실패는 오류로 표시되지 않고 일반 텍스트로 돌아옵니다. 서버는 User-Agent 헤더에서 vrc-mcp/0.15.0 뒤에 사용자 이름을 붙여 자신을 밝히지만, 지침은 연락처 정보도 요구합니다. 2025년 4월 이후 기능 작업이 없으므로, API가 호환되지 않게 바뀌면 한동안 고쳐지지 않을 가능성이 큽니다.
제 역할을 하는 곳
친구 목록이 긴 VRChat 단골 사용자
헤드셋을 쓰기 전에 어떤 친구가 어디에 접속해 있는지 확인하기
어시스턴트에게 온라인 친구와 그 인스턴스를 나열하게 한 뒤 그중 하나로 초대를 요청합니다. 무료지만 설정에 둔 토큰이라는 위험이 따릅니다.
VRChat 이벤트 주최자
주간 모임에 쓸 후보 월드를 찾아 저장하기
키워드로 월드를 검색하고 서버가 돌려준 JSON을 검토한 뒤 후보를 즐겨찾기에 추가합니다. VRChat이 속도 제한을 요구하므로 호출 횟수는 적게 유지합니다.
도입 전 확인할 점
- 설정
- npx vrchat-auth-token-checker로 로그인해 토큰을 받은 뒤, VRCHAT_USERNAME과 VRCHAT_AUTH_TOKEN을 설정해 Claude Desktop이나 다른 클라이언트에 npx vrchat-mcp를 추가합니다. 몇 분이면 됩니다.
- 연동
- 커뮤니티가 문서화한 VRChat API를 npm SDK인 vrchat으로 사용합니다. stdio 전용입니다.
- 데이터와 개인정보
- 로컬에서 실행되며 사용자의 세션 쿠키로 VRChat 서버와 통신합니다. 친구 목록, 알림, 초대 메시지는 모델 제공업체로 전송됩니다. 토큰은 오래 유효하므로 설정 파일을 비밀번호처럼 다루십시오.
- 대규모 사용 시 비용
- MIT로 무료이며, 유료 요금제나 호스팅 버전은 없습니다.
- 제한
- 예고 없이 바뀔 수 있는 비공식 API이며, 재시도나 백오프가 없고, 오류는 일반 텍스트로 돌아옵니다. 마지막 npm 릴리스는 2025년 4월 29일의 0.15.0입니다.
좋은 점
- 친구, 월드, 아바타, 그룹, 초대를 다루는 17개 도구
- npx 한 줄로 설치
- 이름과 버전이 담긴 User-Agent 헤더 전송
- README가 영어, 일본어, 한국어로 제공됨
아쉬운 점
- 유효 기간이 긴 인증 토큰을 MCP 설정에 저장
- 선택적으로 비밀번호와 TOTP 비밀을 환경 변수에 둠
- VRChat이 지원하지 않는 비공식 API 기반
- 2025년 4월 0.15.0 이후 릴리스 없음, 속도 제한 없음
추천 대상
계정 위험을 감수하고 누가 온라인인지, 월드 찾기, 즐겨찾기 관리를 일상 언어로 어시스턴트에게 맡기고 싶은 VRChat 단골 사용자.
VRChat MCP: 자주 묻는 질문
- VRChat MCP, 쓸 만한 가치가 있습니까?
- VRChat 계정으로 가는 단순한 다리로는 작동하지만, 거의 유지보수되지 않고, VRChat이 지원하지 않는 API에 기대며, 비밀번호나 다름없는 세션 토큰이 필요합니다. 평점은 5점 만점에 3.0점입니다.
- VRChat MCP의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. VRChat 계정이 필요합니다.
- VRChat MCP의 단점은 무엇입니까?
- 유효 기간이 긴 인증 토큰을 MCP 설정에 저장; 선택적으로 비밀번호와 TOTP 비밀을 환경 변수에 둠; VRChat이 지원하지 않는 비공식 API 기반; 2025년 4월 0.15.0 이후 릴리스 없음, 속도 제한 없음.
- VRChat MCP에 적합한 사람은 누구입니까?
- 계정 위험을 감수하고 누가 온라인인지, 월드 찾기, 즐겨찾기 관리를 일상 언어로 어시스턴트에게 맡기고 싶은 VRChat 단골 사용자.
- 팀이나 프로덕션 환경에서 VRChat MCP의 비용은 얼마입니까?
- MIT로 무료이며, 유료 요금제나 호스팅 버전은 없습니다.
- VRChat MCP에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 실행되며 사용자의 세션 쿠키로 VRChat 서버와 통신합니다. 친구 목록, 알림, 초대 메시지는 모델 제공업체로 전송됩니다. 토큰은 오래 유효하므로 설정 파일을 비밀번호처럼 다루십시오.
답변 확인일: 2026년 11월 6일.