Configuración de Claude Code

Claude Code es un agente de programación que se ejecuta en la terminal. Si le conecta aquí el servidor MCP de WEEGLOO, Claude Code 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 Claude Code 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. Lo configura todo de una vez con la herramienta de instalación y, a continuación, completa 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 Claude Code.

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.

Claude Code también debe estar instalado de modo que se pueda ejecutar en la terminal con el comando claude. Si aún no lo tiene, consulte la guía de instalación de Claude Code.

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.

Ubicación de instalación
1

Instalar MCP · Skills

Copie el comando de instalación y ejecútelo en la terminal.

Terminal
$ npx weegloo@latest -y \ --agent claude \ --token <Personal Access Token>
2

Autenticar MCP

Autentíquese en el orden siguiente.

  1. Ejecute Claude Code en la terminal.

    Terminal
    claude

  2. Escriba /mcp para abrir la pantalla de gestión de servidores MCP.

    Terminal
    /mcp

  3. En la lista, seleccione weegloo. Se muestra con el estado needs authentication.

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

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

  5. 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 cambie a connected, habrá terminado.

    Pantalla de autenticación de WEEGLOO

1

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 \ --location project \ --token <Personal Access Token>
2

Autenticar MCP

Autentíquese en el orden siguiente.

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

    Terminal
    claude

  2. La primera vez que lo ejecute, puede que le pregunte si desea activar los nuevos servidores MCP. En ese caso, compruebe que weegloo y weegloo-upload están marcados y pulse Enter para enviar.

    Terminal
    New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload

  3. Escriba /mcp para abrir la pantalla de gestión de servidores MCP.

    Terminal
    /mcp

  4. En la lista, seleccione weegloo. Se muestra con el estado needs authentication.

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

    Si no ve los servidores en la lista: si weegloo y weegloo-upload no aparecen en la lista, puede que no los haya enviado 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 ejecute de nuevo claude. Cuando vuelva a aparecer la misma pantalla que en el paso 2, envíela con Enter teniendo weegloo y weegloo-upload marcados.

    Terminal
    claude mcp reset-project-choices

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

  6. 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 cambie a connected, habrá terminado.

    Pantalla de autenticación de WEEGLOO

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

Ubicación de instalación
1

Ejecutar la herramienta de instalación

Ejecute el comando de abajo en la terminal 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.

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? Global … ✔ Installation complete!
2

Autenticar MCP

Autentíquese en el orden siguiente.

  1. Ejecute Claude Code en la terminal.

    Terminal
    claude

  2. Escriba /mcp para abrir la pantalla de gestión de servidores MCP.

    Terminal
    /mcp

  3. En la lista, seleccione weegloo. Se muestra con el estado needs authentication.

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

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

  5. 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 cambie a connected, habrá terminado.

    Pantalla de autenticación de WEEGLOO

1

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!
2

Autenticar MCP

Autentíquese en el orden siguiente.

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

    Terminal
    claude

  2. La primera vez que lo ejecute, puede que le pregunte si desea activar los nuevos servidores MCP. En ese caso, compruebe que weegloo y weegloo-upload están marcados y pulse Enter para enviar.

    Terminal
    New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload

  3. Escriba /mcp para abrir la pantalla de gestión de servidores MCP.

    Terminal
    /mcp

  4. En la lista, seleccione weegloo. Se muestra con el estado needs authentication.

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

    Si no ve los servidores en la lista: si weegloo y weegloo-upload no aparecen en la lista, puede que no los haya enviado 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 ejecute de nuevo claude. Cuando vuelva a aparecer la misma pantalla que en el paso 2, envíela con Enter teniendo weegloo y weegloo-upload marcados.

    Terminal
    claude mcp reset-project-choices

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

  6. 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 cambie a connected, habrá terminado.

    Pantalla de autenticación de WEEGLOO

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.

El servidor weegloo se conecta a https://ai.weegloo.com/mcp por HTTP, y el servidor weegloo-upload, que gestiona los archivos, se ejecuta con npx y usa el Personal Access Token para la autenticación.

{
  "mcpServers": {
    "weegloo": {
      "type": "http",
      "url": "https://ai.weegloo.com/mcp"
    },
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

Para cambiar el grupo de servidores, añada el valor group al final de la url del servidor weegloo. Por ejemplo, para usar todas las herramientas, escriba https://ai.weegloo.com/mcp?group=all. Para la composición de herramientas de cada grupo, consulte Grupos de servidores MCP.

Skills

Claude Code admite las Skills como función nativa. La herramienta de instalación coloca cada Skill como un directorio. La instalación global usa ~/.claude/skills/ y la instalación de proyecto usa el .claude/skills/ de la carpeta del proyecto.

Rules

Claude Code admite las Rules como función nativa. La herramienta de instalación coloca cada regla como un archivo .md. La instalación global usa ~/.claude/rules/ y la instalación de proyecto usa el .claude/rules/ de la carpeta del proyecto.

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.