Resend Email
официальныйОтправляйте электронные письма прямо из редактора с помощью Resend API.
Что можно делать с Resend Email MCP?
- Отправка и планирование писем — Попросите ассистента отправить письмо в формате HTML или обычного текста с копией и скрытой копией, адресом для ответа, вложениями, тегами и отложенной отправкой.
- Управление контактами и сегментами — Создавайте, обновляйте и удаляйте контакты, управляйте участниками сегментов и подписками на темы, а также импортируйте данные из CSV.
- Проведение массовых рассылок — Создавайте, планируйте, отправляйте или отменяйте массовые рассылки, а затем просматривайте получателей по типу события и ссылкам, по которым они переходили.
- Обработка входящих писем и почтовых ящиков — Просматривайте список и содержимое полученных писем, скачивайте вложения, управляйте цепочками писем, метками и черновиками.
- Администрирование доменов и списков подавления — Создавайте, проверяйте и настраивайте домены отправителей, а также добавляйте записи в списки подавления и удаляйте их оттуда.
- Просмотр журналов и использования — Просматривайте журналы запросов API с полным содержимым запросов и ответов, а также проверяйте использование ресурсов аккаунта и квоты.
Размещённый MCP-сервер
npx add-mcp 'https://mcp.resend.com/mcp'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
MCP-сервер Resend
Подключите своего ИИ-агента к платформе Resend. Отправляйте и получайте электронные письма, управляйте контактами, рассылками, доменами и многим другим прямо из любого MCP-клиента, например Claude, Cursor или Claude Code.
Мы предлагаем удалённый MCP-сервер, размещённый на Resend, и локальный MCP-сервер (этот пакет).
Удалённый MCP-сервер
Resend размещает MCP-сервер по адресу:
https://mcp.resend.com/mcp
Подключите любой MCP-клиент с поддержкой удалённых серверов (Streamable HTTP). Ничего устанавливать и запускать локально не нужно, поэтому это лучший вариант для веб-клиентов, таких как Claude, и размещённых платформ агентов.
При подключении клиент откроет окно браузера, чтобы вы могли войти в Resend и подтвердить доступ через OAuth.
Claude Code
claude mcp add --transport http resend https://mcp.resend.com/mcp
Затем выполните /mcp в Claude Code и выберите resend, чтобы завершить вход через OAuth.
Claude
В Claude (веб-версия или приложение для компьютера) откройте Settings > Connectors > Add custom connector и введите:
https://mcp.resend.com/mcp
Cursor
Откройте палитру команд и выберите "Cursor Settings" > "MCP" > "Add new global MCP server".
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp"
}
}
}
Codex
codex mcp add resend --url https://mcp.resend.com/mcp
Copilot
Чтобы использовать GitHub Copilot в VS Code, добавьте следующий фрагмент в settings.json:
{
"mcp": {
"servers": {
"resend": {
"type": "http",
"url": "https://mcp.resend.com/mcp"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
}
Warp
В настройках Warp перейдите в Agents > MCP servers и нажмите +Add, чтобы добавить новый сервер.
{
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
Аутентификация с помощью API-ключа
Если клиент работает там, где вход через браузер невозможен (на сервере, в CI или в автономном агенте), передайте API-ключ Resend в качестве Bearer-токена вместо использования OAuth.
Claude Code:
claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Конфигурация JSON (Cursor, Windsurf и другие): добавьте заголовок Authorization:
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Локальный MCP-сервер
Размещённый сервер использует тот же код с открытым исходным кодом, который доступен на NPM как resend-mcp. Если вы предпочитаете запускать сервер самостоятельно, его можно интегрировать в любой поддерживаемый MCP-клиент с помощью npx. Для этого потребуется:
Локальный сервер поддерживает два режима передачи данных: stdio (по умолчанию) и HTTP.
Чтобы начать, выберите нужный режим и клиент ниже. Не забудьте заменить re_xxxxxxxxx своим API-ключом.
Передача данных через stdio (по умолчанию)
Быстрая настройка
Установите для всех обнаруженных или выбранных агентов и редакторов:
npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_xxxxxxxxx"
Claude Code
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- npx -y resend-mcp
Codex
codex mcp add resend \
--env RESEND_API_KEY=re_xxxxxxxxx \
-- npx -y resend-mcp
Cursor
Откройте палитру команд и выберите "Cursor Settings" > "MCP" > "Add new global MCP server".
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Claude Desktop
Откройте настройки Claude Desktop > вкладку "Developer" > "Edit Config".
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Copilot
Чтобы использовать GitHub Copilot в VS Code, добавьте следующий фрагмент в settings.json:
{
"mcp": {
"servers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
}
Gemini CLI
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
OpenCode
Добавьте в конфигурацию opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"resend": {
"type": "local",
"command": ["npx", "-y", "resend-mcp"],
"enabled": true,
"environment": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Devin
В Devin откройте Settings > Connections > MCP Servers и нажмите Add a custom MCP. Полную пошаговую инструкцию см. в руководстве Devin.
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx",
"SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
}
}
}
}
Передача данных через HTTP
Запустите сервер по HTTP для удалённых интеграций или веб-интеграций, например за собственным туннелем или обратным прокси, вместо использования размещённого удалённого MCP-сервера Resend. В режиме HTTP каждый клиент проходит аутентификацию, передавая свой API-ключ Resend в качестве Bearer-токена в заголовке Authorization.
Запустите сервер:
npx -y resend-mcp --http --port 3000
Сервер будет прослушивать http://127.0.0.1:3000 и предоставлять конечную точку MCP по адресу /mcp, используя Streamable HTTP.
Claude Code
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor
Откройте палитру команд и выберите "Cursor Settings" > "MCP" > "Add new global MCP server".
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Порт также можно задать с помощью переменной окружения MCP_PORT:
MCP_PORT=3000 npx -y resend-mcp --http
Использование в качестве библиотеки
Транспорт HTTP также экспортируется, поэтому его можно встроить в другой сервис, а не запускать через CLI. Каждый подключающийся клиент проходит аутентификацию с помощью собственного API-ключа Resend, передаваемого в качестве Bearer-токена.
import { runHttp } from 'resend-mcp/http';
// Options are optional — pass `senderEmailAddress` / `replierEmailAddresses`
// to set defaults. Binds the port and returns the Node http.Server, exposing
// the MCP endpoint at POST/GET/DELETE /mcp and a GET /health check.
const server = await runHttp({}, 3000);
По умолчанию сервер выполняет проверку Host, разрешающую только localhost (защита от DNS-rebinding). При развёртывании за обратным прокси или балансировщиком нагрузки, где сервер защищён Bearer API-ключом для каждого запроса, задайте host значение 0.0.0.0, чтобы перенаправляемый прокси заголовок Host и проверки работоспособности балансировщика нагрузки не отклонялись с ошибкой 403 Invalid Host:
const server = await runHttp({}, 3000, { host: '0.0.0.0' });
// or pin specific hostnames instead of disabling validation:
const server = await runHttp({}, 3000, { allowedHosts: ['mcp.example.com'] });
В CLI этому соответствуют --host / --allowed-hosts (или MCP_HOST / MCP_ALLOWED_HOSTS).
Параметры
Для настройки локального сервера можно передать дополнительные аргументы:
--key: API-ключ Resend (только для режима stdio, поскольку в режиме HTTP используется Bearer-токен клиента)--sender: адрес электронной почты отправителя по умолчанию с подтверждённого домена--reply-to: адрес электронной почты для ответов по умолчанию (можно указать несколько раз)--http: использовать транспорт HTTP вместо stdio (по умолчанию: stdio)--port: порт HTTP при использовании--http(по умолчанию: 3000 или переменная окруженияMCP_PORT)--host: хост для защиты от DNS-rebinding при использовании--http(по умолчанию:127.0.0.1илиMCP_HOST). Задайте значение0.0.0.0, чтобы отключить проверкуHostза прокси или балансировщиком нагрузки.--allowed-hosts: список разрешённых значенийHost, разделённых запятыми, при использовании--http(илиMCP_ALLOWED_HOSTS)--allowed-file-dirs: каталоги, из которых можно читать локальные вложения и импортируемые CSV-файлы; укажите их через запятую (илиMCP_ALLOWED_FILE_DIRS). Если параметр не задан, в режиме stdio доступ не ограничен; в режиме--httpдоступ всегда отключён, если параметр не задан.
Переменные окружения:
RESEND_API_KEY: API-ключ Resend (обязателен для stdio, необязателен для HTTP, поскольку клиенты передают его через Bearer-токен)SENDER_EMAIL_ADDRESS: адрес электронной почты отправителя по умолчанию с подтверждённого домена (необязательно)REPLY_TO_EMAIL_ADDRESSES: адреса электронной почты для ответов, разделённые запятыми (необязательно)MCP_PORT: порт HTTP при использовании--http(необязательно)MCP_HOST: хост для защиты от DNS-rebinding при использовании--http(необязательно)MCP_ALLOWED_HOSTS: список разрешённых значенийHost, разделённых запятыми, при использовании--http(необязательно)MCP_ALLOWED_FILE_DIRS: каталоги, из которых можно читать локальные файлы; укажите их через запятую (необязательно)
[!NOTE] Если не указать адрес электронной почты отправителя, MCP-сервер будет запрашивать его при каждом вызове инструмента.
[!WARNING]
send-email(attachments[].filePath) иcreate-contact-import(filePath) читают локальные файлы. В режиме--httpэта возможность по умолчанию отключена, чтобы удалённые клиенты не могли читать файлы на диске сервера; используйте--allowed-file-dirs, чтобы разрешить доступ к определённым каталогам. В режиме stdio задайте--allowed-file-dirs, чтобы агент, подвергшийся внедрению инструкций, не мог прикреплять файлы из папок за пределами выбранных вами.
Инструменты MCP-сервера
MCP-сервер Resend предоставляет вашему ИИ-агенту встроенный доступ ко всей платформе Resend через единую интеграцию. Управляйте всеми аспектами инфраструктуры электронной почты с помощью запросов на естественном языке.
- Электронные письма: отправка, просмотр списка, получение, отмена, обновление, предоставление доступа и пакетная отправка писем. Получение показателей доставки и вовлечённости. Поддерживаются HTML, обычный текст, вложения (локальный файл, URL или base64), CC/BCC, адрес для ответов, планирование отправки, теги, пользовательские заголовки, отправка по темам и ключи идемпотентности.
- Полученные письма: просмотр списка и чтение входящих писем. Просмотр списка и скачивание вложений из полученных писем.
- Входящие: создание, просмотр списка, получение, обновление и удаление входящих. Чтение и обновление настроек агента входящих. Просмотр списка, поиск, получение, обновление и удаление цепочек писем, а также добавление, установка и удаление их меток. Просмотр списка и получение писем из цепочек, ответы на них и их пересылка с вложениями и пользовательскими заголовками. Создание, просмотр списка, обновление и удаление меток. Создание, просмотр списка, получение, обновление, удаление и отправка черновиков с вложениями в виде содержимого base64 или URL. Отправка нового письма из входящих для начала цепочки. Поддерживаются ключи идемпотентности при ответе, пересылке, создании и отправке черновиков, а также при отправке новых писем.
- Шаблоны: создание, просмотр списка, получение, обновление, публикация, дублирование и удаление шаблонов писем. Поддерживаются создание содержимого шаблонов и заполнители
{{{VARIABLE}}}. - Контакты: создание, просмотр списка, получение, обновление и удаление контактов. Управление членством в сегментах, подписками на темы и импортом контактов из CSV. Поддерживаются пользовательские свойства контактов.
- Рассылки: создание, отправка, отмена, дублирование, просмотр списка, получение, обновление и удаление кампаний рассылок. Просмотр списка ссылок, по которым переходили в рассылке, и её получателей по типу события (отправлено, доставлено, открыто, переход по ссылке, возврат, жалоба, отписка, подавлено). Поддерживаются планирование отправки, заполнители персонализации и текст предварительного просмотра.
- Автоматизации: создание, просмотр списка, получение, обновление, дублирование и удаление автоматизаций. Просмотр запусков автоматизации.
- События: отправка событий для запуска автоматизаций для контакта. Создание, обновление и удаление определений событий.
- Домены: создание, просмотр списка, получение, обновление, удаление и подтверждение доменов отправителя. Настройка отслеживания, TLS и возможностей отправки и получения. Создание и подтверждение заявок на домены.
- Сегменты: создание, просмотр списка, получение, обновление и удаление сегментов аудитории.
- Подавления: просмотр списка, получение, добавление и удаление записей в списке подавления по отдельности или пакетно. Жёсткие возвраты и жалобы на спам подавляются автоматически; добавляйте адреса вручную, чтобы учитывать запросы не связываться с получателем.
- Темы: создание, просмотр списка, получение, обновление и удаление тем подписки.
- Свойства контактов: создание, просмотр списка, получение, обновление и удаление пользовательских атрибутов контактов.
- API-ключи: создание, просмотр списка, обновление и удаление API-ключей.
- Вебхуки: создание, просмотр списка, получение, обновление и удаление вебхуков для уведомлений о событиях, а также просмотр истории их доставки — событий, отправленных вебхуку, данных одного события и попыток доставки. Повторная постановка события в очередь для новой доставки и смена ключа подписи вебхука.
- Журналы: просмотр списка и изучение журналов запросов API, включая полные тела запросов и ответов.
- Использование: получение сведений об использовании и квотах на уровне аккаунта: электронные письма, контакты, сегменты, рассылки, кредиты ИИ, запуски автоматизаций, домены и ограничение частоты запросов API.
- Редактор: подключение к визуальному редактору в панели управления Resend и отключение от него, а также чтение содержимого черновика при совместной работе над рассылками и шаблонами.
Локальная разработка
- Клонируйте этот проект и соберите его:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
- Чтобы использовать локальную сборку, замените команду
npxпутём к локальной сборке:
Claude Code (stdio):
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js
Claude Code (HTTP):
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor / Claude Desktop (stdio):
{
"mcpServers": {
"resend": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Cursor (HTTP):
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Тестирование в реальном сеансе MCP-клиента
При разработке можно проверять изменения в реальном сеансе MCP-клиента, редактируя код в другом окне.
Идея: запустите tsc --watch, чтобы непрерывно пересобирать dist/, а отдельный MCP-клиент направьте на собранный dist/index.js из другого каталога. Чтобы применить изменения кода, перезапустите сеанс MCP-клиента (MCP-серверы — это долгоживущие процессы stdio, которые не перезагружаются автоматически).
Пример с Claude Code:
-
Запустите наблюдатель TypeScript, чтобы автоматически пересобирать проект при сохранении:
pnpm tsc --watch -
В отдельном каталоге создайте
.mcp.json, указывающий на результат сборки:mkdir -p /tmp/mcp-test// /tmp/mcp-test/.mcp.json { "mcpServers": { "resend-dev": { "command": "node", "args": ["/absolute/path/to/resend-mcp/dist/index.js"], "env": { "RESEND_API_KEY": "re_xxxxxxxxx" } } } } -
Запустите Claude Code из этого каталога и используйте инструменты MCP. После внесения изменений в код запустите новый сеанс Claude Code, чтобы применить новую сборку.
Тот же принцип применим к любому MCP-клиенту: отделите тестовую среду от среды разработки, укажите абсолютный путь к dist/index.js и переподключите MCP-сервер после сборки.
Тестирование с помощью MCP Inspector
Примечание: сначала соберите проект (см. раздел Локальная разработка выше).
Использование транспорта stdio
-
Укажите свой API-ключ:
export RESEND_API_KEY=re_your_key_here -
Запустите инспектор:
pnpm inspector -
В браузере (интерфейс инспектора):
- Выберите stdio (запуск процесса).
- Команда:
node - Аргументы:
dist/index.js(или полный путь кdist/index.js) - Переменные окружения:
RESEND_API_KEY=re_your_key_here(или оставьте поле пустым, если уже экспортировали переменную в том же терминале). - Нажмите Connect, затем выберите «List tools», чтобы проверить работу сервера.
Использование HTTP-транспорта
-
Запустите HTTP-сервер в одном терминале:
node dist/index.js --http --port 3000 -
Запустите инспектор в другом терминале:
pnpm inspector -
В браузере (интерфейс инспектора):
- Выберите Streamable HTTP (подключение по URL).
- URL:
http://127.0.0.1:3000/mcp - Добавьте пользовательский заголовок:
Authorization: Bearer re_your_key_hereи включите переключатель. - Нажмите Connect, затем выберите «List tools», чтобы проверить работу сервера.