MCP-сервер Resend

MCP-сервер для платформы Resend. Отправляйте и получайте электронные письма, управляйте контактами, рассылками, доменами и многим другим — напрямую из любого MCP-клиента, такого как Claude Desktop, Cursor или Claude Code.

Возможности

• Письма — Отправка, получение списка, просмотр, отмена, обновление и массовая рассылка писем. Поддержка HTML, обычного текста, вложений (локальный файл, URL или base64), CC/BCC, адреса для ответа, планирования, тегов и отправки по темам.

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

• Контакты — Создание, просмотр списка, получение, обновление и удаление контактов. Управление членством в сегментах и подписками на темы. Поддержка пользовательских свойств контактов.

• Рассылки (Broadcasts) — Создание, отправка, просмотр списка, получение, обновление и удаление кампаний рассылок. Поддержка планирования, плейсхолдеров персонализации и текста превью.

• Домены — Создание, просмотр списка, получение, обновление, удаление и верификация доменов отправителя. Настройка отслеживания, TLS и возможностей отправки/получения.

• Сегменты — Создание, просмотр списка, получение и удаление сегментов аудитории.

• Темы (Topics) — Создание, просмотр списка, получение, обновление и удаление тем подписки.

• Свойства контактов — Создание, просмотр списка, получение, обновление и удаление пользовательских атрибутов контактов.

• API-ключи — Создание, просмотр списка и удаление API-ключей.

• Вебхуки — Создание, просмотр списка, получение, обновление и удаление вебхуков для уведомлений о событиях.

Related MCP server: blastengine-mailer

Настройка

Создайте бесплатную учетную запись Resend и создайте API-ключ. Чтобы отправлять письма на адреса, отличные от ваших собственных, вам потребуется верифицировать свой домен.

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

Сервер поддерживает два транспортных режима: stdio (по умолчанию) и HTTP.

Транспорт Stdio (по умолчанию)

Claude Code

claude mcp add resend -e 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"
      }
    }
  }
}

Транспорт HTTP

Запустите сервер через HTTP для удаленных или веб-интеграций. В режиме 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

Опции

Вы можете передать дополнительные аргументы для настройки сервера:

• --key: Ваш API-ключ Resend (только для режима stdio; в режиме HTTP используется Bearer-токен от клиента)

• --sender: Адрес отправителя по умолчанию из верифицированного домена

• --reply-to: Адрес для ответа по умолчанию (можно указать несколько раз)

• --http: Использовать транспорт HTTP вместо stdio (по умолчанию: stdio)

• --port: HTTP-порт при использовании --http (по умолчанию: 3000 или переменная окружения MCP_PORT)

Переменные окружения:

• RESEND_API_KEY: Ваш API-ключ Resend (обязательно для stdio, опционально для HTTP, так как клиенты передают его через Bearer-токен)

• SENDER_EMAIL_ADDRESS: Адрес отправителя по умолчанию из верифицированного домена (опционально)

• REPLY_TO_EMAIL_ADDRESSES: Адреса для ответа, разделенные запятыми (опционально)

• MCP_PORT: HTTP-порт при использовании --http (опционально)

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

1. Клонируйте этот проект и выполните сборку:

git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build

2. Чтобы использовать локальную сборку, замените команду 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", чтобы убедиться, что сервер работает.