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 (abre em uma nova aba) ou baixe o Node.js diretamente em nodejs.org (abre em uma nova aba).

Terminal
winget install OpenJS.NodeJS.LTS

Se o winget estiver ausente ou não for reconhecido, baixe o instalador LTS em nodejs.org (abre em uma nova aba). 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 (abre em uma nova aba).

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 (abre em uma nova aba).

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
1

Instalar MCP e Skills

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

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

Autenticar a conexão MCP

Autentique na ordem abaixo.

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

    Terminal
    codex mcp login weegloo

  2. Na página de autenticação da WEEGLOO que abriu, confira se a conta conectada é a correta e clique em Permitir. 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.

    Se você não tiver feito login na WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço da WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    Tela de autenticação da WEEGLOO

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 codex \ --location project
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

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

    Terminal
    codex mcp login weegloo

  2. Na página de autenticação da WEEGLOO que abriu, confira se a conta conectada é a correta e clique em Permitir. 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.

    Se você não tiver feito login na WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço da WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    Tela de autenticação da WEEGLOO

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

Local de instalação
1

Executar a ferramenta de instalação

Execute o comando abaixo no terminal e escolha os itens solicitados um a um.

Terminal
npx weegloo@latest
Terminal
✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Global … ✔ Installation complete!
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

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

    Terminal
    codex mcp login weegloo

  2. Na página de autenticação da WEEGLOO que abriu, confira se a conta conectada é a correta e clique em Permitir. 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.

    Se você não tiver feito login na WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço da WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    Tela de autenticação da WEEGLOO

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. Execute-o obrigatoriamente dentro dessa pasta do projeto.

Terminal
npx weegloo@latest
Terminal
✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!
2

Autenticar a conexão MCP

Autentique na ordem abaixo.

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

    Terminal
    codex mcp login weegloo

  2. Na página de autenticação da WEEGLOO que abriu, confira se a conta conectada é a correta e clique em Permitir. 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.

    Se você não tiver feito login na WEEGLOO neste navegador, a tela de login abre primeiro e, depois de fazer login, você volta para a página de autenticação. Se você ainda não aceitou os Termos de Serviço da WEEGLOO ou se eles foram alterados, também aparece a caixa de seleção para aceitar os Termos de Serviço. Nesse caso, marque essa caixa e clique em Permitir.

    Tela de autenticação da WEEGLOO

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. Ao fazer upload, o agente obtém um token de upload do servidor weegloo e o envia ao servidor weegloo-upload junto com os arquivos. 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"

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.