Configuração do Codex

O Codex é um agente de codificação que roda no terminal. Ao conectar o servidor MCP da WEEGLOO a ele, o Codex 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 Codex 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, conclui a autenticação da conexão MCP.

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

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

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.

Local de instalação

Instalar MCP e Skills

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

Terminal

$ npx weegloo@latest -y \ --agent codex \ --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 da WEEGLOO abre no navegador.

Terminal
codex mcp login weegloo
Na página de autenticação da 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.

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 \ --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 da WEEGLOO abre no navegador.

Terminal
codex mcp login weegloo
Na página de autenticação da 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.

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

Local de instalação

Executar a ferramenta de instalação

Execute o comando abaixo no terminal 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.

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? Global … ✔ Installation complete!

Autenticar a conexão MCP

Autentique na ordem abaixo.

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

Terminal
codex mcp login weegloo
Na página de autenticação da 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.

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

Autenticar a conexão MCP

Autentique na ordem abaixo.

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

Terminal
codex mcp login weegloo
Na página de autenticação da 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.

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.

O servidor weegloo conecta-se a https://ai.weegloo.com/mcp por HTTP, enquanto o servidor weegloo-upload, que lida com arquivos, roda via npx e usa um Personal Access Token para autenticação. Com uma instalação Global, ele é registrado em ~/.codex/config.toml na sua pasta pessoal, e com uma instalação de 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 um valor group ao final da 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 de cada grupo, consulte Grupos de servidores MCP.

Com uma instalação de Projeto, a ferramenta de instalação também adiciona uma entrada em ~/.codex/config.toml na sua pasta pessoal. O Codex lê o .codex/config.toml dentro de uma pasta apenas para os projetos em que confia. Sem essa entrada, os servidores MCP que você acabou de registrar são ignorados, então a ferramenta de instalação marca esse projeto como confiável. O espaço do caminho contém o caminho real da pasta do projeto onde você executou a instalação.

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

Skills

A ferramenta de instalação coloca cada Skill como um diretório único dentro de .agents/skills/. Uma instalação global usa ~/.agents/skills/, e uma instalação de projeto usa .agents/skills/ na pasta do projeto; o Codex lê as Skills nesse local.

Rules

O Codex 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. Uma instalação global usa ~/.codex/AGENTS.md, e uma instalação de projeto usa o 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.