Weegloo Docs - Configuración de Xcode

Xcode puede ejecutar agentes de programación como Claude Code o Codex dentro de su propia pantalla. Si le conecta 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. 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 solo tiene que completar la autenticación.

La explicación de MCP en sí, de los grupos de servidores y del servidor de subida de archivos se trata en MCP. Esta página trata únicamente los pasos para 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.

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

Conectar

Elija el agente que va a usar dentro de Xcode y siga la guía a continuación. La conexión de Xcode siempre se instala en el proyecto actual, así que ejecute el comando de instalación dentro de la carpeta del proyecto que quiera integrar.

Agente para usar en Xcode

Instalar MCP · Skills

Copia el comando de instalación y ejecútalo en la terminal. Asegúrate de ejecutarlo dentro de la carpeta del proyecto que quieres conectar.

Terminal

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --token wgl_••••••••••••

Autentica MCP

Autentícate en el orden indicado abajo.

1.Ejecuta Claude Code en la terminal. Asegúrate de ejecutarlo dentro de la carpeta del proyecto que quieres conectar.
Terminal
claude
2.En la primera ejecución, Claude Code puede preguntar qué servidores MCP nuevos activar. Si lo hace, asegúrate de que weegloo y weegloo-upload estén marcados y pulsa Enter para enviar.
Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
3.Escribe /mcp para abrir la pantalla de gestión de servidores MCP.
Terminal
/mcp
4.Selecciona weegloo en la lista. Aparece como needs authentication.
Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected
Si los servidores no aparecen en la lista
Si no ves weegloo y weegloo-upload en la lista, puede que no los hayas enviado en la pantalla de activación del paso 2, o que estén desactivados. Cierra Claude Code, escribe el comando de abajo en la terminal y vuelve a ejecutar claude. Cuando aparezca de nuevo la misma pantalla que en el paso 2, asegúrate de que weegloo y weegloo-upload estén marcados y pulsa Enter para enviar.
Terminal
claude mcp reset-project-choices
5.Comprueba que la URL sea https://ai.weegloo.com/mcp y elige Authenticate.
Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
6.Al elegir Authenticate se abre en el navegador una página de autenticación de WEEGLOO como la de abajo. Copia el token con el botón Copiar token, pégalo y haz clic en Conectar servidor. Cuando weegloo pase a connected, habrás terminado.

Después de instalar, abre una nueva sesión del Xcode Agent para que tome la configuración.

Revisar directamente el archivo de configuración

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.

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