Configuración de Xcode

Xcode puede ejecutar agentes de programación como Claude Code o Codex dentro de su propia pantalla. Si le conecta aquí el servidor MCP de WEEGLOO, el agente que se ejecuta dentro de Xcode puede crear, leer y modificar directamente recursos como Content Type, Content o Media. La herramienta de instalación instala también las Skills y Rules junto con el servidor MCP, para que el agente use la API de WEEGLOO de la forma prevista. Las Skills son guías sobre cómo realizar bien una tarea concreta, y las Rules son reglas que se deben respetar en todas las tareas. A continuación, elija el agente que va a usar dentro de Xcode, configúrelo todo de una vez con la herramienta de instalación y complete la autenticación de la conexión MCP.

Los detalles sobre el servidor MCP y sobre las Skills y Rules se tratan, respectivamente, en las páginas MCP y Skills y Rules. Esta página trata únicamente cómo conectarlo a Xcode.

Requisitos previos

Para ejecutar el comando de instalación de más abajo necesita Node.js. Primero, compruebe con los siguientes comandos si está instalado y si la versión es 18 o superior.

Terminal

node --version # v18 o superior está bien npx --version # si aparece la versión, está bien

Si Node.js está instalado pero npx no lo está, actualice npm a la última versión con el siguiente comando. Al actualizar npm, se instala también npx.

Terminal

npm install -g npm@latest

Si Node.js no está instalado o la versión es baja, instale Node.js con el método adecuado para su sistema operativo.

Terminal

brew install node

Si no tiene Homebrew, instálelo primero desde brew.sh o descargue Node.js directamente desde nodejs.org.

Terminal

winget install OpenJS.NodeJS.LTS

Si no tiene winget o no lo reconoce, descargue el archivo de instalación LTS desde nodejs.org. Después de instalarlo, debe abrir una nueva terminal.

Los paquetes de la distribución pueden estar desactualizados, así que se recomienda instalarlo con nvm, que se puede usar en varias distribuciones.

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

Si quiere descargar el archivo de instalación directamente, consúltelo en nodejs.org.

Xcode también debe estar instalado. Si aún no lo tiene, puede descargarlo en Descargar Xcode.

Conectar

La instalación básica consiste en copiar el comando de instalación de esta página y ejecutarlo una vez en la terminal. Para elegir usted mismo cada paso del proceso de instalación, abra Instalación personalizada. La conexión de Xcode siempre se instala en el proyecto actual, así que el comando de instalación se ejecuta dentro de la carpeta del proyecto que va a conectar.

Herramienta de programación

Instalar MCP · Skills

Copie el comando de instalación y ejecútelo en la terminal. Debe ejecutarlo sin falta dentro de la carpeta del proyecto que va a conectar.

Terminal

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --location project \ --token <Personal Access Token>

Autenticar MCP

Autentíquese en el orden siguiente.

Ejecute Claude Code en la terminal. Debe ejecutarlo sin falta dentro de la carpeta del proyecto que va a conectar.

Terminal
claude
La primera vez que lo ejecute, es posible que le pregunte si quiere activar los nuevos servidores MCP. En ese caso, compruebe que weegloo y weegloo-upload están marcados y pulse Enter para enviarlo.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Escriba /mcp para abrir la pantalla de gestión de servidores MCP.

Terminal
/mcp
Seleccione weegloo en la lista. Aparece con el estado needs authentication.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

Si no ve los servidores en la lista: si no ve weegloo y weegloo-upload en la lista, puede que no los enviara en la pantalla de activación del paso 2 o que estén desactivados. Cierre Claude Code, escriba el comando de abajo en la terminal y vuelva a ejecutar claude. Cuando aparezca de nuevo la misma pantalla que en el paso 2, envíela con weegloo y weegloo-upload marcados pulsando Enter.
Terminal
claude mcp reset-project-choices
Compruebe que la dirección de conexión es https://ai.weegloo.com/mcp y seleccione Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Al seleccionar Authenticate, se abre en el navegador una página de autenticación de WEEGLOO como la de abajo. Copie el token con el botón Copiar token, péguelo y haga clic en Conectar servidor. Cuando weegloo cambia a connected, ha terminado.

Después de la instalación, debe abrir una nueva sesión de Xcode Agent para que se apliquen los ajustes.

Instalar MCP · Skills

Copie el comando de instalación y ejecútelo en la terminal. Debe ejecutarlo sin falta dentro de la carpeta del proyecto que va a conectar.

Terminal

$ npx weegloo@latest -y \ --agent codex \ --host xcode \ --location project \ --token <Personal Access Token>

Autenticar MCP

Autentíquese en el orden siguiente.

Al ejecutar el comando de abajo en la terminal, se abre una página de autenticación de WEEGLOO en el navegador.

Terminal
codex mcp login weegloo
En la página de autenticación de WEEGLOO que se abre, copie el token con el botón Copiar token de abajo, péguelo y haga clic en Conectar servidor. Si el agente ya estaba en ejecución, debe reiniciarlo tras completar la autenticación para que surta efecto.

