Resend Email

chính thức

Gửi email trực tiếp từ trình soạn thảo của bạn bằng Resend API.

Bạn có thể làm gì với Resend Email MCP?

  • Gửi và lên lịch email — Yêu cầu trợ lý gửi email HTML hoặc văn bản thuần với CC/BCC, địa chỉ trả lời, tệp đính kèm, thẻ và lịch gửi.
  • Quản lý danh bạ và phân khúc — Tạo, cập nhật và xóa danh bạ, quản lý thành viên phân khúc và đăng ký chủ đề, đồng thời chạy nhập dữ liệu CSV.
  • Chạy chiến dịch phát tin — Tạo, lên lịch, gửi hoặc hủy các đợt phát tin, sau đó xem lại người nhận theo loại sự kiện và các liên kết đã nhấp.
  • Xử lý email đến và hộp thư — Liệt kê và đọc email đã nhận, tải tệp đính kèm xuống, đồng thời quản lý chuỗi hội thoại, nhãn và thư nháp trong hộp thư.
  • Quản trị miền và danh sách chặn — Tạo, xác minh và cấu hình miền người gửi, đồng thời thêm hoặc xóa mục trong danh sách chặn.
  • Kiểm tra nhật ký và mức sử dụng — Xem lại nhật ký yêu cầu API kèm toàn bộ nội dung yêu cầu và phản hồi, đồng thời kiểm tra mức sử dụng và hạn mức tài khoản.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://mcp.resend.com/mcp'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Resend MCP Server

npm version

Kết nối tác nhân AI của bạn với nền tảng Resend. Gửi và nhận email, quản lý danh bạ, bản tin, miền và nhiều nội dung khác trực tiếp từ bất kỳ ứng dụng khách MCP nào như Claude, Cursor hoặc Claude Code.

Chúng tôi cung cấp cả máy chủ MCP từ xa do Resend lưu trữ và máy chủ MCP cục bộ (gói này).

Máy chủ MCP từ xa

Resend lưu trữ máy chủ MCP tại:

https://mcp.resend.com/mcp

Kết nối mọi ứng dụng khách MCP hỗ trợ máy chủ từ xa (Streamable HTTP). Bạn không cần cài đặt gì hay chạy tiến trình cục bộ nào, nên đây là lựa chọn tốt nhất cho các ứng dụng khách trên web như Claude và các nền tảng tác nhân được lưu trữ.

Khi kết nối, ứng dụng khách sẽ mở cửa sổ trình duyệt để bạn đăng nhập vào Resend và phê duyệt quyền truy cập bằng OAuth.

Claude Code

claude mcp add --transport http resend https://mcp.resend.com/mcp

Sau đó chạy /mcp trong Claude Code và chọn resend để hoàn tất đăng nhập OAuth.

Claude

Trong Claude (web hoặc máy tính), mở Settings > Connectors > Add custom connector rồi nhập:

https://mcp.resend.com/mcp

Cursor

Mở bảng lệnh và chọn "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

Để sử dụng GitHub Copilot trong VS Code, hãy thêm nội dung sau vào settings.json:

