Primeros pasos
Conecta tu primer proyecto, paso a paso
Prepara tu cuenta, elige una carpeta y termina la conexión en ChatGPT. La guía de la aplicación te acompaña en cada paso.
Antes de empezar
- Tu cuenta de ChatGPT con permiso para añadir apps personalizadas y acceso a Secure MCP Tunnels en OpenAI.
- En Mac, Docker 24 o superior en ejecución. Revisa las condiciones de licencia de Docker Desktop para tu uso.
- Permiso en tu organización de OpenAI para crear una credencial restringida y un túnel.
- Un directorio de proyecto local que quieras conectar.
Roles y permisos
Crear un túnel y una credencial restringida requiere el rol correspondiente en tu organización de OpenAI. Pídelo a un propietario si la opción no te aparece. TunnelGPT nunca los crea por ti.
Crea o reutiliza una credencial
Usa una credencial restringida limitada a lo que el túnel necesita. Una credencial reutilizable puede servir a varios túneles autorizados sin mezclar identidades de proyecto. No la guardes en un archivo; la aplicación de escritorio la mantiene en el almacenamiento seguro del sistema operativo.
Crea y selecciona el túnel
Crea un Secure MCP Tunnel y asócialo al espacio de ChatGPT donde usarás el conector. Copia su identificador completo para pegarlo en TunnelGPT.
Registra el proyecto
Selecciona la carpeta en TunnelGPT y dale un nombre reconocible. Vincúlala al túnel de ese proyecto. Empieza en modo solo lectura.
Arranca y verifica la conexión
Inicia la conexión y espera a que TunnelGPT indique que está lista. Mantén el ordenador encendido, sin suspensión, con internet y Docker en ejecución.
Configúralo en ChatGPT
Abre Plugins en chatgpt.com y crea una app personalizada. En Connection elige Tunnel y selecciona el túnel de tu proyecto o pega su identificador. Sigue los campos de autenticación que indica la guía de la app, escanea las herramientas y guarda el conector.
Problemas frecuentes
- Conector añadido antes de que pasara la comprobación de disponibilidad — arranca primero el perfil y añádelo después.
- Identificador de túnel pegado con espacios alrededor o truncado — debe coincidir exactamente.
- Docker no está arrancado — inícialo antes de la conexión.
- Dos perfiles apuntando al mismo túnel — un túnel conectado por cada perfil activo.
- Credencial sin el alcance que el túnel necesita — revisa el rol y vuelve a emitirla.
Documentación oficial
El comportamiento del túnel y del conector lo define OpenAI, no nosotros. Sigue su documentación para todo lo relativo al túnel.
Documentación de la plataforma de OpenAI
Retoma la misma tarea en otra conversación.
Selecciona el conector del proyecto y pide al agente que mantenga al día el objetivo y el siguiente paso de la tarea. La memoria de tareas queda en el almacenamiento privado de la aplicación. En TunnelGPT, abre Continuar trabajo en ese proyecto, selecciona la tarea y comprueba sus trabajos. Copia o guarda el resumen y pégalo en otra conversación con el mismo conector. Si ChatGPT deja de responder, usa la ayuda de esa tarea para comprobar primero el trabajo local: puede seguir ejecutándose. La app consulta los recibos y estados disponibles; las acciones sin resolver siguen pendientes. Los avisos opcionales del Mac informan de cambios locales observables, no del estado de la respuesta de ChatGPT. Cada tarea conserva su contexto, pero comparten los permisos del proyecto. Si trabajan varios agentes, reparte los archivos o coordina las ediciones. Actualiza las herramientas del conector después de instalar. Busca la tarea por su objetivo o archivo; si coinciden varias, aclara cuál. La memoria tiene límites de espacio y limpia automáticamente el historial antiguo ya resuelto.
Conecta un MCP local
En TunnelGPT, abre MCPs locales → Añadir un MCP local. Introduce su dirección HTTP local o la ruta completa del ejecutable instalado. Reutiliza tu clave Restricted guardada e indica un ID de túnel independiente. Guarda y comprueba las herramientas, elige cuáles quieres utilizar, confirma sus permisos y pulsa Conectar con ChatGPT. Después añade ese túnel como conector personalizado en tu cuenta de ChatGPT.
El servidor HTTP local debe estar en marcha. Si eliges un comando instalado, TunnelGPT lo inicia al probar o conectar. Los argumentos y las variables opcionales están en Configuración avanzada; los secretos se guardan en el llavero del sistema. Guardar y probar no expone las herramientas en remoto.
Configúralo con tu agente local.
Para que lo configure tu agente: en MCPs locales, abre Configuración asistida y pulsa Habilitar agentes locales. Copia el comando para Codex o la configuración JSON de tu cliente MCP. Con TunnelGPT abierto, pide al agente que añada y compruebe tu MCP local. Indícale el ID de túnel y las herramientas que autorizas; puede reutilizar una clave ya guardada. Puedes desactivar este acceso desde la app y consultar sus operaciones recientes.
Para macOS con Apple Silicon (M1 o posterior). Cada MCP local conserva sus propios permisos, incluido el acceso a cuentas con sesión iniciada o cambios fuera de una carpeta. Conecta servidores de confianza y revisa sus herramientas. El acceso a conectores de ChatGPT depende de tu cuenta.