Después de la instalación, debe abrir una nueva sesión de Xcode Agent para que se apliquen los ajustes.

Ejecuta npx weegloo de forma interactiva e instala eligiendo usted mismo los elementos que le pregunta.

Herramienta de programación

Ejecutar la herramienta de instalación

Vaya a la carpeta del proyecto que va a conectar y, en esa carpeta, ejecute el comando de abajo y elija por orden los elementos que le pregunta. Donde le pida el token, cópielo con el botón Copiar token de abajo y péguelo. Ejecútelo sin falta dentro de esa carpeta del proyecto.

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← el token copiado ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

Autenticar MCP

Autentíquese en el orden siguiente.

Ejecute Claude Code en la terminal. Debe ejecutarlo sin falta dentro de la carpeta del proyecto que va a conectar.

Terminal
claude
La primera vez que lo ejecute, es posible que le pregunte si quiere activar los nuevos servidores MCP. En ese caso, compruebe que weegloo y weegloo-upload están marcados y pulse Enter para enviarlo.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Escriba /mcp para abrir la pantalla de gestión de servidores MCP.

Terminal
/mcp
Seleccione weegloo en la lista. Aparece con el estado needs authentication.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

Si no ve los servidores en la lista: si no ve weegloo y weegloo-upload en la lista, puede que no los enviara en la pantalla de activación del paso 2 o que estén desactivados. Cierre Claude Code, escriba el comando de abajo en la terminal y vuelva a ejecutar claude. Cuando aparezca de nuevo la misma pantalla que en el paso 2, envíela con weegloo y weegloo-upload marcados pulsando Enter.
Terminal
claude mcp reset-project-choices
Compruebe que la dirección de conexión es https://ai.weegloo.com/mcp y seleccione Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Al seleccionar Authenticate, se abre en el navegador una página de autenticación de WEEGLOO como la de abajo. Copie el token con el botón Copiar token, péguelo y haga clic en Conectar servidor. Cuando weegloo cambia a connected, ha terminado.

Después de la instalación, debe abrir una nueva sesión de Xcode Agent para que se apliquen los ajustes.

Ejecutar la herramienta de instalación

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: **** ← el token copiado ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

Autenticar MCP

Autentíquese en el orden siguiente.

Al ejecutar el comando de abajo en la terminal, se abre una página de autenticación de WEEGLOO en el navegador.

Terminal
codex mcp login weegloo
En la página de autenticación de WEEGLOO que se abre, copie el token con el botón Copiar token de abajo, péguelo y haga clic en Conectar servidor. Si el agente ya estaba en ejecución, debe reiniciarlo tras completar la autenticación para que surta efecto.

Después de la instalación, debe abrir una nueva sesión de Xcode Agent para que se apliquen los ajustes.

Archivo de configuración del servidor MCP

La herramienta de instalación crea y gestiona automáticamente el archivo de configuración, por lo que no es necesario revisarlo directamente. El contenido de más abajo es material de referencia para los usuarios que necesiten la estructura y las rutas concretas del archivo de configuración.

La herramienta de instalación registra el servidor en el archivo de configuración del agente que haya elegido usar dentro de Xcode. La conexión de Xcode siempre se instala en el proyecto actual, así que el archivo también se crea dentro de la carpeta del proyecto. El archivo varía según el agente que elija.

Claude Code: .mcp.json en la carpeta del proyecto (el formato es el mismo que en Configuración de Claude Code)
Codex: .codex/config.toml en la carpeta del proyecto (el formato es el mismo que en Configuración de Codex)

Solo al usarlo dentro de Xcode hay una diferencia. En el env del servidor weegloo-upload, que gestiona los archivos, se incluye también una entrada PATH. Esto es porque Xcode ejecuta el agente con un PATH mínimo y, sin esta entrada, no puede encontrar el npx necesario para ejecutar el servidor. En el caso de Claude Code (.mcp.json), tiene la siguiente forma.

{
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "PATH": "/Users/jiwoo/.nvm/versions/node/v22.14.0/bin:/usr/bin:/bin",
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

En este PATH se incrusta tal cual la ubicación del Node con el que se ejecutó la instalación. Si actualiza Node a una nueva versión, esta ruta deja de coincidir, así que, después de actualizar, vuelva a ejecutar la herramienta de instalación para renovar el valor.

Skills y Rules

Las Skills y Rules también siguen el método del agente que elija. Para conocer las ubicaciones concretas, consulte las secciones de Skills y Rules de Configuración de Claude Code y Configuración de Codex.

Qué hacer a continuación

MCP: trata los contenidos que sirven de base para la conexión, como los grupos de servidores y el servidor de subida de archivos.
Skills y Rules: trata qué son las Skills y Rules que la herramienta de instalación instala junto con lo demás.
Mantenerlo al día: trata cómo poner al día las Skills y Rules instaladas.
Migrar páginas estáticas con IA: sigue el flujo para migrar páginas reales a un servicio basado en contenido mediante el MCP conectado.