Configuração do Codex

Última atualização: 22 de junho de 2026

Esta página explica como conectar o servidor MCP do WEEGLOO no Codex. Uma vez conectado, o Codex pode consultar, criar e modificar diretamente os recursos do WEEGLOO. O fluxo completo, os grupos de servidores e o servidor de upload de arquivos são tratados em MCP. Esta página descreve apenas as etapas de conexão específicas do Codex.

Pré-requisitos

Antes de conectar, você precisa ter o seguinte.

  • Codex: o Codex deve estar instalado.
  • Node.js 18 ou superior: necessário para executar a ferramenta de instalação e o servidor de transferência de arquivos (weegloo-upload). Você pode obtê-lo em Download do Node.js.
  • Personal Access Token: usado para autenticação. O Personal Access Token é a chave que a conta usa para chamar a API com suas próprias permissões. O método de emissão é tratado em Emitir um Personal Access Token.

Conectar com a ferramenta de instalação

Ao usar a ferramenta de instalação, o servidor MCP é registrado automaticamente no arquivo de configuração do Codex. Na pasta do projeto, execute o seguinte.

npx weegloo@latest

Ao executar, ele faz perguntas em sequência. O significado de cada pergunta é o seguinte.

  1. Select plugin version (branch): escolhe a versão de Skills e Rules. Em geral, escolha latest.
  2. Select your IDE: escolha Codex.
  3. What would you like to install?: você pode instalar o servidor MCP e Skills / Rules separadamente. Se for a primeira instalação, instale tudo.
  4. Enter your Weegloo Personal Access Token: insira o Personal Access Token emitido previamente.
  5. Select the MCP server group: para uso geral, escolha default. Os tipos de grupo de servidores são tratados em MCP.
  6. Where would you like to install Codex configuration: para aplicar apenas ao projeto atual, escolha Project; para aplicar a todos os projetos, escolha Global. Dependendo da versão do Codex, a instalação Project pode não ser suportada, e nesse caso instale como Global.

Quando a instalação termina, a ferramenta de configuração registra o servidor MCP no arquivo de configuração do Codex (config.toml). Se você instalar como Global, ele é registrado em ~/.codex/config.toml; se instalar como Project, ele é registrado no arquivo de configuração do Codex do projeto.

Fazer login no servidor MCP

O servidor weegloo conecta via HTTP e, além da instalação, requer um login único. A ferramenta de instalação executa esta etapa de login em seguida. Se ela não for executada automaticamente, execute diretamente o seguinte.

codex mcp login weegloo

Ao executar, uma página de autenticação abre no navegador. Quando você conclui a autenticação, a conexão com o servidor weegloo é finalizada. O servidor de transferência de arquivos weegloo-upload autentica com o Personal Access Token colocado no arquivo de configuração, portanto esta etapa de login não é necessária.

Editar o arquivo de configuração diretamente

Em vez da ferramenta de instalação, você também pode editar diretamente o arquivo de configuração do Codex (config.toml). O servidor weegloo conecta via HTTP.

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"

Para especificar o grupo de servidores, adicione o valor group ao final do endereço. Por exemplo, para usar todas as ferramentas, escreva o seguinte.

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp?group=all"

O servidor de transferência de arquivos weegloo-upload é executado por comando e usa o Personal Access Token para autenticação. No lugar do token, coloque o Personal Access Token emitido.

[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>"

Se você editou o arquivo de configuração diretamente, reinicie o Codex. Em seguida, faça login uma vez no servidor weegloo pela etapa Fazer login no servidor MCP acima.

Próximos passos

  • MCP: trata da visão geral completa da conexão, incluindo grupos de servidores e o servidor de upload de arquivos.
  • Skills e Rules: trata das Skills e Rules que a ferramenta de instalação pode instalar junto.
  • 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.