Huxly

Conecta Claude Code, Cursor, Windsurf, ChatGPT, Codex o Antigravity directamente a tus proyectos de Huxly. Construye con tu propia suscripción de IA.

---

El Conector de IA te permite apuntar tus herramientas de IA existentes — Claude Code, Cursor, Windsurf, ChatGPT, Codex, Antigravity — directamente a tus proyectos de Huxly. Tu IA lee archivos reales, envía ediciones, inicia el sandbox, observa la compilación y te entrega un enlace de vista previa en vivo. Toda la inferencia se ejecuta en tu propia suscripción. Huxly solo proporciona la infraestructura.

Requisito de plan: El Conector de IA está disponible en los planes Developer, Business y Max. Los usuarios gratuitos pueden conectarse después de actualizar en huxly.app/pricing.

---

Combínalo con el MCP de Supabase

El conector de Huxly maneja los archivos de tu aplicación, tu backend y los despliegues. Deliberadamente nunca lee tu base de datos.

Añade el servidor MCP propio de Supabase junto a él y tu IA obtiene ambos: lee tu esquema real desde Supabase mientras escribe código compatible a través de Huxly. Útil al construir un backend, ya que puede ver qué tablas ya existen en lugar de inferirlas de los archivos de migración.

Ambos se ejecutan a la vez — apunta tu herramienta al endpoint de Huxly y al de Supabase, y la IA elige el que necesite.

---

Cómo funciona

Hay dos formas de conectarse, y la correcta depende de tu herramienta.

Inicia sesión con Huxly (OAuth). Claude.ai y ChatGPT pueden instalar Huxly desde sus propios directorios. Haces clic en Conectar, inicias sesión en Huxly, apruebas el acceso y listo — sin necesidad de generar, pegar o rotar claves. Esta es la ruta más fácil y la que debes usar si tu herramienta la ofrece.

Clave API. Cualquier otro cliente MCP — Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Warp, Antigravity, Codex — se autentica con una clave API de Huxly que generas una vez y colocas en un archivo de configuración.

Los tres endpoints, para referencia:

Endpoint	Usado por	Autenticación
https://huxly.app/api/mcp	La mayoría de los clientes MCP	Authorization: Bearer YOUR_API_KEY
https://huxly.app/api/mcp/stream	Codex — su transporte es más estricto	?key=YOUR_API_KEY
https://huxly.app/api/mcp/v2	Instalaciones desde directorio de Claude.ai y ChatGPT	OAuth

Solo necesitas preocuparte por esto si configuras un cliente manualmente. Las instalaciones desde directorio lo manejan por ti.

---

Paso 1 — Obtén tu clave API

Omite esto si conectas Claude.ai o ChatGPT a través de sus directorios — esos usan OAuth y no necesitan clave.

1. Abre Configuración de Huxly
2. Abre la pestaña MCP
3. Haz clic en Generar clave API
4. Copia la clave — se muestra una sola vez

Mantén esta clave privada. Tiene acceso completo a todos tus proyectos de Huxly.

---

Configuración por herramienta

Claude.ai (navegador, escritorio, móvil)

Huxly está listado en el Directorio de Conectores de Claude, por lo que esta es una instalación de un clic sin clave API.

1. Abre Huxly en el directorio de Claude
2. Haz clic en Conectar
3. Inicia sesión en Huxly y aprueba el acceso

Inicia una nueva conversación y pide a Claude que liste tus proyectos de Huxly. Funciona igual en Claude Desktop, móvil y Cowork — conéctate una vez y sigue a tu cuenta.

Claude Code es diferente. Ejecuta su propio inicio de sesión en tu máquina y no puede usar el conector de directorio. Usa la configuración con clave API a continuación.

Claude Code CLI

Añade a tu ~/.claude/claude_desktop_config.json (o claude_code_config.json):

