WEPPY

Antigravity CLI 설정

Antigravity CLI에서 Roblox MCP를 사용하는 방법.

Antigravity CLI에서 Roblox MCP를 사용하는 방법입니다.

Antigravity CLI는 Gemini CLI, Antigravity / Antigravity IDE와 같은 .gemini 루트를 공유하지만 MCP 설정 파일은 별도로 사용합니다.

사전 요구사항

  1. Antigravity CLI 설치됨
  2. Node.js (v18.0.0 이상, npx 사용 가능)
  3. 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)를 자동 등록 대상으로 사용합니다.

연결 테스트

  1. Roblox Studio 실행 → Plugins 탭 → WEPPYConnect
  2. Antigravity CLI에서 다음을 입력:
    Roblox Studio에서 현재 선택된 것을 알려줘
  3. CLI 안에서 /mcp 명령으로 MCP 서버 상태를 확인

문제 해결

서버가 시작되지 않을 때

MCP 서버를 직접 실행하여 오류를 확인하세요:

npx -y @weppy/roblox-mcp@latest

연결 실패

  • Roblox Studio 플러그인이 Connected 상태인지 확인
  • 포트 3002가 방화벽에 의해 차단되지 않았는지 확인
  • Antigravity CLI에서 /mcp로 서버 상태 확인
  • Gemini CLI의 ~/.gemini/settings.json 또는 Antigravity IDE의 설정 파일과 혼동하지 않았는지 확인