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.
- 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 de tu proyecto en ChatGPT y describe una tarea clara. TunnelGPT registra automáticamente los cambios de archivos y los trabajos del proyecto en el almacenamiento privado de la aplicación; no necesitas un archivo de seguimiento en el proyecto. Pide a ChatGPT que actualice el objetivo o el siguiente paso cuando cambien. En otra conversación, selecciona el mismo conector y describe el objetivo o el archivo con el que quieres continuar. Pide a ChatGPT que busque la tarea guardada correspondiente y la retome. Si coinciden varias, aclara el objetivo o el nombre del archivo. El agente gestiona los identificadores de las tareas. La app consulta los recibos y estados disponibles; las acciones sin resolver siguen pendientes. Cada tarea conserva su propio contexto. La memoria tiene límites y limpia automáticamente el historial resuelto antiguo. No guarda todo el chat ni concede permisos de acceso distintos a cada conversación. Actualiza las herramientas del conector después de actualizar la app.
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.