Weegloo Docs - Configuración en otros entornos

Hay muchas herramientas que admiten MCP. Herramientas como Claude, Claude Code, Codex o Cursor cuentan con su propia página de guía específica, y esta página trata el método general para conectar directamente WEEGLOO MCP con las demás herramientas compatibles con MCP.

El servidor y la dirección que vas a conectar son los mismos en cualquier herramienta. Sin embargo, el formato y los nombres de las claves con los que se anota esa información en la configuración varían según la herramienta. Por eso esta página no describe el formato de configuración de una herramienta concreta, sino que explica "qué es lo que se conecta" desde la perspectiva del protocolo MCP. Consulta también la documentación de la herramienta que quieres conectar para conocer la ubicación y el formato reales del archivo de configuración.

Una vez conectado, el agente LLM de esa herramienta realiza en tu lugar, con solo peticiones en lenguaje natural, el trabajo que antes hacía una persona en el estudio de contenido. Basta con que describas de palabra qué quieres crear para que el agente se encargue directamente de tareas como diseñar un Content Type y crear Content o Media.

Requisitos previos

Node.js 18 o superior: necesario para ejecutar localmente el servidor de transferencia de archivos (weegloo-upload). Puedes descargarlo en Descargar Node.js.
Una herramienta compatible con MCP: cualquier herramienta que permita registrar servidores MCP en su configuración se puede conectar del mismo modo. Consulta la ubicación y el formato del archivo de configuración en la documentación de esa herramienta.

Los dos servidores y el transport

WEEGLOO ofrece dos servidores MCP, y ambos usan un transport distinto. Hay principalmente dos formas en que un cliente MCP se conecta a un servidor, y cada uno de los dos servidores de WEEGLOO usa una de ellas.

weegloo: es el servidor principal que crea, lee, modifica y elimina recursos. Es un servidor HTTP remoto y usa el transport Streamable HTTP de MCP. El cliente se conecta con una única dirección de endpoint, https://ai.weegloo.com/mcp, y la autenticación se gestiona mediante OAuth (consulta Autenticación más abajo). El conjunto de herramientas disponibles se define con el valor ?group= que se añade al final de la dirección (consulta MCP).
weegloo-upload: es el servidor que maneja archivos, como al subir Media o desplegar Web Hosting. Es un servidor que se ejecuta localmente y usa el transport stdio de MCP. El cliente levanta directamente el proceso del servidor con el comando npx -y weegloo-upload y se comunica a través de la entrada/salida estándar. Su ejecución requiere Node.js, y la autenticación se realiza con un Personal Access Token que se coloca en una variable de entorno.

La mayoría de las herramientas registran los dos servidores juntos en un mismo archivo de configuración.

Autenticación

Los dos servidores también difieren en el método de autenticación.

weegloo (HTTP remoto): se autentica mediante el estándar OAuth de MCP. No se coloca ningún token en el archivo de configuración.
weegloo-upload (stdio local): sin OAuth, se coloca directamente un Personal Access Token en la variable de entorno AUTH_BEARER_TOKEN.

El servidor weegloo se conecta de forma remota y la autenticación se gestiona con el estándar OAuth de MCP. El flujo es el siguiente:

Cuando la herramienta se conecta por primera vez al servidor weegloo, se abre la página de autenticación de WEEGLOO en el navegador.
En esa página, pega el Personal Access Token que emitas más abajo y aprueba la conexión; con eso finaliza la autenticación.

Como es un método estándar de MCP, en las herramientas modernas que admiten OAuth basta con registrar la dirección del servidor para que esta autenticación se realice automáticamente.

La página de autenticación de WEEGLOO que se abre en el navegador al conectar por primera vez tiene este aspecto:

Pantalla de autenticación de WEEGLOO

Emite un Personal Access Token con el botón de abajo. Pégalo en la página de autenticación anterior y usa ese mismo token también en el AUTH_BEARER_TOKEN de weegloo-upload.

El token solo se emite en el momento en que pulsas el botón de copiar, y puedes revocarlo en cualquier momento desde Weegloo Console. Como el token real se guarda tal cual en el archivo de configuración, ten cuidado de no publicar este archivo externamente ni subirlo a un repositorio compartido.

Ejemplo de configuración

La información que necesitas para trasladar cada servidor a la configuración de la herramienta es la siguiente:

weegloo (HTTP remoto): la indicación de que el transport es HTTP y la dirección de endpoint https://ai.weegloo.com/mcp.
weegloo-upload (stdio local): el comando de ejecución npx y los argumentos -y weegloo-upload, además de las variables de entorno UPLOAD_API_URL y AUTH_BEARER_TOKEN.

Según la herramienta, los nombres de las claves y el formato de archivo con los que se guarda esta información varían. A continuación se muestra un ejemplo del formato .mcp.json de Claude Code. En otras herramientas los nombres de las claves pueden ser distintos, así que mantén los valores tal cual y trasládalos ajustándote al formato de esa herramienta.

{
  "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>"
      }
    }
  }
}

En el lugar de <Personal Access Token> dentro de AUTH_BEARER_TOKEN, coloca el token que copiaste arriba. La clave con la que se anota la dirección del servidor remoto weegloo varía especialmente según la herramienta. Estos son algunos ejemplos:

Herramienta	Formato de configuración	Clave de dirección del `weegloo` remoto
Claude Code · Cursor	JSON	`type: "http"` + `url`
Codex	TOML	`url`
Antigravity	JSON	`serverUrl`
Android Studio	JSON	`httpUrl`

El servidor local weegloo-upload usa en la mayoría de los casos las claves command, args y env con los mismos nombres que en el ejemplo anterior. Sin embargo, en Windows hay herramientas en las que hay que escribir command como cmd y args como ["/c", "npx", "-y", "weegloo-upload"].

Después de guardar la configuración, hay que reiniciar la herramienta o volver a cargar la configuración de MCP para que surta efecto. Si lo necesitas, puedes cambiar el conjunto de herramientas disponibles añadiendo un grupo al final de la dirección de weegloo, como ?group=all (consulta MCP).

Verificar la conexión

Después de reiniciar la herramienta, si en su lista de herramientas MCP aparecen las herramientas de los dos servidores, significa que la conexión se ha establecido.

weegloo: aparecen las herramientas que manejan recursos. Como es un servidor HTTP remoto, al conectar por primera vez se abre la página de autenticación de WEEGLOO en el navegador. Sigue las indicaciones de la pantalla y pega el token que copiaste antes para completar la autenticación.
weegloo-upload: aparecen las herramientas que manejan archivos.

Una vez conectado, basta con pedirle al agente de esa herramienta que cree un Space o un Content Type.

Qué puedes hacer

Una vez conectado, el agente LLM puede realizar directamente las siguientes tareas:

Crear, leer, modificar y eliminar recursos como Organization, Space, Content Type, Content y Media
Desplegar un sitio web estático ya compilado en Web Hosting

Qué hacer a continuación

MCP: trata el panorama completo de la conexión, incluidos los grupos de servidores y el servidor weegloo-upload.
Emitir un Personal Access Token: trata cómo emitir el token que se usará para la conexión.
Migrar una página estática con IA: sigue el flujo para trasladar una página real a un servicio basado en contenido usando el MCP que has conectado.