Почта внутри Claude: свой MCP-сервер на Vercel

Claude ищет письма в вашем ящике, читает переписку целиком, пишет ответы и отправляет их с вашего разрешения. Работает и с телефона, потому что живёт не на компьютере, а в интернете. Подходит любой почте с IMAP — Яндекс, Mail.ru, VK, корпоративная на своём домене.

Как это устроено

Между Claude и вашей почтой встаёт маленький сервер-переводчик:

Claude (чат или телефон)  →  ваш сервер на Vercel  →  почта по IMAP и SMTP

Сервер ничего не хранит: на каждый запрос он подключается к почте, берёт нужное и гаснет. Это не арендованный компьютер, который крутится круглосуточно, — код запускается на пару секунд под конкретный запрос. Поэтому бесплатного тарифа хватает с запасом.

Собирать сервер вы не будете — соберёт Claude Code или Codex по промпту ниже. От вас несколько кликов в почте, в Vercel и в настройках Claude.

Нужны две вещи: включённый IMAP и пароль приложения. Обычный пароль от ящика для этого не годится — почтовые сервисы его для внешних программ не принимают.

Пароль приложения — отдельный пароль, который вы создаёте специально для одной программы и можете в любой момент отозвать, не меняя основной.

Пароль создаётся один раз и показывается тоже один раз — скопируйте его сразу. Отозвать его можно в любой момент там же, где создавали, и основной пароль от ящика это не затронет.

Точные адреса серверов и порты искать не нужно: в промпте есть отдельный пункт, по которому Claude сам сходит в документацию вашего провайдера и возьмёт их оттуда.

Сервер будет жить на Vercel — это бесплатный хостинг, который запускает код по запросу. Заводить проект и деплоить будет сам Claude, но для этого ему нужен доступ.

1. Зарегистрируйтесь на vercel.com. Бесплатный тариф, карта не нужна.
2. Подключите Vercel как коннектор:
   • в Claude — Customize → Connectors → найти Vercel → Connect;
   • в ChatGPT — раздел Plugins → найти Vercel → установить.
   Подключение идёт обычным входом в аккаунт, как через Google.

Без этого шага Claude сможет написать код, но не сможет его опубликовать, и вам придётся разбираться с командами в терминале.

Открываете Claude Code или Codex в пустой папке и отправляете это целиком. Первым делом он задаст три вопроса и остановится — это нормально.

Сделай мне MCP-сервер для моей почты и задеплой его на Vercel, чтобы я мог
подключить почту к Claude как коннектор и пользоваться ей в том числе с телефона.

--------------------------------------------------------------------
СНАЧАЛА СПРОСИ МЕНЯ И ОСТАНОВИСЬ

1. Какой у меня адрес почты целиком — по домену ты поймёшь провайдера.
2. Что сервер должен уметь: только читать и создавать черновики,
   или ещё и отправлять письма.
3. Как назвать проект на Vercel.

Не пиши код, пока я не отвечу.

--------------------------------------------------------------------
ПРОВЕРЬ, А НЕ ВСПОМНИ

Прежде чем писать код, найди в документации моего провайдера:

  — адреса и порты IMAP и SMTP;
  — как у него называется пароль для внешних приложений и где его создать;
  — работает ли у него вообще вход по паролю приложения.

Последнее важно: у Microsoft (Outlook, Office 365) обычный вход по паролю
для IMAP и SMTP отключён, работает только OAuth. Если у меня такой случай —
скажи сразу и не делай вид, что получится.

Настройки по памяти не бери. Ошибёшься в порту — я потрачу вечер
на ловлю непонятной ошибки.

--------------------------------------------------------------------
ЧТО СОБРАТЬ

Проект на Next.js и TypeScript:

  mcp-handler    сам MCP-сервер
  imapflow       чтение и поиск по IMAP
  mailparser     разбор писем в читаемый текст
  nodemailer     отправка по SMTP (только если я попросил отправку)

Инструменты, которые увидит Claude:

  list_folders    список папок
  search_emails   поиск по отправителю, теме, тексту и датам, в любой папке
  read_email      полный текст письма и список вложений
  create_draft    кладёт черновик в папку черновиков, в том числе
                  ответ внутри существующей переписки
  list_drafts     список черновиков
  send_draft      отправляет готовый черновик (только если я просил отправку)

Инструмента «отправить произвольное письмо» быть не должно. Отправляется
только черновик, который я перед этим увидел. Сам send_draft пометь
как необратимый, чтобы claude.ai спрашивал подтверждение перед вызовом.
Скрытые копии (Bcc) из заголовков вырезай.

--------------------------------------------------------------------
АВТОРИЗАЦИЯ — САМОЕ ВАЖНОЕ

Сервер пускает только по заголовку:

    Authorization: Bearer <секрет>

Секрет лежит в переменной окружения MCP_SECRET. Без заголовка или
с неверным секретом — 401 и ничего больше.

Секрет НЕ должен быть частью адреса. Путь запроса попадает в логи Vercel,
и секрет из адреса утечёт туда. Адрес делай обычным: /api/mcp

Если MCP_SECRET пустая или короче 16 символов — закрывай доступ,
а не открывай.

--------------------------------------------------------------------
ЧЕГО НЕ ДЕЛАТЬ

— Не проси у меня в чат пароль приложения, секрет и любые другие ключи.
  Я впишу их сам в переменные окружения Vercel.
— Не генерируй секрет сам и не печатай его в чат. Я сгенерирую его
  в отдельном терминале и тебе не покажу.
— Не клади ключи в код и в файлы проекта.

