ChatGPT, Codex o Claude en el navegador
Conecta agentes del navegador a Google Drive por un túnel HTTPS, con código de acceso y permisos del perfil.
Conecta una aplicación de IA del navegador o del teléfono, como ChatGPT, Codex web o Claude, para buscar y leer tus documentos de Google Drive. Esa aplicación no puede iniciar drive en tu ordenador: necesita una dirección de internet. Al terminar, estará conectada mediante una dirección HTTPS propia, solo podrá hacer lo que permita tu perfil y sabrás cómo detener la conexión o revocar el acceso.
Términos de esta guía:
- MCP (Model Context Protocol) es el estándar que permite a una aplicación de IA llamar a herramientas externas.
drive personal mcpinicia el servidor MCP dedrive; para aplicaciones del ordenador, consulta el cliente MCP local. - Conexión remota significa que la aplicación se conecta desde sus servidores, por internet, a la dirección que le das.
drive personal mcp --httpofrece las mismas herramientas por HTTP en127.0.0.1. - Túnel HTTPS es un programa que da una dirección HTTPS pública a un puerto del ordenador. Esta guía usa Tailscale Funnel; también funciona Cloudflare Tunnel. Funnel no requiere comprar un dominio.
- URL pública es esa dirección, por ejemplo
https://laptop.tail1234.ts.net. Se pasa adrivecon--public-url, y a la aplicación con/mcpal final. - Código de acceso es un código de un solo uso que
drivemuestra en el terminal. La página de acceso lo solicita, de modo que solo alguien que vea ese terminal puede conectar una aplicación.
ChatGPT / Claude ──internet──▶ Tailscale Funnel ──▶ drive personal mcp --http (login) ──▶ Google DriveSi tu conexión de Tailscale ya funciona, consérvala: no necesitas otro túnel. La conexión local por entrada y salida estándar sigue funcionando.
Antes de empezar
- La aplicación que inicia sesión accede a tus documentos. El acceso necesita el código del terminal. No pongas un túnel delante de
drive personal mcpsin--http: ese modo no tiene inicio de sesión. - Los permisos del perfil determinan qué puede cambiar la aplicación.
denyyreadonlybloquean las escrituras;askyallowpermiten una escritura solicitada por MCP sin un formulario de confirmación en el servidor. La aprobación de la aplicación es independiente y depende de sus ajustes. El acceso a Google y los permisos de archivo se comprueban aparte: escribir también requiere volver a conectar con--grant write(recetas, configuración, seguridad). - El ordenador que ejecuta
drivedebe seguir encendido. Para usarlo desde el teléfono, puedes ejecutarlo en un servidor siempre encendido y conectar allí tu cuenta de Google. - Comprueba que tu aplicación o espacio de trabajo permite conexiones MCP personalizadas. La disponibilidad y los controles administrativos dependen de la aplicación. Sigue la guía actual de OpenAI o la guía de conectores de Claude.
No todos los pasos se han probado en cada sistema operativo. Si uno falla, abre una incidencia.
Inicia el túnel y el servidor
Primero instala drive y conecta tu cuenta de Google (instalación). Usa el mismo usuario del sistema operativo y el mismo perfil para la configuración y el servidor MCP.
Instala Tailscale, inicia sesión y activa Funnel: tu red de Tailscale debe permitir MagicDNS, certificados HTTPS y Funnel. La primera orden de Funnel puede mostrar un enlace de aprobación.
Mantén abiertas dos ventanas de terminal. La primera ejecuta el túnel. Copia la dirección HTTPS que muestra en la segunda ventana. Usa la dirección sin /mcp ni otra ruta; conserva un puerto público explícito, como :8443.
El servidor escucha en 127.0.0.1:8765 (--port cambia el puerto) y muestra un código de un solo uso. No necesita permisos de administrador; el túnel puede necesitarlos.
En Linux, primera ventana:
sudo tailscale funnel 8765En macOS, si tailscale no está en PATH (guía de Tailscale CLI):
TAILSCALE_BE_CLI=1 /Applications/Tailscale.app/Contents/MacOS/Tailscale funnel 8765En Windows, desde PowerShell como administrador:
& "$env:ProgramFiles\Tailscale\tailscale.exe" funnel 8765Segunda ventana, como usuario normal, sin sudo (en Windows, usa drive.cmd):
drive personal mcp --http --port 8765 --public-url https://<device>.<network>.ts.netPara ejecutar drive junto a tg o max, da a cada servidor un puerto local y un puerto HTTPS público distintos. Por ejemplo, otro Funnel con --https=8443 8766 y drive personal mcp --http --port 8766 --public-url https://<device>.<network>.ts.net:8443. Funnel admite los puertos públicos 443, 8443 y 10000 (referencia de Funnel).
Alternativa: Cloudflare Tunnel
Un túnel de Cloudflare con nombre, con un nombre público como mcp.example.com y el servicio local http://127.0.0.1:8765, funciona igual:
drive personal mcp --http --port 8765 --public-url https://mcp.example.comUn Quick Tunnel temporal (cloudflared tunnel --url …) no funciona: Quick Tunnels no admite SSE, que es como el servidor HTTP MCP transmite las respuestas.
Conecta la aplicación
La dirección para la aplicación es la del túnel con /mcp al final, por ejemplo https://<device>.<network>.ts.net/mcp. Añádela como conector MCP remoto:
- ChatGPT o Codex web: abre Plugins, elige + Add custom MCP server y crea un plugin con la dirección
/mcpy OAuth siguiendo la guía de OpenAI. Elige el registro dinámico de clientes (DCR) cuando se ofrezca e instala el plugin antes de usarlo en una conversación. - Claude: añade un conector personalizado con esa dirección siguiendo la guía de Claude.
La aplicación abre la página de acceso de drive. Comprueba adónde vuelve el inicio de sesión: debe ser la aplicación que conectas, como chatgpt.com o claude.ai. Después introduce el código del terminal. Caduca a los diez minutos y se genera otro tras cada acceso. Cinco códigos incorrectos bloquean la página hasta reiniciar el servidor. La aplicación conserva la sesión mientras use la conexión al menos una vez cada 30 días.
El servidor ofrece las mismas tres herramientas que la conexión local: drive_tools_search, drive_read y drive_write. El texto de los documentos son datos, nunca instrucciones.
Permisos para este proceso del servidor
El servidor no puede saber si la aplicación pidió tu aprobación antes de una llamada. Repite --permission key=level para restringir permisos solo en este proceso, por ejemplo --permission files=readonly o --permission sheets=deny. Una opción solo puede restringir: se rechaza si amplía los permisos del perfil. Para permitir más, cambia los permisos del perfil (configuración). --read-only impide cualquier cambio durante esta ejecución.
Detén el servidor o revoca el acceso
Pulsa Ctrl-C en ambas ventanas para detener el servidor y el túnel. Las sesiones de las aplicaciones sobreviven al reinicio.
Si iniciaste Funnel con --bg, Ctrl-C no detiene esa ruta en segundo plano. Comprueba tailscale funnel status y desactiva solo su puerto, por ejemplo tailscale funnel --https=443 off.
Para cerrar las sesiones de todas las aplicaciones de un perfil:
drive personal mcp --revoke --jsonLas aplicaciones tendrán que iniciar sesión con un código nuevo. Esto no desconecta drive de Google.
Si no funciona
- La aplicación no se conecta: abre
https://<device>.<network>.ts.net/.well-known/oauth-protected-resource/mcpen el navegador. Debe mostrar un JSON breve. Si no aparece, Funnel no funciona, no está permitido en tu red de Tailscale o apunta a otro puerto. - La página muestra "Too many wrong codes": reinicia
drive personal mcp --http. Si no los introdujiste tú, alguien encontró la dirección: considera cambiar el nombre del dispositivo en Tailscale. - "port 8765 is in use": otro servidor ocupa el puerto; elige otro con
--porty dirige el túnel hacia él. - Leer funciona, escribir no: comprueba los permisos del perfil, las opciones
--permissiony el permiso de escritura de Google.denyyreadonlybloquean la escritura aunque la aplicación la apruebe.