Weegloo Docs - Android Studio 설정

Android Studio에 WEEGLOO MCP 서버를 연결하면, 내장 AI 에이전트가 Content Type·Content·Media 같은 리소스를 직접 만들고 읽고 수정할 수 있습니다. 설치 도구로 한 번에 설정한 다음, Android Studio 설정에서 MCP 서버를 켜기만 하면 됩니다.

MCP 자체와 서버 그룹, 파일 업로드 서버에 대한 설명은 MCP에서 다룹니다. 이 페이지는 Android Studio에 연결하는 단계만 다룹니다.

사전 준비

아래 설치 명령을 실행하려면 Node.js가 필요합니다. 먼저 다음 명령으로 설치 여부와 버전이 18 이상인지 확인하세요.

터미널

node --version # v18 이상이면 OK npx --version # 버전이 출력되면 OK

Node.js는 설치되어 있지만 npx가 설치되어 있지 않은 경우, 아래 명령으로 npm을 최신 버전으로 업데이트하세요. npm을 업데이트하면 npx도 함께 설치됩니다.

터미널

npm install -g npm@latest

Node.js가 설치되어 있지 않거나 버전이 낮다면, 사용 중인 운영체제에 맞는 방법으로 Node.js를 설치하세요.

터미널

brew install node

Homebrew가 없다면 brew.sh에서 먼저 설치하거나, nodejs.org에서 Node.js를 직접 다운로드하세요.

Android Studio도 설치되어 있어야 합니다. 아직 없다면 Android Studio 다운로드에서 받을 수 있습니다.

연결하기

다음 가이드를 따라 진행해 주세요. 설치 명령을 실행한 다음, Android Studio 설정에서 서버를 켜 연결을 마칩니다.

Weegloo 연동에는 Android Studio 사용을 강력히 권장하지 않습니다

Android Studio의 내장 AI 에이전트(Gemini)는 UI 작업에는 사용할 수 있습니다. 그러나 Weegloo 연동 같은 코드 작업에서는 AI 성능 문제로 매우 불안정하므로, Claude Code나 Codex 같은 다른 AI 에이전트 사용을 강력히 권장합니다. 2026.1.1 Patch 2 및 이전 버전에서 확인되었습니다.

MCP · Skills 설치하기

설치 명령을 복사해 터미널에서 실행하세요. 반드시 연동할 프로젝트 폴더 안에서 실행해야 합니다.

터미널

$ npx weegloo@latest -y \ --agent androidstudio \ --token wgl_••••••••••••

MCP 인증 연결

설치가 끝나면 Android Studio에서 MCP 서버를 활성화해야 합니다.

1.Settings → Tools → AI → MCP Servers로 이동한 다음, JSON View 탭을 누릅니다.
2.Enable MCP Servers를 체크합니다.
3.설정에 weegloo와 weegloo-upload가 들어 있는지 확인합니다.
4.Apply를 눌러 설정을 적용합니다. weegloo와 weegloo-upload에 연결되었다는 알림이 뜬 것을 통해 연결에 성공한 것을 확인하실 수 있습니다.

설정 파일 직접 확인하기

설치 도구가 설정 파일을 자동으로 생성하고 관리하므로 사용자가 직접 확인하지 않아도 됩니다. 아래 내용은 구체적인 설정 파일 구조와 경로가 필요한 사용자를 위한 참고 자료입니다.

설치 도구는 Android Studio의 설정 디렉터리 안 mcp.json에 서버를 등록합니다. 이 디렉터리 이름에는 버전이 붙으며(예: AndroidStudio2025.1), 설치 도구가 가장 최신 디렉터리를 찾아 씁니다. 운영체제별 위치는 다음과 같습니다.

macOS: ~/Library/Application Support/Google/AndroidStudio<버전>/mcp.json
Windows: %APPDATA%\Google\AndroidStudio<버전>\mcp.json
Linux: ~/.config/Google/AndroidStudio<버전>/mcp.json

weegloo 서버는 HTTP 방식으로 https://ai.weegloo.com/mcp에 연결하고, 인증에 Personal Access Token을 Authorization 헤더로 씁니다. 파일을 다루는 weegloo-upload 서버는 npx로 실행하며 같은 토큰을 씁니다.

{
  "mcpServers": {
    "weegloo": {
      "httpUrl": "https://ai.weegloo.com/mcp",
      "headers": {
        "Authorization": "Bearer <Personal Access Token>"
      },
      "timeout": -1,
      "enabled": true,
      "trust": false,
      "includeTools": [],
      "excludeTools": []
    },
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

서버 그룹을 바꾸려면 weegloo 서버의 httpUrl 끝에 group 값을 붙입니다. 예를 들어 모든 도구를 쓰려면 https://ai.weegloo.com/mcp?group=all로 적습니다. 그룹별 도구 구성은 MCP 서버 그룹을 참고하세요.

설정 파일에 실제 토큰이 그대로 저장되므로, 이 파일을 외부에 공개하거나 공유 저장소에 올리지 않도록 주의합니다.

다음으로 할 일

MCP: 서버 그룹·파일 업로드 서버 등 연결의 바탕이 되는 내용을 다룹니다.
Skills와 Rules: 설치 도구가 함께 설치하는 Skills와 Rules가 무엇인지 다룹니다.
AI로 정적 페이지 옮겨오기: 연결한 MCP로 실제 페이지를 콘텐츠 기반 서비스로 옮기는 흐름을 따라갑니다.