--------------------------------------------------------------------
ДЕПЛОЙ

Задеплой проект на Vercel. Проект создай сам — вручную я его заводить
не буду. Если понадобится мой вход, скажи, я подтвержу в браузере.

После деплоя проверь на боевом адресе, что запрос без заголовка
получает 401. Проверить работу с самой почтой ты не сможешь, пока
я не впишу переменные — это нормально, так и задумано.

--------------------------------------------------------------------
В КОНЦЕ НАПИШИ МНЕ

1. Боевой адрес коннектора вида https://.../api/mcp
2. Список переменных для Vercel: точные названия и что в каждую класть.
3. Что именно включить в моей почте, чтобы IMAP заработал.
4. Напоминание, что после добавления переменных нужен новый деплой,
   иначе они не подхватятся.

Положи рядом короткий README с тем же самым.

Пиши по-русски, без жаргона. Командами меня не грузи — делай сам.

Пока он пишет код, на вашей стороне три дела. Второе — самое важное во всём гайде.

openssl rand -hex 24

-join ((1..24) | ForEach-Object { '{0:x2}' -f (Get-Random -Max 256) })

Последний шаг — сказать Claude или ChatGPT, где лежит ваш сервер. Делается в браузере, в настройках.

Куда идти:

• в Claude — Customize → Connectors → добавить свой коннектор;
• в ChatGPT — раздел Plugins → добавить свой.

Названия полей у них отличаются и со временем меняются, но нужны всегда одни и те же три вещи:

1. Адрес сервера — тот, что вернул Claude после деплоя, вида https://ваш-проект.vercel.app/api/mcp.
2. Заголовок авторизации. Имя — Authorization, значение — Bearer ВАШ_СЕКРЕТ: слово Bearer, пробел, секрет. Вход по логину и паролю при этом выбирать не нужно, доступ даёт именно заголовок.
3. Транспорт — Streamable HTTP.

Дальше проверяете в чате: «покажи последние 5 писем в моей почте». Если не находит, скажите об этом Claude Code — он посмотрит, что отвечает сервер.

Коннектор привязывается к аккаунту, а не к устройству: добавили один раз в браузере — работает и в приложении на телефоне.

Насколько это защищено

Секрет из 48 случайных символов перебрать нереально, claude.ai хранит заголовок зашифрованным и больше его не показывает. Для личной почты этого достаточно.

Чем это всё-таки хуже полноценного OAuth:

• Секрет вечный. Токены OAuth живут недолго и обновляются сами, а ваш секрет действует, пока вы его не поменяете.
• Он не привязан к вам. Кто получит секрет, тот получит доступ — второго фактора не будет.
• Пароль приложения даёт полный доступ к ящику и лежит в Vercel.

Если секрет засветился — меняете его в Vercel, передеплоите, и старый мёртв. Минутное дело. Отдельный пароль приложения тоже отзывается в почте одной кнопкой, не трогая основной пароль.

Если почта рабочая и в ней договоры и клиенты — имеет смысл делать вход через OAuth. Это уровень готового коннектора из каталога, но заметно сложнее: нужно регистрировать приложение у провайдера и добавлять хранилище токенов. На старте разумно запуститься на секрете, а на OAuth перейти позже — код работы с почтой при этом не меняется, меняется только вход.

Почему отправка идёт через черновик

В схеме нет инструмента «отправь письмо такому-то с таким текстом». Есть только «создай черновик» и «отправь вот этот черновик». Разница принципиальная: между решением модели и уходящим письмом всегда стоит ваш взгляд на готовый текст.

Дополнительно инструмент отправки помечен как необратимый — claude.ai показывает отдельное подтверждение перед вызовом. В настройках коннектора для него можно выставить «всегда спрашивать».

Про бесплатный тариф Vercel

По ресурсам его хватает с большим запасом — речь о секундах работы в день. Но тариф Hobby по правилам Vercel предназначен для некоммерческого использования. Если это почта компании, формально нужен платный тариф. Решать вам, я просто предупреждаю.

Где спотыкаются

• Пробуют обычный пароль от почтыНе сработает: почтовые сервисы требуют пароль приложения. Симптом — сервер отвечает, что логин отклонён.
• Не делают новый деплой после переменныхПеременные не подхватываются на лету. Сервер будет отвечать, что почта не настроена, хотя всё вписано.
• Генерируют секрет в окне ClaudeОн попадает в историю переписки. Только отдельный терминал.
• Прячут секрет в адрес коннектораАдрес с секретом уходит в логи Vercel. Заголовок — правильное место.
• Ищут поле для заголовка на первом экранеЕго там нет, оно появляется после кнопки Continue.
• Ждут, что подпись подставится самаЧерновик, созданный через IMAP, подписи почтового сервиса не получает. Если нужна — попросите Claude писать её в тексте.
• Забывают, что сервер живёт за границейVercel по умолчанию поднимает функции в США, и почтовый сервис увидит вход оттуда. Яндекс это пропускает, но некоторые провайдеры могут насторожиться и попросить подтверждение.

Что дальше

Когда почта подключена, появляется то, ради чего всё затевалось: разговор о переписке вместо копания в ней. «Что мы обсуждали с этим клиентом в марте», «собери всё, что писали про этот проект», «ответь на последнее письмо в том же тоне, что и раньше» — и всё это с телефона, потому что сервер живёт не на вашем компьютере.

Тот же приём работает с чем угодно, у чего есть API: календарь, таск-трекер, складская программа. Меняется только середина — как ходить в сервис, — а обвязка и способ подключения остаются теми же.