Configuração do Codex

Última atualização: 10 de julho de 2026

O Codex é um agente de programação que você executa no terminal. Ao conectar o servidor MCP do WEEGLOO a ele, o Codex passa a criar, ler e modificar diretamente recursos como Content Type, Content e Media. A forma de conexão é a mesma de outros ambientes. Você configura tudo de uma vez com a ferramenta de instalação e, depois, basta concluir a autenticação no Codex.

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 Codex.

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 Codex também precisa estar instalado de forma que você possa executá-lo no terminal com o comando codex. Se você ainda não o tiver, consulte o guia de instalação do Codex CLI.

Conectar

Escolha o local de instalação e, em seguida, siga o guia abaixo. Para conectar apenas um único projeto, escolha Projeto; para usar em todos os projetos, escolha Global.

1

Instalar MCP · Skills

Copie o comando de instalação e execute-o no terminal.

Terminal
$ npx weegloo@latest -y \ --agent codex \ --token wgl_••••••••••••
2

Autentique o MCP

Autentique na ordem abaixo.

  1. 1.Execute o comando abaixo no terminal — uma página de autenticação da WEEGLOO abre no navegador.
    Terminal
    codex mcp login weegloo
  2. 2.Na página de autenticação da WEEGLOO que abre, copie o token com o botão Copiar token abaixo, cole-o e clique em Conectar servidor. Após autenticar, reinicie o agente se ele já estiver em execuçã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.

O servidor weegloo conecta-se a https://ai.weegloo.com/mcp pelo modo HTTP, e o servidor weegloo-upload, que lida com arquivos, é executado via npx e usa o Personal Access Token na autenticação. Com uma instalação Global, ele é registrado em ~/.codex/config.toml, na sua pasta pessoal; com uma instalação Projeto, em .codex/config.toml, dentro da pasta do projeto.

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"
 
[mcp_servers.weegloo-upload]
command = "npx"
args = ["-y", "weegloo-upload"]
 
[mcp_servers.weegloo-upload.env]
UPLOAD_API_URL = "https://upload.weegloo.com/v1"
AUTH_BEARER_TOKEN = "<Personal Access Token>"

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

Com uma instalação Projeto, a ferramenta de instalação também adiciona uma entrada ao ~/.codex/config.toml, na sua pasta pessoal. O Codex só lê o .codex/config.toml de dentro da pasta em projetos que você tenha marcado como confiáveis. Sem essa entrada, o servidor MCP que você acabou de registrar é ignorado, então a ferramenta de instalação marca o projeto como confiável. No lugar do caminho fica o caminho real da pasta do projeto onde a instalação foi executada.

[projects."/Users/jimin/projects/jeju-shop"]
trust_level = "trusted"

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.