Túnel Chat MCP
Connects ChatGPT to private local files through an OpenAI Secure MCP Tunnel without opening inbound ports. Exposes tools to list folders and files, read text or binary files in chunks, create/overwrite files with concurrency protection, create folders and copy, move, rename or delete whole trees, send deleted items to a recoverable trash, save PNG/JPEG/WebP images that ChatGPT produces, and create/restore verified backups, all restricted to a single explicitly authorized folder with per-profile permissions, one-time local approvals and a control panel.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Túnel Chat MCP lee las notas de la carpeta proyectos y haz copia de seguridad"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Túnel Chat MCP
Servidor MCP local para trabajar con archivos privados desde ChatGPT mediante OpenAI Secure MCP Tunnel, sin abrir puertos entrantes ni publicar el servidor local en Internet.
Proyecto comunitario independiente; no es un producto oficial de OpenAI.
Estado: versión local funcional y endurecida en Windows, distribuida bajo Apache-2.0. La implementación de macOS y Linux tiene pruebas automáticas, pero aún requiere validación funcional en equipos reales y se ofrece como compatibilidad experimental.
Qué permite hacer
Listar carpetas y archivos.
Leer texto o archivos binarios por fragmentos.
Crear y sobrescribir archivos con protección frente a cambios concurrentes.
Crear carpetas y copiar, mover, renombrar o eliminar árboles completos.
Mover archivos y carpetas eliminados a una papelera recuperable.
Guardar en el PC imágenes PNG, JPEG o WebP que ChatGPT entregue a la app.
Crear y restaurar copias de seguridad verificadas.
Exigir una aprobación local para cada escritura o permitir un modo autónomo.
Activar permisos por 10, 30 o 60 minutos, o sin límite temporal.
Mantener varios perfiles de carpetas completamente aislados.
Controlar el túnel, el inicio automático nativo y los permisos desde un panel ES/EN.
No existe ninguna herramienta para ejecutar comandos, PowerShell o programas.
Related MCP server: localmcpcoder
Modelo de seguridad
Solo se acepta una carpeta explícitamente autorizada; nunca una unidad completa, Windows, el propio proyecto ni una carpeta que lo contenga.
Cada perfil tiene permisos, aprobaciones y copias independientes, ligados a la huella de su carpeta real.
Las aprobaciones son de un solo uso y se consumen de forma atómica.
Se bloquean escapes con
.., rutas absolutas, enlaces simbólicos, enlaces duros, uniones, flujos ADS, nombres reservados de Windows, secretos habituales y los datos del propio túnel.Los archivos con más de un enlace duro se rechazan aunque todos sus nombres parezcan estar dentro de la carpeta autorizada: no es posible demostrarlo con
realpath. Los enlaces temporales usados internamente para crear archivos atómicamente se eliminan antes de finalizar la operación.Las operaciones recursivas aceptan como máximo 10.000 elementos y 512 MiB, calculan una huella del árbol y vuelven a verificarla antes y después de mover o copiar. Cualquier enlace, unión, archivo especial o cambio concurrente hace que la operación falle de forma cerrada.
Las imágenes de ChatGPT se crean como archivos nuevos, con un máximo de 20 MiB. Solo se descargan por HTTPS, se comprueba su firma real y se bloquean puertos no estándar, credenciales en URL, redirecciones excesivas y direcciones locales, privadas o reservadas para evitar SSRF.
Las copias llevan perfil, huella de carpeta y SHA-256. Los metadatos se validan antes de listar, limpiar o restaurar.
La credencial del plano de control se protege con DPAPI, Keychain o Secret Service, según el sistema. Durante la ejecución se retira del entorno del controlador, solo se añade deliberadamente al proceso de
tunnel-clienty se elimina antes de cargar el código del servidor MCP o iniciar procesos auxiliares. La decisión está documentada en ADR-001.El panel escucha exclusivamente en
127.0.0.1, usa token efímero anti-CSRF, política CSP y cabeceras defensivas.La auditoría rota automáticamente y encadena criptográficamente sus eventos para detectar modificaciones accidentales o posteriores.
El límite final de confianza es la cuenta local del sistema. Otro proceso malicioso ejecutado como el mismo usuario podría manipular archivos o procesos locales.
Datos privados
El código no contiene perfiles, rutas personales, credenciales, aprobaciones, copias ni registros. Las ubicaciones predeterminadas son:
%LOCALAPPDATA%\OpenAI-Secure-MCP-Tunnel
~/Library/Application Support/OpenAI-Secure-MCP-Tunnel
${XDG_STATE_HOME:-~/.local/state}/openai-secure-mcp-tunnelLa carpeta .tunnel-client, vendor, .env y los registros están excluidos por
.gitignore. Antes de hacer público un repositorio, revisa también todo su historial
Git y rota cualquier credencial que haya llegado a un commit.
Requisitos
Windows 10/11, macOS o Linux con sesión de usuario.
Node.js 22 o posterior.
Acceso a Secure MCP Tunnel en la organización de OpenAI.
Una copia autorizada de
tunnel-client. En Windows se detecta la copia devendor\tunnel-client\tunnel-client.exe; en macOS/Linux se indica con--clientoMCP_TUNNEL_CLIENT_PATHsi no está enPATH.Keychain disponible en macOS o un proveedor Secret Service desbloqueado en Linux.
Primera configuración
Guarda la credencial sin incluirla en argumentos:
node cli.mjs credential setConfigura y verifica el cliente:
node cli.mjs setup --workspace "RUTA" --tunnel-id "tunnel_<32_caracteres_minusculos_o_digitos>" --client "RUTA_CLIENTE"Inicia el servicio:
node cli.mjs runCon el panel iniciado, el ciclo de vida también puede controlarse desde terminal:
node cli.mjs tunnel status
node cli.mjs tunnel stop
node cli.mjs tunnel start
node cli.mjs tunnel restartEn Windows se conservan los flujos compatibles de PowerShell:
cd "<RUTA_DEL_PROYECTO>"
.\setup-tunnel.ps1Comprueba que el diagnóstico termina en RESULT ok.
setup-tunnel.ps1 configura el MCP con mcp-launcher.mjs, que limpia las
credenciales de OpenAI antes de importar server.mjs.
Inicio manual
cd "<RUTA_DEL_PROYECTO>"
.\start-tunnel.ps1El iniciador pide la carpeta autorizada. Pulsa Enter para conservar la guardada o
escribe otra. Mantén abierta la ventana: Ctrl+C apaga el controlador y el túnel.
Panel principal: se abre automáticamente al iniciar de forma interactiva. Si el túnel se inició en segundo plano, ejecuta
.\open-panel.ps1.Panel técnico del cliente: http://127.0.0.1:8082/ui
Preparación: http://127.0.0.1:8080/readyz
Conectar desde ChatGPT.com
Consulta el tutorial Conectar Túnel Chat MCP con ChatGPT.com. Explica paso a paso cómo crear la app en modo desarrollador, seleccionar el túnel, probar primero el acceso de solo lectura, aprobar una modificación y solucionar problemas de conexión.
Inicio automático
Después de configurar el túnel:
node cli.mjs autostart enable
node cli.mjs autostart status
node cli.mjs autostart disableEn Windows también siguen disponibles:
.\enable-autostart.ps1Para desactivarlo:
.\disable-autostart.ps1También puede cambiarse desde el panel.
Para retirar el arranque y la credencial nativa sin borrar registros ni copias:
node cli.mjs uninstall --yesEn macOS/Linux, la desinstalación comprueba que el servicio esté detenido y que la credencial haya desaparecido. Si el gestor de servicios falla, conserva la definición hasta poder confirmar la parada. Si el almacén está bloqueado o no responde, informa del error y no anuncia éxito. Desbloquea el almacén y repite la operación; en macOS hace falta una sesión gráfica disponible. La operación es idempotente cuando se puede confirmar que servicio y credencial ya no existen. Las instancias iniciadas manualmente se detienen desde su panel o terminal.
Panel de control
El panel está en español por defecto y permite cambiar a inglés. Los permisos de lectura, creación, modificación y eliminación se aplican inmediatamente. La aprobación por operación, protección sensible, copias y retención son independientes para cada perfil.
Al cambiar de perfil se reinicia el túnel si estaba activo. Las aprobaciones del perfil anterior no aparecen ni pueden utilizarse en el nuevo.
El panel usa un enlace efímero cuyo secreto viaja en el fragmento # y se elimina
de la barra de direcciones al cargar. El enlace se guarda en la carpeta privada y
no se incrusta en el HTML público de 127.0.0.1.
Pruebas
npm testLas pruebas usan carpetas temporales y cubren permisos, lectura binaria, escapes de ruta, ADS, secretos, copias, papelera, árboles de carpetas, entradas de archivo de ChatGPT, bloqueo SSRF, aislamiento de perfiles y consumo simultáneo de aprobaciones.
Archivos principales
cli.mjs: interfaz portátil de configuración, inicio y autostart.platform-runtime.mjs: almacenes de credenciales y servicios nativos.control-api-contract.mjs: contrato validado de/api/v1.control-panel.mjs: backend y ciclo de vida local.panel/: interfaz adaptable ES/EN.server.mjs: herramientas MCP y límites del espacio autorizado.workspace-tree.mjs: huellas, límites y operaciones seguras con árboles.chatgpt-files.mjs: descarga limitada y validación de imágenes de ChatGPT.mcp-launcher.mjs: saneamiento del entorno antes de cargar el MCP.secure-store.mjs: estado por perfil, bloqueo atómico y auditoría.harden-private-data.ps1: restringe los ACL de los datos privados.open-panel.ps1: abre el enlace efímero del panel desde el almacén privado.start-tunnel.ps1: inicio manual.enable-autostart.ps1ydisable-autostart.ps1: inicio con Windows.SECURITY.md: política de seguridad y divulgación responsable.SECURITY-AUDIT.md: última auditoría y riesgos residuales conocidos.CHANGELOG.md: cambios y alcance de cada versión pública.CONTRIBUTING.md: proceso seguro para incidencias y contribuciones.CODE_OF_CONDUCT.md: normas de participación y canal privado de aplicación.TUTORIAL-CHATGPT.md: conexión, prueba y desconexión desde ChatGPT.com.docs/control-api-v1.md: interfaz local versionada.docs/decisions/: decisiones de arquitectura y sus límites de seguridad.
Estado de compatibilidad
Entorno | Estado | Validación actual |
Windows 10/11 | Validado | Uso funcional real, DPAPI, Programador de tareas y pruebas automáticas. |
macOS | Experimental | Pruebas automáticas y de contrato para Keychain y |
Linux de escritorio | Experimental | Pruebas automáticas y de contrato para Secret Service y |
La integración continua ejecuta las pruebas en Windows, macOS y Ubuntu ante cada cambio y también realiza comprobaciones de seguridad semanales. Estas pruebas no sustituyen un ciclo real con ChatGPT, el almacén de credenciales y el servicio de inicio de cada sistema.
tunnel-client es una dependencia externa y no se distribuye en este repositorio.
Debe descargarse desde el enlace indicado por la
documentación oficial de OpenAI.
La carpeta vendor/ permanece excluida de Git y la licencia Apache-2.0 de este
proyecto no cubre ese cliente.
Los fallos de macOS o Linux pueden comunicarse mediante GitHub Issues, indicando sistema, versión, arquitectura, versión de Node.js y pasos para reproducirlos. No incluyas claves, identificadores de túnel, rutas personales ni contenido privado.
Licencia
Este proyecto se distribuye bajo la Apache License 2.0. El archivo
NOTICE identifica al titular inicial. La licencia no cubre tunnel-client.exe,
marcas de OpenAI ni dependencias de terceros.
Available Tools
11 toolscomprobar_estado_localComprobar estado localARead-onlyIdempotent
Devuelve estado, carpeta, permisos y protecciones activas.
Inputs: no named parameters.
copiar_elementoCopiar archivo o carpetaC
Copia un archivo o una carpeta completa a una ruta nueva, verificando limites, enlaces e integridad.
Inputs: origen (required), destino (required), confirmar, aprobacion_id.
crear_carpetaCrear carpetaC
Crea una carpeta nueva dentro del espacio autorizado. No sobrescribe rutas existentes.
Inputs: ruta (required), confirmar, aprobacion_id.
eliminar_archivoEliminar archivoBDestructive
Mueve un archivo a la papelera recuperable y crea copia si esta activada.
Inputs: ruta (required), sha256_esperado (required), confirmar, aprobacion_id.
eliminar_carpetaEliminar carpetaBDestructive
Mueve una carpeta completa a la papelera local recuperable tras verificar todo su contenido.
Inputs: ruta (required), confirmar, aprobacion_id.
guardar_imagen_chatgptGuardar imagen de ChatGPTC
Descarga de forma segura una imagen PNG, JPEG o WebP recibida por ChatGPT y la crea dentro de la carpeta autorizada.
Inputs: imagen (required), ruta_destino (required), confirmar, aprobacion_id.
leer_archivoLeer archivoBRead-onlyIdempotent
Lee archivos autorizados por fragmentos de hasta 2 MiB. La huella completa puede omitirse para evitar recorrer archivos grandes.
Inputs: ruta (required), formato, max_bytes, offset_bytes, +1 more.
listar_archivosListar archivos y carpetasCRead-onlyIdempotent
Lista de forma no recursiva hasta 500 elementos autorizados.
Inputs: ruta.
listar_copias_seguridadListar copias de seguridadARead-onlyIdempotent
Lista las copias recuperables existentes.
Inputs: no named parameters.
modificar_archivoCrear o modificar archivoCDestructive
Crea o sobrescribe un archivo. La primera llamada puede generar una solicitud de aprobacion local.
Inputs: modo (required), ruta (required), contenido (required), formato, +3 more.
mover_elementoMover o renombrar archivo o carpetaBDestructive
Mueve un elemento a una ruta nueva. Sirve para cortar y pegar o para renombrar.
Inputs: origen (required), destino (required), confirmar, aprobacion_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct file-system operation or server-state check; leer vs modificar vs eliminar vs copiar/mover are clearly separated. Minor potential overlap between 'listar_copias_seguridad' (backups) and general listing, but descriptions distinguish them.
Consistent verb_noun Spanish convention across all 11 tools (guardar_imagen, listar_copias, leer_archivo, crear_carpeta, copiar_elemento, mover_elemento, eliminar_archivo/carpeta). No mixing of conventions or styles.
11 tools is well within the ideal 3-15 range and maps naturally onto a file-management surface. Slightly more than minimal but each tool earns its place (backups, status, folder vs file distinction).
Covers full lifecycle: list, read, create/modify, delete (file and folder), copy, move, plus backup listing and local status. Rename is handled via mover_elemento; no obvious dead ends, though a restore-from-trash operation is implied but not exposed.
Maintenance
Related MCP Connectors
Browse and manage files in your Moxt AI workspace from any MCP client.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Persistent file storage for AI agents via MCP and curl. Upload, download, and version files.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT to inspect and edit local projects through a secure MCP interface, offering workspace management, file operations, git integration, and safe command execution.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables remote MCP clients like ChatGPT to run shell commands and manage files on your local machine via a Cloudflare tunnel, exposing tools for file operations, search, and task management.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables ChatGPT to securely control a local workstation via an MCP tunnel, exposing 44 tools for file/project editing, git, process supervision, browser automation, and Office document handling across macOS, Linux, and Windows.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables ChatGPT or any MCP client to operate safely on a designated workspace by listing, reading, searching, writing, and trashing files, inspecting Git status/log/diff, and optionally running allowlisted executables without a shell.Apache 2.0