techtv-mail — коннектор Cowork для pete@techtv.live

Это небольшой MCP-сервер, который позволяет Claude (Cowork) читать и отправлять письма через ваш почтовый ящик pete@techtv.live на cPanel — так же, как уже работает с учётными записями Microsoft 365 и Gmail, но он сделан специально для этого ящика, потому что у Anthropic нет готового коннектора для обычной IMAP/cPanel-почты.

Он предоставляет Claude четыре инструмента:

• list_folders — показывает, какие почтовые папки существуют

• search_emails — ищет в папке по отправителю, теме, тексту письма или давности

• get_email — получает полный текст одного сообщения (text/html)

• send_email — отправляет письма от имени pete@techtv.live

1. Разверните его на площадке, которая работает круглосуточно

Его нужно разместить на небольшом сервере, доступном из публичного интернета 24/7, — на своём компьютере или в сессии Claude обойтись не получится, потому что оба эти варианта могут отключаться. Самые дешёвые и простые варианты для такого небольшого проекта:

• Railway (railway.app) — бесплатный/дешёвый тариф, разворачивается прямо из zip или GitHub-репозитория, PORT задаёт самостоятельно.

• Render (render.com) — похожий сервис, есть бесплатный тариф для небольших сервисов (на бесплатном тарифе он может засыфятать при простое, из-за чего первый запрос после перерыва выполняется на несколько секунд дольше).

• Небольшой VPS, который у вас уже есть, если хотите запустить всё сами.

Какой бы вариант вы ни выбрали, шаги в целом одинаковые:

1. Загрузите эту папку (или запушьте её в GitHub-репозиторий и подключите этот репозиторий).

2. Укажите, чтобы он запускал npm install, а затем npm start (или node server.js).

3. В панели хостинга задайте переменные окружения из списка ниже — не помещайте реальные учётные данные в код и не коммитьте их в git.

4. После развёртывания хостинг выдаст вам публичный URL, например https://techtv-mail-production.up.railway.app.

Related MCP server: IMAP MCP Server

2. Переменные окружения, которые нужно задать на хостинге

Чтобы сгенерировать хороший ACCESS_TOKEN, выполните это на любой машине с Node.js или просто используйте генератор паролей, чтобы получить строку из 40+ случайных символов:

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

Этот токен становится частью URL сервера и единственным барьером между публичным интернетом и вашим почтовым ящиком, поэтому обращайтесь с ним точно как с паролем: длинный, случайный, никогда никому не передавайте и нигде не публикуйте.

3. Добавьте его в Cowork как пользовательский коннектор

После развёртывания — в приложении Claude:

1. Перейдите в Customize > Connectors (или нажмите «+» / введите "/" в чате и выберите «Manage connectors»).

2. Нажмите +, чтобы открыть обзор, затем — Add custom connector.

3. В поле URL сервера введите:

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

   (обе части берутся из вашего развёртывания: домен, который выдал хостинг, и токен, который вы задали переменной окружения).

4. Поля OAuth Client ID / Secret оставьте пустыми — этот сервер не использует OAuth, доступ контролируется токеном из URL.

5. Нажмите Save/Connect. Теперь Claude будет показывать list_folders, search_emails, get_email и send_email как доступные инструменты всякий раз, когда этот коннектор включён в чате.

Примечания по безопасности

• Пароль почтового ящика живёт только в переменных окружения хостинга — его нет ни в этом коде, и его никогда не вводят в чат с Claude.

• Любой, кто получит полный URL коннектора (включая токен), сможет использовать эти инструменты параметры почтового ящика, поэтому не вставляйте этот URL ни в какие публичные места — общий документ, публичный репозиторий, общий канал в слаке на виду.

• Если вы подозреваете, что URL утёк, сгенерируйте новый ACCESS_TOKEN, обновите его на хостинге и заново ввеведите новый URL в настройках коннектора Cowork — старый URL сразу перестанет работать.

• Настоящий пароль почтового ящика тоже должен, как обычно, храниться в вашем менеджере паролей; этому серверу он нужен один раз — при развёртывании, в виде переменной окружения.

Локальный тест (необязательно, перед развёртыванием)

Вы можете сначала запустить сервер локально, чтобы убедиться, что ваши реальные учётные данные работают:

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

Затем в другом терминале:

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"}}}'

Успешный ответ выглядит как result-блок, содержащий имя сервера. Если же появляется ошибка аутентификации, перепроверь EMAIL_PASS и убедитесь, что для этого ящика в cPanel не заблокирован доступ по IMAP/SMTP.