{
  "mcpServers": {
    "huxly": {
      "type": "http",
      "url": "https://huxly.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Reinicia Claude Code. Ejecuta /mcp para verificar que el servidor se conectó.

Cursor

1. Abre Configuración de Cursor → MCP
2. Haz clic en Añadir servidor MCP
3. Establece el tipo en HTTP y pega:

{
  "huxly": {
    "type": "http",
    "url": "https://huxly.app/api/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

Windsurf

En tu archivo de configuración de Windsurf (~/.codeium/windsurf/mcp_settings.json):

{
  "mcpServers": {
    "huxly": {
      "serverUrl": "https://huxly.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity (Google AI Editor)

En ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "huxly": {
      "serverUrl": "https://huxly.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex (OpenAI)

Codex es la herramienta de codificación agéntica de OpenAI — el equivalente de la familia GPT a Claude Code. Su transporte MCP es más estricto que el de otros clientes, por lo que usa el endpoint dedicado Streamable HTTP de Huxly: https://huxly.app/api/mcp/stream (nota el /stream).

En la aplicación Codex:

1. Abre Codex → Configuración → MCP → Añadir servidor
2. Elige Streamable HTTP como tipo de servidor, y nómbralo huxly
3. Establece la URL a (tu clave va en la URL — deja el token de portador y los encabezados vacíos):

https://huxly.app/api/mcp/stream?key=YOUR_API_KEY

4. Guarda, luego inicia una nueva conversación — ejecuta /mcp para confirmar que las herramientas de Huxly se cargaron

En la CLI de Codex (~/.codex/config.toml):

[mcp_servers.huxly]
url = "https://huxly.app/api/mcp/stream?key=YOUR_API_KEY"

Reinicia Codex y ejecuta /mcp para verificar. Si ves Transport channel closed, verifica que estás en la URL /stream.

ChatGPT (Plus y superior)

ChatGPT puede construir en Huxly directamente — sin necesidad de Codex. Hay dos formas de entrar.

Opción A — inicia sesión con Huxly (recomendada)

1. Abre ChatGPT → Configuración → Seguridad y activa Modo desarrollador
2. Ve a la pestaña Plugins → haz clic en + para el diálogo Nuevo plugin
3. Nómbralo Huxly y establece la URL del servidor a:

https://huxly.app/api/mcp/v2

4. Establece Autenticación en OAuth, luego inicia sesión en Huxly y aprueba el acceso

Sin clave API que generar o pegar, y puedes revocar el acceso desde la Configuración de Huxly en cualquier momento.

Opción B — clave API

Si prefieres no usar OAuth, ChatGPT también funciona con una clave en la URL:

1. Modo desarrollador activado, Nuevo plugin, nómbralo Huxly
2. URL del servidor:

https://huxly.app/api/mcp/stream?key=YOUR_API_KEY

3. Establece Autenticación en Sin autenticación — la clave en la URL es lo que te autentica
4. Marca Entiendo y quiero continuar, luego Crear

Inicia un nuevo chat y pídele que liste tus proyectos de Huxly para confirmar que las herramientas se cargaron.

¿Por qué la Opción B dice Sin autenticación? El diálogo de plugins de ChatGPT no puede enviar un encabezado Authorization personalizado, por lo que Huxly acepta la clave API como un parámetro de consulta ?key= en su lugar. Lleva exactamente el mismo acceso que un token de portador, así que trata toda la URL como un secreto — y prefiere la Opción A, que evita poner una credencial en una URL por completo.

---

Lo que tu IA puede hacer

Herramienta	Qué hace
list_projects	Lista todos tus proyectos de Huxly con framework y fecha de creación
list_files	Obtiene el árbol de archivos completo de un proyecto
read_file	Lee cualquier archivo de un proyecto
search_files	Busca en todos los archivos una cadena o patrón
write_file	Crea o reemplaza completamente un archivo
write_files	Crea o reemplaza múltiples archivos en una sola llamada
edit_file	Hace un cambio quirúrgico — encuentra texto exacto y lo reemplaza
delete_file	Elimina un archivo
create_project	Crea un nuevo proyecto (Expo, Flutter o SwiftUI)
start_sandbox	Inicia el sandbox de vista previa en vivo para un proyecto
update_sandbox	Envía todos los archivos actuales al sandbox en ejecución y espera la recompilación
get_build_logs	Obtiene el estado actual de la compilación y cualquier salida de error
get_runtime_logs	Obtiene los registros de ejecución de la aplicación en ejecución
get_project_url	Obtiene la URL del panel de Huxly para un proyecto
get_conventions	Obtiene las convenciones de codificación para el framework de un proyecto
get_figma_design	Extrae datos de diseño de un archivo de Figma conectado
get_preview_screenshot	Toma una captura de pantalla de la vista previa en vivo
exec_in_sandbox	Ejecuta un comando de shell dentro del sandbox del proyecto

---

Flujo de trabajo típico

Tu IA puede ejecutar este bucle de forma autónoma una vez conectada:

1. list_projects → elige el proyecto objetivo
2. list_files → comprende la estructura
3. read_file en archivos relevantes → comprende el código actual
4. write_file / edit_file → hace los cambios
5. update_sandbox → envía y recompila (devuelve el registro de compilación en línea)
6. Si la compilación falla → lee el registro, corrige, envía de nuevo
7. get_project_url → te devuelve el enlace de vista previa

Tú observas. La IA entrega.

---

Preguntas frecuentes

¿Esto usa mis créditos de Huxly?

No. Toda la inferencia de IA ocurre en tu propia suscripción de IA (Claude, Cursor, ChatGPT, Codex, etc.). Huxly solo proporciona el almacenamiento de archivos, la canalización de compilación y el sandbox — que están cubiertos por tu plan de Huxly. Cero créditos de Huxly consumidos por mensaje.

¿Qué pasa si estoy en el plan gratuito?

El Conector de IA está disponible en los planes Developer, Business y Max — consulta huxly.app/pricing. Los usuarios gratuitos ven un aviso de actualización en Configuración.

¿Puedo conectar múltiples herramientas de IA a la vez?

Sí. Para herramientas basadas en clave, genera una clave API separada para cada una en Configuración — cada una es independiente, por lo que revocar una no afecta a las demás. Claude.ai y ChatGPT se conectan con OAuth en su lugar, y también revocas esas desde Configuración. Los dos tipos coexisten bien en la misma cuenta.

¿Mi código está seguro?

Tu clave API otorga acceso completo de lectura/escritura a todos tus proyectos de Huxly. Trátala como una contraseña — no la compartas, no la confirmes en git. Puedes revocar cualquier clave en cualquier momento desde Configuración.

¿Qué versión del protocolo MCP usa Huxly?

2024-11-05. Compatible con todos los clientes MCP actuales.

¿Qué pasa si mi herramienta de IA no está listada?

Cualquier herramienta que soporte el transporte HTTP de MCP funciona con Huxly — usa la misma configuración de url y Authorization: Bearer. Para clientes estrictos como Codex, usa el endpoint /api/mcp/stream en su lugar, con ?key=YOUR_API_KEY en la URL.

El inicio de sesión con Huxly actualmente funciona solo con Claude.ai y ChatGPT, porque cada cliente OAuth está registrado con nosotros individualmente. Cualquier otro cliente usa una clave API.