Configuração do Xcode

O Xcode pode executar agentes de codificação como o Claude Code ou o Codex dentro da própria tela. Ao conectar o servidor MCP do WEEGLOO a ele, o agente que roda dentro do Xcode 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 as Skills e as Rules, ajudando o agente a usar a API do WEEGLOO da maneira pretendida. As Skills são guias sobre como executar bem uma tarefa específica, e as Rules são regras a seguir em todas as tarefas. Abaixo, escolha o agente que você vai usar dentro do Xcode, configure tudo de uma vez com a ferramenta de instalação e conclua a autenticação da conexão MCP.

Os detalhes sobre o servidor MCP e sobre as Skills e as Rules estão, respectivamente, nas páginas MCP e Skills e Rules. Esta página trata apenas de como se conectar 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.

Terminal

winget install OpenJS.NodeJS.LTS

Se o winget não existir ou não for reconhecido, baixe o instalador LTS em nodejs.org. Depois de 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 Xcode também precisa estar instalado. Se você ainda não o tiver, pode baixá-lo em Baixar o Xcode.

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. A conexão do Xcode é sempre instalada no projeto atual, então execute o comando de instalação dentro da pasta do projeto que você quer conectar.

Ferramenta de codificação

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 claude \ --host xcode \ --location project \ --token <Personal Access Token>

Autenticar a conexão MCP

Autentique na ordem abaixo.

Execute o Claude Code no terminal. Execute-o obrigatoriamente dentro da pasta do projeto que você quer conectar.

Terminal
claude
Na primeira execução, ele pode perguntar se você quer ativar os novos servidores MCP. Nesse caso, verifique se 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
Digite /mcp para abrir a tela de gerenciamento dos servidores MCP.

Terminal
/mcp
Na lista, selecione weegloo. Ele aparece com o status 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, pode ser que você não tenha enviado na tela de ativação do passo 2 ou que eles estejam desativados. Encerre o Claude Code, digite o comando abaixo no terminal e execute claude novamente. Quando a mesma tela do passo 2 aparecer de novo, deixe weegloo e weegloo-upload marcados e pressione Enter para enviar.
Terminal
claude mcp reset-project-choices
Verifique se o endereço de conexão é https://ai.weegloo.com/mcp e selecione Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Ao selecionar Authenticate, a página de autenticação do WEEGLOO abre no navegador, como abaixo. 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 a instalação, você precisa abrir uma nova sessão do Xcode Agent para que as configurações tenham efeito.

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 codex \ --host xcode \ --location project \ --token <Personal Access Token>

Autenticar a conexão MCP

Autentique na ordem abaixo.

Ao executar o comando abaixo no terminal, a página de autenticação do WEEGLOO abre no navegador.

Terminal
codex mcp login weegloo
Na página de autenticação do WEEGLOO que abriu, copie o token com o botão Copiar token abaixo, cole-o e clique em Conectar servidor. Um agente que já estava em execução precisa ser reiniciado após a conclusão da autenticação para que as mudanças tenham efeito.

Após a instalação, você precisa abrir uma nova sessão do Xcode Agent para que as configurações tenham efeito.

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

Ferramenta de codificação

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: Claude Code ✔ 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!

Autenticar a conexão MCP

Autentique na ordem abaixo.

Execute o Claude Code no terminal. Execute-o obrigatoriamente dentro da pasta do projeto que você quer conectar.

Terminal
claude
Na primeira execução, ele pode perguntar se você quer ativar os novos servidores MCP. Nesse caso, verifique se 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
Digite /mcp para abrir a tela de gerenciamento dos servidores MCP.

Terminal
/mcp
Na lista, selecione weegloo. Ele aparece com o status 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, pode ser que você não tenha enviado na tela de ativação do passo 2 ou que eles estejam desativados. Encerre o Claude Code, digite o comando abaixo no terminal e execute claude novamente. Quando a mesma tela do passo 2 aparecer de novo, deixe weegloo e weegloo-upload marcados e pressione Enter para enviar.
Terminal
claude mcp reset-project-choices
Verifique se o endereço de conexão é https://ai.weegloo.com/mcp e selecione Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Ao selecionar Authenticate, a página de autenticação do WEEGLOO abre no navegador, como abaixo. 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 a instalação, você precisa abrir uma nova sessão do Xcode Agent para que as configurações tenham efeito.

Executar a ferramenta de instalação

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Codex ✔ 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!

Autenticar a conexão MCP

Autentique na ordem abaixo.

Ao executar o comando abaixo no terminal, a página de autenticação do WEEGLOO abre no navegador.

Terminal
codex mcp login weegloo
Na página de autenticação do WEEGLOO que abriu, copie o token com o botão Copiar token abaixo, cole-o e clique em Conectar servidor. Um agente que já estava em execução precisa ser reiniciado após a conclusão da autenticação para que as mudanças tenham efeito.

Após a instalação, você precisa abrir uma nova sessão do Xcode Agent para que as configurações tenham efeito.

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 o servidor no arquivo de configuração do agente que você escolheu usar dentro do Xcode. A conexão do Xcode é sempre instalada no projeto atual, então o arquivo também é criado dentro da pasta do projeto. O arquivo varia conforme o agente escolhido.

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

Há apenas uma diferença específica de quando você usa dentro do Xcode. Um item PATH é incluído no env do servidor weegloo-upload, que lida com arquivos. 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 Claude Code (.mcp.json), fica com o seguinte formato.

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

Esse PATH incorpora exatamente o local do Node com que você executou a instalação. Se você atualizar o Node para uma nova versão, esse caminho fica incorreto, então, após o upgrade, execute a ferramenta de instalação novamente para atualizar o valor.

Skills e Rules

As Skills e as Rules também seguem exatamente o modo do agente escolhido. Para os locais detalhados, consulte as seções de Skills e Rules em Configuração do Claude Code e Configuração do Codex.

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.