Skip to main content
Glama
Túnel Chat MCP

Túnel Chat MCP

by EdAlXGoAm

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-client y 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-tunnel

La 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 de vendor\tunnel-client\tunnel-client.exe; en macOS/Linux se indica con --client o MCP_TUNNEL_CLIENT_PATH si no está en PATH.

  • Keychain disponible en macOS o un proveedor Secret Service desbloqueado en Linux.

Primera configuración

  1. Guarda la credencial sin incluirla en argumentos:

node cli.mjs credential set
  1. Configura y verifica el cliente:

node cli.mjs setup --workspace "RUTA" --tunnel-id "tunnel_<32_caracteres_minusculos_o_digitos>" --client "RUTA_CLIENTE"
  1. Inicia el servicio:

node cli.mjs run

Con 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 restart

En Windows se conservan los flujos compatibles de PowerShell:

cd "<RUTA_DEL_PROYECTO>"
.\setup-tunnel.ps1

Comprueba 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.ps1

El 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.

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 disable

En Windows también siguen disponibles:

.\enable-autostart.ps1

Para desactivarlo:

.\disable-autostart.ps1

También puede cambiarse desde el panel.

Para retirar el arranque y la credencial nativa sin borrar registros ni copias:

node cli.mjs uninstall --yes

En 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 test

Las 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.ps1 y disable-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 launchd; falta validación funcional en equipos reales.

Linux de escritorio

Experimental

Pruebas automáticas y de contrato para Secret Service y systemd --user; falta validación funcional en equipos reales.

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 tools
comprobar_estado_localComprobar estado localA
Read-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 archivoB
Destructive

Mueve un archivo a la papelera recuperable y crea copia si esta activada.

Inputs: ruta (required), sha256_esperado (required), confirmar, aprobacion_id.

eliminar_carpetaEliminar carpetaB
Destructive

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 archivoB
Read-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 carpetasC
Read-onlyIdempotent

Lista de forma no recursiva hasta 500 elementos autorizados.

Inputs: ruta.

listar_copias_seguridadListar copias de seguridadA
Read-onlyIdempotent

Lista las copias recuperables existentes.

Inputs: no named parameters.

modificar_archivoCrear o modificar archivoC
Destructive

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 carpetaB
Destructive

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

    B3.3/5.0

    Scored across 11 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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).

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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