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

npm version

Подключите своего ИИ-агента к платформе 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 и отключение от него, а также чтение содержимого черновика при совместной работе над рассылками и шаблонами.

Локальная разработка

  1. Клонируйте этот проект и соберите его:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. Чтобы использовать локальную сборку, замените команду 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:

  1. Запустите наблюдатель TypeScript, чтобы автоматически пересобирать проект при сохранении:

    pnpm tsc --watch
    
  2. В отдельном каталоге создайте .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"
          }
        }
      }
    }
    
  3. Запустите Claude Code из этого каталога и используйте инструменты MCP. После внесения изменений в код запустите новый сеанс Claude Code, чтобы применить новую сборку.

Тот же принцип применим к любому MCP-клиенту: отделите тестовую среду от среды разработки, укажите абсолютный путь к dist/index.js и переподключите MCP-сервер после сборки.

Тестирование с помощью MCP Inspector

Примечание: сначала соберите проект (см. раздел Локальная разработка выше).

Использование транспорта stdio

  1. Укажите свой API-ключ:

    export RESEND_API_KEY=re_your_key_here
    
  2. Запустите инспектор:

    pnpm inspector
    
  3. В браузере (интерфейс инспектора):

    • Выберите stdio (запуск процесса).
    • Команда: node
    • Аргументы: dist/index.js (или полный путь к dist/index.js)
    • Переменные окружения: RESEND_API_KEY=re_your_key_here (или оставьте поле пустым, если уже экспортировали переменную в том же терминале).
    • Нажмите Connect, затем выберите «List tools», чтобы проверить работу сервера.

Использование HTTP-транспорта

  1. Запустите HTTP-сервер в одном терминале:

    node dist/index.js --http --port 3000
    
  2. Запустите инспектор в другом терминале:

    pnpm inspector
    
  3. В браузере (интерфейс инспектора):

    • Выберите Streamable HTTP (подключение по URL).
    • URL: http://127.0.0.1:3000/mcp
    • Добавьте пользовательский заголовок: Authorization: Bearer re_your_key_here и включите переключатель.
    • Нажмите Connect, затем выберите «List tools», чтобы проверить работу сервера.