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.

GitHub
559

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

  • Gửi và quản lý email — Yêu cầu AI của bạn gửi, lên lịch hoặc gửi hàng loạt email với HTML, tệp đính kèm, CC/BCC và tiêu đề tùy chỉnh bằng cách sử dụng sendEmail và các công cụ liên quan.
  • Quản lý danh bạ và đối tượng — Tạo, cập nhật, nhập hoặc xóa danh bạ, đồng thời quản lý tư cách thành viên phân khúc và đăng ký chủ đề của họ.
  • Tạo và gửi chiến dịch phát sóng — Soạn thảo, lên lịch và gửi email phát sóng với các trình giữ chỗ cá nhân hóa và văn bản xem trước.
  • Xác minh và cấu hình tên miền — Thêm, xác minh và cập nhật tên miền người gửi, bao gồm cài đặt theo dõi, TLS và nhận.
  • Kiểm tra nhật ký API và webhook — Truy xuất và kiểm tra nhật ký yêu cầu API với toàn bộ nội dung yêu cầu/phản hồi, đồng thời quản lý các điểm cuối webhook.
  • Cộng tác trên các mẫu và bản phát sóng — Kết nối với trình chỉnh sửa trực quan của Resend để đọc và lặp lại nội dung nháp cho các mẫu và bản phát sóng.

Tài liệu

Máy chủ MCP Resend

smithery badge 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ạ, chiến dịch gửi hàng loạt, tên miền và nhiều hơn nữa, 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 bất kỳ ứng dụng khách MCP nào hỗ trợ máy chủ từ xa (HTTP có thể truyền phát). Không cần cài đặt gì và không cần chạy tiến trình cục bộ, điều này làm cho nó trở thành lựa chọn tốt nhất cho các ứng dụng khách dựa trên web như Claude và các nền tảng tác nhân được lưu trữ.

Khi bạn kết nối, ứng dụng khách của bạn sẽ mở một cửa sổ trình duyệt để đă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 để bàn), mở Cài đặt > Trình kết nối > Thêm trình kết nối tùy chỉnh và nhập:

https://mcp.resend.com/mcp

Cursor

Mở bảng lệnh và chọn "Cài đặt Cursor" > "MCP" > "Thêm máy chủ MCP toàn cục mới".

{
  "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, thêm phần sau vào settings.json của bạn:

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

Windsurf

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

Warp

Trong Cài đặt của Warp, điều hướng đến Tác nhân > Máy chủ MCP, và nhấp +Thêm để 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 của bạn 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 đầu), hãy truyền khóa API Resend dưới dạng mã thông báo Bearer thay vì sử 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ó sẵn trên NPM với tên resend-mcp. Nếu bạn muốn tự chạy máy chủ, bạn có thể tích hợp nó vào bất kỳ ứng dụng khách MCP được hỗ trợ nào bằng cách sử dụng npx. Bạn sẽ 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 ưa thích của bạn bên dưới để bắt đầu. Nhớ thay thế 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ả cá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 "Cài đặt Cursor" > "MCP" > "Thêm máy chủ MCP toàn cục mới".

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

Claude Desktop

Mở cài đặt Claude Desktop > tab "Nhà phát triển" > "Chỉnh sửa Cấu hình".

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

Copilot

Để sử dụng GitHub Copilot trong VS Code, thêm phần sau vào settings.json của bạn:

