techtv-mail — un conector de Cowork para pete@techtv.live

Este es un pequeño servidor MCP que permite a Claude (Cowork) leer y enviar correo a través de tu buzón pete@techtv.live alojado en cPanel — igual que ya funciona con tus cuentas de Microsoft 365 y Gmail, pero creado específicamente para este buzón, ya que Anthropic no tiene un conector predefinido para el correo genérico IMAP/cPanel.

Expone cuatro herramientas para Claude:

• list_folders — ver qué carpetas de correo existen

• search_emails — buscar en una carpeta por remitente, asunto, texto del cuerpo o fecha

• get_email — obtener el texto completo de un mensaje

• send_email — enviar correo como pete@techtv.live

1. Despliégalo en un lugar que esté siempre activo

Necesita vivir en un servidor pequeño accesible desde Internet 24/7; no puede instalarse en tu propio ordenador ni en una sesión de Claude, porque ambas opciones se desconectan. Las opciones más baratas y sencillas para algo tan pequeño:

• Railway (railway.app) — plan gratuito/barato, despliega directamente desde un ZIP o un repositorio de GitHub, y define PORT por ti.

• Render (render.com) — similar, tiene un plan gratuito para servicios pequeños (en el plan gratuito puede quedarse dormido si está inactivo, lo que añade unos segundos de retraso en la primera petición después de un rato).

• Una VPS pequeña que ya tengas, si prefieres ejecutarlo tú mismo.

Sea cual sea el que elijas, los pasos tienen la misma forma:

1. Sube esta carpeta (o hazle push a un repositorio de GitHub y conecta ese repositorio).

2. Configúralo para que ejecute npm install y luego npm start (o node server.js).

3. Establece las variables de entorno siguientes en el panel de control del host. No pongas credenciales reales en el código ni las confirmes en git.

4. Una vez desplegado, el host te dará una URL pública, por ejemplo https://techtv-mail-production.up.railway.app.

Related MCP server: IMAP MCP Server

2. Variables de entorno que debes establecer en el host

Para generar un buen ACCESS_TOKEN, ejecuta esto en cualquier equipo con Node o solo usa un generador de contraseñas para obtener algo con 40+ caracteres aleatorios:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Este token pasa a formar parte de la URL del servidor y es la única barrera entre Internet y tu buzón, así que trátalo exactamente como una contraseña — largo, aleatorio, nunca compartido y nunca publicado en ningún sitio público.

3. Añade este conector a Cowork como un conector personalizado

Una vez desplegado, en la aplicación de Claude:

1. Ve a Personalizar > Conectores (o pulsa en + / escribe / en un chat y elige Gestionar conectores).

2. Haz clic en + para explorar y luego en Añadir conector personalizado.

3. Para la URL del servidor, introduce:

   https://<your-host-domain>/mcp/<ACCESS_TOKEN>

   (ambas partes provienen de tu despliegue: el dominio que te dio el host y el token que has definido como variable de entorno).

4. Deja en blanco los campos Client ID/Secret de OAuth — este servidor no usa OAuth, el token de la URL es el control de acceso.

5. Haz clic en Guardar / Conectar. Claude debería listar ahora list_folders, search_emails, get_email y send_email como herramientas disponibles cada vez que este conector esté habilitado en un chat.

Notas de seguridad

• La contraseña del buzón solo vive en las variables de entorno del host — nunca está en este código y nunca se escribe en un chat con Claude.

• Cualquiera que consiga la URL completa del conector (incluido el token) podría usar estas herramientas contra el buzón, así que no pegues esa URL en ningún sitio público (un documento compartido, un repositorio público, un canal de Slack visible para otros).

• Si sospechas que la URL se ha filtrado, genera un nuevo ACCESS_TOKEN, actúalo en el host y vuelve a introducir la nueva URL en la configuración del conector en Cowork — la antigua deja de funcionar de inmediato.

• La contraseña real de este buzón también debería estar simplemente en tu gestor de contraseñas como cualquier otra; este servidor la necesita una sola vez, en el despliegue, como variable de entorno.

Prueba local (opcional, antes de desplegar)

Puedes ejecutarlo local primero para asegurarte de que tus credenciales reales funcionan:

npm install
MAIL_HOST=mail.techtv.live IMAP_PORT=993 SMTP_PORT=465 \
EMAIL_USER=pete@techtv.live EMAIL_PASS='<real password>' \
ACCESS_TOKEN=test123 PORT=3000 node server.js

Luego, en otra terminal:

curl -s -X POST http://localhost:3000/mcp/test123 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Una respuesta correcta se muestra como un bloque result que confirma el servidor — si en cambio apareces un error de autenticación, revisa EMAIL_PASS y confirma que el acceso IMAP/SMTP no esté bloqueado para este buzón en cPanel.