Configuração do Android Studio

Ao conectar o servidor MCP da WEEGLOO ao Android Studio, o agente de IA embutido pode criar, ler e modificar diretamente recursos como Content Type, Content e Media. Junto com o servidor MCP, a ferramenta de instalação também instala Skills e Rules, para que o agente de IA embutido use a API da WEEGLOO da forma pretendida. Skills são guias que reúnem como executar bem uma tarefa específica, e Rules são regras a seguir em todas as tarefas. Você configura tudo de uma vez com a ferramenta de instalação e, depois, ativa o servidor MCP no Android Studio.

Para detalhes sobre o servidor MCP e sobre Skills e Rules, consulte as páginas MCP e Skills e Rules, respectivamente. Esta página trata apenas de como conectar ao Android Studio.

Pré-requisitos

Executar os comandos de instalação abaixo requer o Node.js. Primeiro, use os comandos a seguir para verificar se ele está instalado e se a versão é 18 ou superior.

Terminal
node --version # v18 ou superior está OK npx --version # OK se uma versão for exibida

Se o Node.js estiver instalado, mas o npx não, atualize o npm para a versão mais recente com o comando abaixo. Atualizar o npm instala o npx junto.

Terminal
npm install -g npm@latest

Se o Node.js não estiver instalado ou a versão for muito antiga, instale o Node.js pelo método adequado ao seu sistema operacional.

Terminal
brew install node

Se você não tiver o Homebrew, instale-o primeiro em brew.sh ou baixe o Node.js diretamente em nodejs.org.

Terminal
winget install OpenJS.NodeJS.LTS

Se o winget estiver ausente ou não for reconhecido, baixe o instalador LTS em nodejs.org. Após instalar, você precisa abrir um novo terminal.

Os pacotes das distribuições podem estar desatualizados, então recomendamos instalar com o nvm, que funciona em várias distribuições.

Terminal
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

Para baixar o instalador diretamente, consulte nodejs.org.

O Android Studio também precisa estar instalado. Se você ainda não o tem, pode baixá-lo em Baixar o Android Studio.

Conectar

A instalação básica consiste em copiar o comando de instalação desta página e executá-lo uma vez no terminal. Para escolher você mesmo cada etapa do processo de instalação, abra Instalação personalizada. Depois de instalar, você conclui a conexão ativando o servidor nas configurações do Android Studio.

Desaconselhamos fortemente usar o Android Studio para a integração com a Weegloo

O agente de IA embutido do Android Studio (Gemini) pode ser usado para tarefas de UI. Porém, em tarefas de código como a integração com a Weegloo, ele é muito instável devido a problemas de desempenho da IA, então recomendamos fortemente usar outro agente de IA, como o Claude Code ou o Codex. Verificado na versão 2026.1.1 Patch 2 e em versões anteriores.

1

Instalar MCP e Skills

Copie o comando de instalação e execute-o no terminal. Execute-o obrigatoriamente dentro da pasta do projeto que você quer conectar.

Terminal
$ npx weegloo@latest -y \ --agent androidstudio \ --token <Personal Access Token>
2

Autenticar a conexão MCP

Depois de concluir a instalação, você precisa ativar o servidor MCP no Android Studio.

  1. Vá para Settings → Tools → AI → MCP Servers e clique na aba JSON View.

  2. Marque Enable MCP Servers.

  3. Verifique se weegloo e weegloo-upload estão na configuração.

  4. Clique em Apply para aplicar a configuração. Você pode confirmar que a conexão foi bem-sucedida pela notificação que aparece informando que houve conexão com weegloo e weegloo-upload.

Instale executando o npx weegloo de forma interativa, escolhendo você mesmo os itens solicitados.

1

Executar a ferramenta de instalação

Vá até a pasta do projeto que você quer conectar e, nessa pasta, execute o comando abaixo e escolha os itens solicitados um a um. Onde ele pedir o token, copie o token com o botão Copiar token abaixo e cole-o. Execute-o obrigatoriamente dentro dessa pasta do projeto.

Terminal
npx weegloo@latest
Terminal
✔ Select your IDE: Android Studio ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token copiado ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!
2

Autenticar a conexão MCP

Depois de concluir a instalação, você precisa ativar o servidor MCP no Android Studio.

  1. Vá para Settings → Tools → AI → MCP Servers e clique na aba JSON View.

  2. Marque Enable MCP Servers.

  3. Verifique se weegloo e weegloo-upload estão na configuração.

  4. Clique em Apply para aplicar a configuração. Você pode confirmar que a conexão foi bem-sucedida pela notificação que aparece informando que houve conexão com weegloo e weegloo-upload.

Arquivo de configuração do servidor MCP

A ferramenta de instalação cria e gerencia o arquivo de configuração automaticamente, então você não precisa verificá-lo por conta própria. O conteúdo abaixo é material de referência para quem precisa da estrutura e dos caminhos concretos do arquivo de configuração.

A ferramenta de instalação registra os servidores em mcp.json, dentro do diretório de configuração do Android Studio. O nome desse diretório inclui a versão (por exemplo, AndroidStudio2025.1), e a ferramenta de instalação encontra e usa o diretório mais recente. Os locais por sistema operacional são os seguintes.

  • macOS: ~/Library/Application Support/Google/AndroidStudio<versão>/mcp.json
  • Windows: %APPDATA%\Google\AndroidStudio<versão>\mcp.json
  • Linux: ~/.config/Google/AndroidStudio<versão>/mcp.json

O servidor weegloo conecta-se a https://ai.weegloo.com/mcp por HTTP e usa um Personal Access Token no cabeçalho Authorization para autenticação. O servidor weegloo-upload, que lida com arquivos, roda via npx e usa o mesmo token.

{
  "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>"
      }
    }
  }
}

Para mudar o grupo de servidores, acrescente um valor group ao final do httpUrl do servidor weegloo. Por exemplo, para usar todas as ferramentas, escreva https://ai.weegloo.com/mcp?group=all. Para a composição de ferramentas de cada grupo, consulte Grupos de servidores MCP.

Como o token real fica armazenado diretamente no arquivo de configuração, tenha cuidado para não expor esse arquivo publicamente nem enviá-lo a um repositório compartilhado.

Skills

A ferramenta de instalação organiza cada Skill como um diretório único e o coloca em .android-studio/skills/ na pasta do projeto.

Rules

O Android Studio não tem um conceito separado de Rules. Por isso, a ferramenta de instalação coloca o conteúdo que corresponde às Rules, ou seja, o conteúdo que desempenha o mesmo papel das Rules do Claude Code, no arquivo AGENTS.md na pasta do projeto.

O que fazer a seguir

  • MCP: trata das bases da conexão, como grupos de servidores e o servidor de upload de arquivos.
  • Skills e Rules: trata do que são as Skills e Rules que a ferramenta de instalação instala junto.
  • Manter atualizado: trata de como manter atualizadas as Skills e Rules instaladas.
  • Migrar uma página estática com IA: siga o fluxo de migrar uma página real para um serviço baseado em conteúdo com a conexão MCP que você configurou.