{
  "mcp": {
    "servers": {
      "resend": {
        "type": "http",
        "url": "https://mcp.resend.com/mcp"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "resend": {
      "serverUrl": "https://mcp.resend.com/mcp"
    }
  }
}

Warp

Trong Settings của Warp, chuyển đến Agents > MCP servers, rồi nhấp +Add để thêm máy chủ mới.

{
  "resend": {
    "serverUrl": "https://mcp.resend.com/mcp"
  }
}

Xác thực bằng khóa API

Nếu ứng dụng khách chạy ở nơi không thể đăng nhập bằng trình duyệt (máy chủ, CI hoặc tác nhân không giao diện), hãy truyền khóa API Resend dưới dạng Bearer token thay vì dùng OAuth.

Claude Code:

claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cấu hình JSON (Cursor, Windsurf và các ứng dụng khác), thêm tiêu đề Authorization:

{
  "mcpServers": {
    "resend": {
      "url": "https://mcp.resend.com/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Máy chủ MCP cục bộ

Máy chủ được lưu trữ chạy cùng mã nguồn mở có trên NPM dưới dạng resend-mcp. Nếu muốn tự chạy máy chủ, bạn có thể tích hợp máy chủ này vào mọi ứng dụng khách MCP được hỗ trợ bằng npx. Bạn cần:

Máy chủ cục bộ hỗ trợ hai chế độ truyền tải: stdio (mặc định) và HTTP.

Chọn chế độ và ứng dụng khách bạn muốn bên dưới để bắt đầu. Nhớ thay re_xxxxxxxxx bằng khóa API thực tế của bạn.

Truyền tải Stdio (Mặc định)

Thiết lập nhanh

Cài đặt cho tất cả tác nhân và trình soạn thảo được phát hiện/đã chọn:

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

Mở bảng lệnh và chọn "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Mở phần cài đặt Claude Desktop > thẻ "Developer" > "Edit Config".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Copilot

Để sử dụng GitHub Copilot trong VS Code, hãy thêm nội dung sau vào 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

Thêm vào cấu hình opencode.json của bạn:

{
  "$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

Trong Devin, mở Settings > Connections > MCP Servers rồi nhấp Add a custom MCP. Xem hướng dẫn Devin để biết các bước đầy đủ.

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx",
        "SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
      }
    }
  }
}

Truyền tải HTTP

Chạy máy chủ qua HTTP để tích hợp từ xa hoặc trên web, chẳng hạn như thông qua tunnel hoặc reverse proxy của riêng bạn, thay vì dùng máy chủ MCP từ xa được Resend lưu trữ. Ở chế độ HTTP, mỗi ứng dụng khách xác thực bằng cách truyền khóa API Resend dưới dạng Bearer token trong tiêu đề Authorization.

Khởi động máy chủ:

npx -y resend-mcp --http --port 3000

Máy chủ sẽ lắng nghe trên http://127.0.0.1:3000 và cung cấp điểm cuối MCP tại /mcp bằng Streamable HTTP.

Claude Code

claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"

Cursor

Mở bảng lệnh và chọn "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Bạn cũng có thể đặt cổng thông qua biến môi trường MCP_PORT:

MCP_PORT=3000 npx -y resend-mcp --http

Sử dụng như thư viện

Truyền tải HTTP cũng được xuất ra để có thể nhúng vào một dịch vụ khác thay vì chạy qua CLI. Mỗi ứng dụng khách kết nối sẽ xác thực bằng khóa API Resend riêng, được truyền dưới dạng Bearer token.

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);

Theo mặc định, máy chủ áp dụng xác thực Host chỉ cho localhost (bảo vệ chống DNS rebinding). Khi triển khai phía sau reverse proxy hoặc bộ cân bằng tải, nơi máy chủ được bảo vệ bằng Bearer API key cho từng yêu cầu, hãy đặt host thành 0.0.0.0 để Host được proxy chuyển tiếp và các yêu cầu kiểm tra tình trạng của bộ cân bằng tải không bị từ chối bằng 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'] });

Qua CLI, tùy chọn này tương ứng với --host / --allowed-hosts (hoặc MCP_HOST / MCP_ALLOWED_HOSTS).

Tùy chọn

Bạn có thể truyền thêm đối số để cấu hình máy chủ cục bộ:

  • --key: Khóa API Resend của bạn (chỉ dành cho chế độ stdio, vì chế độ HTTP sử dụng Bearer token từ ứng dụng khách)
  • --sender: Địa chỉ email người gửi mặc định từ miền đã xác minh
  • --reply-to: Địa chỉ email trả lời mặc định (có thể chỉ định nhiều lần)
  • --http: Dùng truyền tải HTTP thay cho stdio (mặc định: stdio)
  • --port: Cổng HTTP khi dùng --http (mặc định: 3000 hoặc biến môi trường MCP_PORT)
  • --host: Máy chủ lưu trữ dùng để bảo vệ chống DNS rebinding khi dùng --http (mặc định: 127.0.0.1 hoặc MCP_HOST). Đặt thành 0.0.0.0 để tắt xác thực Host phía sau proxy/bộ cân bằng tải.
  • --allowed-hosts: Danh sách cho phép Host phân tách bằng dấu phẩy khi dùng --http (hoặc MCP_ALLOWED_HOSTS)
  • --allowed-file-dirs: Các thư mục phân tách bằng dấu phẩy mà tệp đính kèm cục bộ và tệp CSV nhập vào có thể được đọc từ đó (hoặc MCP_ALLOWED_FILE_DIRS). Không giới hạn trong stdio nếu không đặt; luôn bị tắt qua --http trừ khi được đặt.

Biến môi trường:

  • RESEND_API_KEY: Khóa API Resend của bạn (bắt buộc với stdio, không bắt buộc với HTTP vì ứng dụng khách truyền khóa qua Bearer token)
  • SENDER_EMAIL_ADDRESS: Địa chỉ email người gửi mặc định từ miền đã xác minh (không bắt buộc)
  • REPLY_TO_EMAIL_ADDRESSES: Các địa chỉ email trả lời phân tách bằng dấu phẩy (không bắt buộc)
  • MCP_PORT: Cổng HTTP khi dùng --http (không bắt buộc)
  • MCP_HOST: Máy chủ lưu trữ dùng để bảo vệ chống DNS rebinding khi dùng --http (không bắt buộc)
  • MCP_ALLOWED_HOSTS: Danh sách cho phép Host phân tách bằng dấu phẩy khi dùng --http (không bắt buộc)
  • MCP_ALLOWED_FILE_DIRS: Các thư mục phân tách bằng dấu phẩy mà tệp cục bộ có thể được đọc từ đó (không bắt buộc)

[!NOTE] Nếu không cung cấp địa chỉ email người gửi, máy chủ MCP sẽ yêu cầu bạn cung cấp địa chỉ mỗi khi gọi công cụ.

[!WARNING] send-email (attachments[].filePath) và create-contact-import (filePath) đọc tệp cục bộ. Qua --http, tính năng này mặc định bị tắt để ứng dụng khách từ xa không thể đọc ổ đĩa của máy chủ; dùng --allowed-file-dirs để cho phép các thư mục cụ thể. Với stdio, đặt --allowed-file-dirs để ngăn tác nhân bị chèn prompt đính kèm tệp bên ngoài các thư mục bạn chọn.

Công cụ của máy chủ MCP

Máy chủ MCP của Resend cung cấp cho tác nhân AI quyền truy cập gốc vào toàn bộ nền tảng Resend thông qua một tích hợp duy nhất. Bạn có thể quản lý mọi khía cạnh của hạ tầng email bằng ngôn ngữ tự nhiên.

  • Email: Gửi, liệt kê, lấy, hủy, cập nhật, chia sẻ và gửi email hàng loạt. Truy xuất số liệu về gửi và tương tác. Hỗ trợ HTML, văn bản thuần, tệp đính kèm (tệp cục bộ, URL hoặc base64), CC/BCC, địa chỉ trả lời, lên lịch, thẻ, tiêu đề tùy chỉnh, gửi theo chủ đề và khóa idempotency.
  • Email đã nhận: Liệt kê và đọc email đến. Liệt kê và tải xuống tệp đính kèm của email đã nhận.
  • Hộp thư đến: Tạo, liệt kê, lấy, cập nhật và xóa hộp thư đến. Đọc và cập nhật cài đặt tác nhân của hộp thư đến. Liệt kê, tìm kiếm, lấy, cập nhật và xóa chuỗi hội thoại, đồng thời thêm, đặt hoặc xóa nhãn của chúng. Liệt kê và lấy email trong chuỗi hội thoại, cũng như trả lời hoặc chuyển tiếp chúng kèm tệp đính kèm và tiêu đề tùy chỉnh. Tạo, liệt kê, cập nhật và xóa nhãn. Tạo, liệt kê, lấy, cập nhật, xóa và gửi bản nháp, với tệp đính kèm từ nội dung base64 hoặc URL. Gửi email mới từ hộp thư đến để bắt đầu chuỗi hội thoại. Hỗ trợ khóa idempotency khi trả lời, chuyển tiếp, tạo bản nháp, gửi bản nháp và gửi email mới.
  • Mẫu: Tạo, liệt kê, lấy, cập nhật, xuất bản, sao chép và xóa mẫu email. Hỗ trợ soạn nội dung mẫu và các placeholder {{{VARIABLE}}}.
  • Danh bạ: Tạo, liệt kê, lấy, cập nhật và xóa danh bạ. Quản lý tư cách thành viên phân khúc, đăng ký chủ đề và nhập danh bạ từ CSV. Hỗ trợ thuộc tính danh bạ tùy chỉnh.
  • Bản tin: Tạo, gửi, hủy, sao chép, liệt kê, lấy, cập nhật và xóa chiến dịch bản tin. Liệt kê các liên kết đã nhấp trong bản tin và người nhận theo loại sự kiện (đã gửi, đã chuyển, đã mở, đã nhấp, bị trả lại, khiếu nại, hủy đăng ký, bị chặn). Hỗ trợ lên lịch, placeholder cá nhân hóa và văn bản xem trước.
  • Tự động hóa: Tạo, liệt kê, lấy, cập nhật, sao chép và xóa quy trình tự động hóa. Xem lại các lượt chạy của một quy trình tự động hóa.
  • Sự kiện: Gửi sự kiện để kích hoạt quy trình tự động hóa cho một liên hệ. Tạo, cập nhật và xóa định nghĩa sự kiện.
  • Miền: Tạo, liệt kê, lấy, cập nhật, xóa và xác minh miền người gửi. Cấu hình khả năng theo dõi, TLS, gửi và nhận. Tạo và xác minh yêu cầu xác nhận quyền sở hữu miền.
  • Phân khúc: Tạo, liệt kê, lấy, cập nhật và xóa phân khúc đối tượng.
  • Danh sách chặn: Liệt kê, lấy, thêm và xóa mục trong danh sách chặn, riêng lẻ hoặc hàng loạt. Địa chỉ bị trả lại vĩnh viễn và khiếu nại spam sẽ tự động bị chặn; thêm địa chỉ theo cách thủ công để đáp ứng yêu cầu không liên hệ.
  • Chủ đề: Tạo, liệt kê, lấy, cập nhật và xóa chủ đề đăng ký.
  • Thuộc tính liên hệ: Tạo, liệt kê, lấy, cập nhật và xóa thuộc tính liên hệ tùy chỉnh.
  • Khóa API: Tạo, liệt kê, cập nhật và xóa khóa API.
  • Webhook: Tạo, liệt kê, lấy, cập nhật và xóa webhook dùng để thông báo sự kiện, đồng thời kiểm tra lịch sử gửi — các sự kiện được gửi đến webhook, payload của một sự kiện và các lần thử gửi. Phát lại một sự kiện để xếp hàng gửi lại và xoay vòng khóa bí mật ký của webhook.
  • Nhật ký: Liệt kê và kiểm tra nhật ký yêu cầu API, bao gồm toàn bộ nội dung yêu cầu và phản hồi.
  • Mức sử dụng: Truy xuất thông tin mức sử dụng và hạn mức ở cấp tài khoản: email, danh bạ, phân khúc, bản tin, tín dụng AI, lượt chạy tự động hóa, miền và giới hạn tốc độ API.
  • Trình chỉnh sửa: Kết nối với (và ngắt kết nối khỏi) trình chỉnh sửa trực quan trong bảng điều khiển Resend, đồng thời đọc nội dung bản nháp khi cộng tác trên bản tin và mẫu.

Phát triển cục bộ

  1. Sao chép dự án này và build:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. Để dùng bản build cục bộ, thay lệnh npx bằng đường dẫn đến bản build cục bộ của bạn:

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

Kiểm thử trực tiếp bằng ứng dụng khách MCP

Trong quá trình phát triển, bạn có thể kiểm thử các thay đổi trong một phiên ứng dụng khách MCP thực tế trong khi chỉnh sửa mã ở nơi khác.

Ý tưởng là: chạy tsc --watch để liên tục build lại dist/, rồi trỏ một ứng dụng khách MCP riêng đến dist/index.js đã build từ một thư mục khác. Khi muốn áp dụng các thay đổi mã, hãy khởi động lại phiên ứng dụng khách MCP (máy chủ MCP là các tiến trình stdio chạy lâu dài và không tự tải lại nóng).

Ví dụ với Claude Code:

  1. Chạy trình theo dõi TypeScript để tự động build lại khi lưu:

    pnpm tsc --watch
    
  2. Trong một thư mục riêng, tạo .mcp.json trỏ đến đầu ra bản build:

    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. Khởi động Claude Code từ thư mục đó và sử dụng các công cụ MCP. Sau khi thay đổi mã, hãy bắt đầu một phiên Claude Code mới để dùng bản build mới.

Nguyên tắc tương tự áp dụng cho mọi ứng dụng khách MCP — tách môi trường kiểm thử khỏi môi trường phát triển, dùng đường dẫn tuyệt đối đến dist/index.js và kết nối lại máy chủ MCP sau khi build lại.

Kiểm thử bằng MCP Inspector

Lưu ý: Hãy đảm bảo bạn đã build dự án trước (xem phần Phát triển cục bộ ở trên).

Sử dụng truyền tải Stdio

  1. Đặt khóa API của bạn:

    export RESEND_API_KEY=re_your_key_here
    
  2. Khởi chạy inspector:

    pnpm inspector
    
  3. Trong trình duyệt (giao diện Inspector):

    • Chọn stdio (khởi chạy một tiến trình).
    • Lệnh: node
    • Đối số: dist/index.js (hoặc đường dẫn đầy đủ đến dist/index.js)
    • Biến môi trường: RESEND_API_KEY=re_your_key_here (hoặc để trống nếu bạn đã xuất biến này trong cùng terminal).
    • Nhấp Connect, sau đó dùng "List tools" để xác minh máy chủ đang hoạt động.

Sử dụng giao thức truyền tải HTTP

  1. Khởi chạy máy chủ HTTP trong một terminal:

    node dist/index.js --http --port 3000
    
  2. Khởi chạy inspector trong một terminal khác:

    pnpm inspector
    
  3. Trong trình duyệt (giao diện Inspector):

    • Chọn Streamable HTTP (kết nối với URL).
    • URL: http://127.0.0.1:3000/mcp
    • Thêm tiêu đề tùy chỉnh: Authorization: Bearer re_your_key_here và bật nút chuyển đổi.
    • Nhấp Connect, sau đó dùng "List tools" để xác minh máy chủ đang hoạt động.