Configuración de Codex

Última actualización: 22 de junio de 2026

Esta página explica cómo conectar el servidor MCP de WEEGLOO en Codex. Una vez conectado, Codex puede consultar, crear y modificar directamente los recursos de WEEGLOO. El flujo completo, los grupos de servidores y el servidor de subida de archivos se tratan en MCP. Esta página describe únicamente los pasos de conexión específicos de Codex.

Requisitos previos

Antes de conectar, debe tener lo siguiente.

  • Codex: Codex debe estar instalado.
  • Node.js 18 o superior: es necesario para ejecutar la herramienta de instalación y el servidor de transferencia de archivos (weegloo-upload). Puede descargarlo en Descargar Node.js.
  • Personal Access Token: se usa para la autenticación. Un Personal Access Token es la llave que una cuenta utiliza para llamar a la API con sus propios permisos. La forma de emitirlo se trata en Emitir un Personal Access Token.

Conectar con la herramienta de instalación

Al usar la herramienta de instalación, el servidor MCP se registra automáticamente en el archivo de configuración de Codex. Ejecute lo siguiente en la carpeta del proyecto.

npx weegloo@latest

Al ejecutarlo, le hará una serie de preguntas. El significado de cada pregunta es el siguiente.

  1. Select plugin version (branch): elige la versión de Skills y Rules. Normalmente se elige latest.
  2. Select your IDE: elija Codex.
  3. What would you like to install?: puede instalar por separado el servidor MCP y los Skills / Rules. Si es la primera instalación, instálelo todo.
  4. Enter your Weegloo Personal Access Token: introduzca el Personal Access Token que ha emitido previamente.
  5. Select the MCP server group: para un uso general, elija default. Los tipos de grupos de servidores se tratan en MCP.
  6. Where would you like to install Codex configuration: para aplicarlo solo al proyecto actual elija Project; para aplicarlo a todos los proyectos elija Global. Según la versión de Codex, la instalación con Project puede no estar disponible; en ese caso, instale con Global.

Cuando termina la instalación, la herramienta de configuración registra el servidor MCP en el archivo de configuración de Codex (config.toml). Si instala con Global, se registra en ~/.codex/config.toml; si instala con Project, se registra en el archivo de configuración de Codex del proyecto.

Iniciar sesión en el servidor MCP

El servidor weegloo se conecta por HTTP y, aparte de la instalación, requiere iniciar sesión una vez. La herramienta de instalación ejecuta este paso de inicio de sesión a continuación. Si no se ejecuta automáticamente, ejecute lo siguiente directamente.

codex mcp login weegloo

Al ejecutarlo, se abre la página de autenticación en el navegador. Cuando termine la autenticación, la conexión con el servidor weegloo quedará completada. El servidor de transferencia de archivos weegloo-upload se autentica con el Personal Access Token incluido en el archivo de configuración, por lo que no necesita este paso de inicio de sesión.

Editar el archivo de configuración directamente

En lugar de la herramienta de instalación, también puede editar directamente el archivo de configuración de Codex (config.toml). El servidor weegloo se conecta por HTTP.

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

Para especificar el grupo de servidores, añada el valor group al final de la dirección. Por ejemplo, para usar todas las herramientas, escríbalo de la siguiente manera.

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

El servidor de transferencia de archivos weegloo-upload se ejecuta mediante un comando y usa el Personal Access Token para la autenticación. En el lugar del token, ponga el Personal Access Token que ha 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>"

Si ha editado el archivo de configuración directamente, reinicie Codex. Después, inicie sesión una vez en el servidor weegloo con el paso Iniciar sesión en el servidor MCP anterior.

Qué hacer a continuación

  • MCP: trata la visión completa de la conexión, como los grupos de servidores y el servidor de subida de archivos.
  • Skills y Rules: trata los Skills y Rules que la herramienta de instalación puede instalar junto con el resto.
  • Migrar páginas estáticas con IA: sigue el flujo para migrar páginas reales a un servicio basado en contenido con el MCP conectado.