Antigravity CLI에서 Roblox MCP를 사용하는 방법입니다.
Antigravity CLI는 Gemini CLI, Antigravity / Antigravity IDE와 같은 .gemini 루트를 공유하지만 MCP 설정 파일은 별도로 사용합니다.
사전 요구사항
- Antigravity CLI 설치됨
- Node.js (v18.0.0 이상,
npx사용 가능) - Roblox Studio 플러그인 설치 완료
MCP 서버 등록
글로벌 설정 파일
Antigravity CLI의 글로벌 MCP 설정 파일에 아래 내용을 추가/병합하세요.
| OS | 경로 |
|---|---|
| macOS / Linux | ~/.gemini/antigravity-cli/mcp_config.json |
| Windows | %USERPROFILE%\.gemini\antigravity-cli\mcp_config.json |
{
"mcpServers": {
"weppy-roblox-mcp": {
"command": "npx",
"args": ["-y", "@weppy/roblox-mcp@latest"]
}
}
}
프로젝트별 설정
특정 프로젝트에서만 MCP 서버를 쓰고 싶다면 프로젝트 루트의 .agents/mcp_config.json에 같은 JSON을 넣을 수 있습니다.
공개 원라인 설치와 웹 설치 페이지는 사용자 전체에 적용되는 글로벌 경로(~/.gemini/antigravity-cli/mcp_config.json)를 자동 등록 대상으로 사용합니다.
연결 테스트
- Roblox Studio 실행 → Plugins 탭 → WEPPY → Connect
- Antigravity CLI에서 다음을 입력:
Roblox Studio에서 현재 선택된 것을 알려줘 - CLI 안에서
/mcp명령으로 MCP 서버 상태를 확인
문제 해결
서버가 시작되지 않을 때
MCP 서버를 직접 실행하여 오류를 확인하세요:
npx -y @weppy/roblox-mcp@latest
연결 실패
- Roblox Studio 플러그인이 Connected 상태인지 확인
- 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
- Antigravity CLI에서
/mcp로 서버 상태 확인 - Gemini CLI의
~/.gemini/settings.json또는 Antigravity IDE의 설정 파일과 혼동하지 않았는지 확인