chatgpt-mcp

Qué problema resuelve

El asistente no puede inspeccionar archivos locales ni ejecutar comandos del proyecto sin una conexión al equipo. chatgpt-mcp la ofrece mediante herramientas configuradas explícitamente, evitando copiar archivos, resultados de terminal y capturas una y otra vez.

Formas de usarlo

• Inspeccionar y probar un proyecto local

  Autoriza una carpeta y el ejecutable de pruebas necesario. Pide al asistente que consulte los comandos documentados, ejecute una prueba acotada y devuelva código de salida y fallos pertinentes.

• Revisar una interfaz en un escritorio desechable

  Con permisos de escritorio aprobados, abre un navegador de prueba en un display X11 elegido e inspecciona una captura antes de enviar entrada. Una captura no autoriza escribir en otra sesión activa.

Antes de empezar

• Un equipo Linux o VM desechable, Node.js 22+, Git y pnpm 11.20.0 fijado por el proyecto.
• Un cliente MCP; para el túnel privado de ChatGPT, tu identidad de túnel y clave de ejecución introducida localmente, además de servicios systemd de usuario para el instalador.
• Solo las raíces de archivos, comandos y capacidades de escritorio que quieras conceder. Las operaciones X11 requieren un display explícito.

Instalación y configuración

1. Comprobar quién gestiona el servicio

   Identifica primero una instalación MCP o gestionada por Overdeck. No sobrescribas su configuración ni crees un servicio competidor. El instalador rápido concede control amplio; elige configuración manual para empezar con pocos permisos.

2. Compilar el servidor público

   Clona en una carpeta nueva, instala las dependencias fijadas y ejecuta el control del repositorio. Compila el servidor sin instalar un túnel ni conceder control del equipo.

   git clone https://github.com/alexcodeplace/chatgpt-mcp.git
   cd chatgpt-mcp
   corepack pnpm@11.20.0 install
   corepack pnpm@11.20.0 gate

3. Empezar solo con system.info

   En un clon nuevo e independiente, copia la plantilla mínima e inicia stdio. Conserva una configuración existente. Configura el cliente con estas rutas y variables; stdout transporta MCP, no un chat humano.

   cp config.example.json config.local.json
   CHATGPT_MCP_CONFIG="$PWD/config.local.json" node dist/src/stdio.js

4. Añadir el transporte de ChatGPT si hace falta

   Sigue el tutorial Secure MCP Tunnel del README y las instrucciones oficiales actuales de OpenAI. Introduce claves localmente, conserva loopback y revisa los permisos amplios antes de usar ./install.sh. No pegues claves en el prompt.

Uso en tu proyecto

1. Confirmar la identidad antes de dar acceso

   En el cliente conectado, pide system.info y comprueba equipo y capacidades. Una compilación correcta no demuestra que exista conexión con el cliente.

   Use system.info to report the connected host and enabled capabilities.

2. Probar una lectura y un comando acotados

   Después de aprobar permisos limitados, lista una carpeta no sensible y ejecuta un comando pequeño con cwd y límite de tiempo explícitos. El servidor no añade otro diálogo de aprobación.

3. Comprobar el transporte sin exponer secretos

   En una instalación del instalador de túneles, usa su comando de estado del perfil guardado. Para HTTP manual, consulta /healthz en el puerto loopback elegido. Actualiza mediante el flujo que gestiona esa instalación.

   ./scripts/tunnel-status.sh

Qué debes saber antes

El acceso al equipo implica riesgos. Usa una máquina virtual desechable y concede solo las capacidades necesarias.