Antigravity CLI에서 WEPPY Roblox AI Toolkit의 WEPPY MCP Server를 사용하는 방법입니다.

Antigravity CLI와 Antigravity IDE는 ~/.gemini/config/mcp_config.json을 global MCP 정본으로 함께 사용합니다.

사전 요구사항

Antigravity CLI 설치됨
Node.js (v18.0.0 이상, npx 사용 가능)
WEPPY Roblox Studio Plugin 설치 완료

WEPPY AI Agent Plugin 설치

WEPPY 설치 페이지의 원라인 installer를 사용하세요. WEPPY AI Agent Plugin 설치에는 Antigravity CLI와 agy plugin 명령이 필요합니다. Installer는 최신 공개 release를 로컬에 staging하고 해당 로컬 payload로 agy plugin install을 실행한 뒤 agy plugin list로 결과를 확인합니다.

GitHub URL을 agy plugin install에 직접 전달하지 마세요. WEPPY AI Agent Plugin 설치를 검증하지 못하면 installer가 shared direct WEPPY MCP Server fallback을 유지합니다.

수동 MCP fallback

글로벌 설정 파일

Antigravity CLI의 글로벌 MCP 설정 파일에 아래 내용을 추가/병합하세요.

OS	경로
macOS / Linux	`~/.gemini/config/mcp_config.json`
Windows	`%USERPROFILE%\.gemini\config\mcp_config.json`

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

프로젝트별 설정

특정 프로젝트에서만 MCP 서버를 쓰고 싶다면 프로젝트 루트의 .agents/mcp_config.json에 같은 JSON을 넣을 수 있습니다.

공개 원라인 installer와 브라우저 installer는 ~/.gemini/config/mcp_config.json을 global fallback으로 사용합니다. 기존 ~/.gemini/antigravity-cli/mcp_config.json은 이관용 legacy 입력이며 신규 등록 경로가 아닙니다.

연결 테스트

Roblox Studio 실행 → Plugins 탭 → WEPPY → Connect

Antigravity CLI에서 다음을 입력:

Roblox Studio에서 현재 선택된 것을 알려줘

CLI 안에서 /mcp 명령으로 MCP 서버 상태를 확인

문제 해결

서버가 시작되지 않을 때

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

npx -y @weppy/roblox-mcp@latest

연결 실패

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

Antigravity CLI 설정