{
  "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ở Cài đặt > Kết nối > Máy chủ MCP và nhấp Thêm MCP tùy chỉnh. 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 cho các tích hợp từ xa hoặc dựa trên web, ví dụ như phía sau đường hầm hoặc proxy ngược của riêng bạn, thay vì sử dụng máy chủ MCP từ xa được lưu trữ của Resend. Ở chế độ HTTP, mỗi ứng dụng khách xác thực bằng cách truyền khóa API Resend của họ dưới dạng mã thông báo Bearer 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à hiển thị điểm cuối MCP tại /mcp sử dụng HTTP có thể truyền phát.

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 "Cài đặt Cursor" > "MCP" > "Thêm máy chủ MCP toàn cục mới".

{
  "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ư một 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 xác thực bằng khóa API Resend của riêng họ được truyền dưới dạng mã thông báo 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);

Theo mặc định, máy chủ áp dụng xác thực Host chỉ localhost (bảo vệ chống rebinding DNS). Khi triển khai phía sau proxy ngược hoặc bộ cân bằng tải, nơi máy chủ được bảo vệ bởi khóa API Bearer cho mỗi yêu cầu, hãy đặt host thành 0.0.0.0 để Host được chuyển tiếp của proxy và các kiểm tra sức khỏe của bộ cân bằng tải không bị từ chối với 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, điều này ánh xạ tới --host / --allowed-hosts (hoặc MCP_HOST / MCP_ALLOWED_HOSTS).

Tùy chọn

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

  • --key: Khóa API Resend của bạn (chỉ chế độ stdio, vì chế độ HTTP sử dụng mã thông báo Bearer từ ứng dụng khách)
  • --sender: Địa chỉ email người gửi mặc định từ một tên 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: Sử dụng truyền tải HTTP thay vì stdio (mặc định: stdio)
  • --port: Cổng HTTP khi sử dụng --http (mặc định: 3000, hoặc biến môi trường MCP_PORT)
  • --host: Máy chủ để bảo vệ chống rebinding DNS khi sử 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 được phân tách bằng dấu phẩy khi sử dụng --http (hoặc MCP_ALLOWED_HOSTS)

Biến môi trường:

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

[!LƯU Ý] Nếu bạn 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 mỗi khi bạn gọi công cụ.

Công cụ Máy chủ MCP

Máy chủ MCP của Resend cung cấp cho tác nhân AI của bạn 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ý tất cả các khía cạnh của cơ sở 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 và gửi hàng loạt email. Hỗ trợ HTML, văn bản thuần túy, tệp đính kèm (tệp cục bộ, URL hoặc base64), CC/BCC, trả lời, lên lịch, thẻ, tiêu đề tùy chỉnh, gửi dựa trên 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 email đã nhận.
  • Mẫu: Tạo, liệt kê, lấy, cập nhật, xuất bản, sao chép và xóa các mẫu email. Hỗ trợ soạn nội dung mẫu và trình giữ chỗ {{{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ạ CSV. Hỗ trợ thuộc tính danh bạ tùy chỉnh.
  • Chiến dịch Gửi hàng loạt: Tạo, gửi, liệt kê, lấy, cập nhật và xóa các chiến dịch gửi hàng loạt. Hỗ trợ lên lịch, trình giữ chỗ 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 và xóa các tự động hóa. Xem xét các lần chạy của một tự động hóa.
  • Sự kiện: Gửi sự kiện để kích hoạt 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.
  • Tên miền: Tạo, liệt kê, lấy, cập nhật, xóa và xác minh tên miền người gửi. Cấu hình theo dõi, TLS và khả năng gửi/nhận. Tạo và xác minh xác nhận quyền sở hữu tên miền.
  • Phân khúc: Tạo, liệt kê, lấy và xóa các phân khúc đối tượng.
  • Chặn: Liệt kê, lấy, thêm và xóa các mục trong danh sách chặn, riêng lẻ hoặc hàng loạt. Các thư bị trả lại cứng và khiếu nại spam được tự động chặn; thêm địa chỉ thủ công để tôn trọ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 các chủ đề đăng ký.
  • Thuộc tính Liên hệ: Tạo, liệt kê, lấy, cập nhật và xóa các thuộc tính liên hệ tùy chỉnh.
  • Khóa API: Tạo, liệt kê và xóa khóa API.
  • Webhook: Tạo, liệt kê, lấy, cập nhật và xóa webhook cho thông báo sự kiện.
  • 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.
  • Trình soạn thảo: Kết nối với (và ngắt kết nối khỏi) trình soạn thảo trực quan trong bảng điều khiển Resend, và đọc nội dung bản nháp trong khi cộng tác trên các chiến dịch gửi hàng loạt và mẫu.

Phát triển Cục bộ

  1. Sao chép dự án này và xây dựng:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. Để sử dụng bản dựng cục bộ, thay thế lệnh npx bằng đường dẫn đến bản dựng 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 với Ứng dụng khách MCP

Khi phát triển, bạn có thể kiểm tra 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ã ở một nơi khác.

Ý tưởng: chạy tsc --watch để liên tục xây dựng lại dist/, và trỏ một ứng dụng khách MCP riêng biệt đến dist/index.js đã xây dựng từ một thư mục khác. Khi bạn 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 dài không tự tải lại khi có thay đổi).

Ví dụ với Claude Code:

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

    pnpm tsc --watch

  2. Trong một thư mục riêng biệt, tạo một .mcp.json trỏ đến đầu ra bản dựng:

    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 thực hiện thay đổi mã, hãy bắt đầu một phiên Claude Code mới để áp dụng bản dựng mới.

Nguyên tắc tương tự áp dụng cho bất kỳ ứng dụng khách MCP nào — tách biệt môi trường kiểm thử của bạn khỏi môi trường phát triển, sử 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 xây dựng lại.

Kiểm thử với MCP Inspector

Lưu ý: Đảm bảo bạn đã xây dựng 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 động trình kiểm tra:

    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 nó trong cùng một terminal).
    • Nhấp Kết nối, sau đó sử dụng "Liệt kê công cụ" để xác minh máy chủ đang hoạt động.

Sử dụng Truyền tải HTTP

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

    node dist/index.js --http --port 3000

  2. Khởi động trình kiểm tra trong một terminal khác:

    pnpm inspector

  3. Trong trình duyệt (Giao diện Inspector):

    • Chọn HTTP có thể truyền phát (kết nối đến URL).
    • URL: http://127.0.0.1:3000/mcp
    • Thêm tiêu đề tùy chỉnh: Authorization: Bearer re_your_key_here và kích hoạt nút chuyển đổi.
    • Nhấp Kết nối, sau đó sử dụng "Liệt kê công cụ" để xác minh máy chủ đang hoạt động.