Weegloo Docs - Configuração do Xcode

O Xcode pode executar agentes de programação como o Claude Code ou o Codex dentro da sua própria tela. Ao conectar o servidor MCP do WEEGLOO a ele, o agente que roda dentro do Xcode passa a criar, ler e modificar diretamente recursos como Content Type, Content e Media. Abaixo, escolha o agente que você vai usar dentro do Xcode, configure tudo de uma vez com a ferramenta de instalação e, depois, basta concluir a autenticação.

A explicação sobre o MCP em si, os grupos de servidores e o servidor de upload de arquivos está em MCP. Esta página trata apenas das etapas de conexão ao Xcode.

Pré-requisitos

Para executar os comandos de instalação abaixo, você precisa do Node.js. Primeiro, verifique se ele está instalado e se a versão é 18 ou superior com os comandos a seguir.

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. Ao atualizar o npm, o npx é instalado 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 usando o 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.

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

Conectar

Escolha o agente que você vai usar dentro do Xcode e siga o guia abaixo. Como a conexão do Xcode é sempre instalada no projeto atual, execute o comando de instalação dentro da pasta do projeto que você quer conectar.

Agente para usar no Xcode

Instalar MCP · 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 claude \ --host xcode \ --token wgl_••••••••••••

Autentique o MCP

Autentique na ordem abaixo.

1.Execute o Claude Code no terminal. Execute-o obrigatoriamente dentro da pasta do projeto que você quer conectar.
Terminal
claude
2.Na primeira execução, o Claude Code pode perguntar quais novos servidores MCP ativar. Se isso acontecer, confirme que weegloo e weegloo-upload estão marcados e pressione Enter para enviar.
Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
3.Digite /mcp para abrir a tela de gerenciamento de servidores MCP.
Terminal
/mcp
4.Selecione weegloo na lista. Ele aparece como needs authentication.
Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected
Se os servidores não aparecerem na lista
Se weegloo e weegloo-upload não aparecerem na lista, talvez você não os tenha enviado na tela de ativação do passo 2, ou eles estejam desativados. Feche o Claude Code, digite o comando abaixo no terminal e execute claude novamente. Quando a mesma tela do passo 2 aparecer de novo, confirme que weegloo e weegloo-upload estão marcados e pressione Enter para enviar.
Terminal
claude mcp reset-project-choices
5.Confirme que a URL é https://ai.weegloo.com/mcp e escolha Authenticate.
Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
6.Ao escolher Authenticate, uma página de autenticação da WEEGLOO como a de baixo abre no navegador. Copie o token com o botão Copiar token, cole-o e clique em Conectar servidor. Quando weegloo mudar para connected, está concluído.

Após instalar, abra uma nova sessão do Xcode Agent para que ele carregue a configuração.

Conferir o arquivo de configuração diretamente

A ferramenta de instalação cria e gerencia o arquivo de configuração automaticamente, então você não precisa conferi-lo diretamente. 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 o servidor no arquivo de configuração do agente que você escolheu usar dentro do Xcode. Como a conexão do Xcode é sempre instalada no projeto atual, o arquivo também é criado dentro da pasta do projeto. O arquivo varia conforme o agente escolhido.

Claude Code: .mcp.json na pasta do projeto (o formato é o mesmo de Configurar o Claude Code)
Codex: .codex/config.toml na pasta do projeto (o formato é o mesmo de Configuração do Codex)

Há apenas uma diferença quando o uso é dentro do Xcode. No env do servidor weegloo-upload, que lida com arquivos, entra também um item PATH. Isso porque o Xcode executa o agente com um PATH mínimo e, sem esse item, ele não encontra o npx necessário para executar o servidor. No caso do Claude Code (.mcp.json), o formato é o seguinte.

{
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "PATH": "/Users/jiwoo/.nvm/versions/node/v22.14.0/bin:/usr/bin:/bin",
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

Nesse PATH fica gravada, tal como está, a localização do Node com que a instalação foi executada. Se você atualizar o Node para uma nova versão, esse caminho deixa de corresponder, então, depois de atualizar, execute a ferramenta de instalação novamente para atualizar o valor.

Próximos passos

MCP: trata do conteúdo que serve de base para a 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 em conjunto.
Migrar páginas estáticas com IA: acompanha o fluxo de migrar páginas reais para um serviço baseado em conteúdo usando o MCP conectado.