Sendmux Email MCP

chính thức

Sendmux là API hộp thư email và API email dành cho các tác nhân AI.

Xem trên sendmux.ai

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

Tìm kiếm tài liệu Sendmux — Yêu cầu trợ lý AI tra cứu hướng dẫn và tài liệu tham khảo API của Sendmux thông qua search_sendmux.
Làm việc với các hộp thư được cấp quyền — Tìm kiếm, đọc, sắp xếp và gửi thư từ các hộp thư bạn cấp quyền; nếu được cấp quyền cho nhiều hộp thư, hãy bắt đầu bằng mailbox_list_granted_mailboxes.
Quản lý tài nguyên nhóm — Quản lý miền, hộp thư, tài khoản gửi, nhật ký, chỉ số, thanh toán và webhook bằng quyền truy cập Management.
Gửi email đơn lẻ hoặc hàng loạt — Gửi một thư hoặc một lô thư qua giao diện Sending bằng khóa có quyền gửi hoặc mã thông báo tác nhân đã được phê duyệt.
Chọn thiết lập lưu trữ hoặc cục bộ — Kết nối qua OAuth lưu trữ tại https://mcp.sendmux.ai/mcp hoặc chạy gói sendmux-mcp cục bộ bằng các khóa dành riêng cho từng giao diện.

Tài liệu

MCP

Kết nối các công cụ AI với tài liệu và công cụ sản phẩm của Sendmux.

Sendmux có hai kết nối MCP. Dùng Doc Search MCP khi bạn muốn một công cụ AI tìm kiếm tài liệu Sendmux. Dùng MCP khi bạn muốn một tác nhân làm việc với các công cụ Sendmux mà bạn cấp quyền.

Kết nối	Dùng để	Máy chủ
Doc Search MCP	Tìm kiếm hướng dẫn và tài liệu tham khảo API của Sendmux.	`https://sendmux.ai/docs/mcp`
MCP	Dùng các công cụ Management, Mailbox và Sending.	`https://mcp.sendmux.ai/mcp` hoặc gói `sendmux-mcp` cục bộ

[!NOTE]

MCP cung cấp một bộ công cụ tác nhân được tuyển chọn, không phải mọi điểm cuối API. Hãy dùng SDK, CLI hoặc tài liệu tham khảo API khi bạn cần hỗ trợ đầy đủ các điểm cuối.

Doc Search MCP

Doc Search MCP cung cấp search_sendmux.

[accordion] Claude Code

claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp

[accordion] Cursor

Thêm máy chủ này vào .cursor/mcp.json cho một dự án hoặc ~/.cursor/mcp.json cho tất cả dự án.
{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] VS Code

Thêm máy chủ này vào mcp.json người dùng hoặc không gian làm việc của bạn.
{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}

[accordion] Codex

Thêm máy chủ này vào ~/.codex/config.toml hoặc .codex/config.toml đáng tin cậy.
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"

MCP

MCP cung cấp các bề mặt sản phẩm mà bạn cấp quyền.

Bề mặt	Dùng để	Quyền truy cập
Mailbox	Tìm kiếm, đọc, sắp xếp và gửi thư từ các hộp thư được cấp quyền.	Cấp quyền qua máy chủ với quyền truy cập Mailbox, khóa `smx_mbx_` hoặc mã thông báo `smx_agent_` có phạm vi giới hạn khi chạy cục bộ
Management	Quản lý tài nguyên nhóm như miền, hộp thư, tài khoản gửi, nhật ký, chỉ số, thanh toán và webhook.	Cấp quyền qua máy chủ với quyền truy cập Management hoặc khóa `smx_root_` khi chạy cục bộ
Sending	Gửi email đơn lẻ hoặc hàng loạt.	Cấp quyền qua máy chủ với quyền truy cập Sending, khóa `smx_mbx_` hoặc mã thông báo `smx_agent_` cho tài nguyên Sending được chủ sở hữu phê duyệt khi chạy cục bộ

MCP qua máy chủ là lựa chọn mặc định khi ứng dụng khách của bạn hỗ trợ MCP từ xa với OAuth qua trình duyệt. Cách này giữ Sendmux trong luồng cấp quyền, tránh phân phối khóa API thủ công cho tác nhân và chỉ hiển thị các công cụ được quyền cấp phép cho phép.

[!NOTE]

Gói PyPI: sendmux-mcp

Phiên bản PyPI: 2.1.3

Gói npm: sendmux-mcp

Phiên bản npm: 1.0.0

Phiên bản siêu dữ liệu registry: 2.1.4

Tài nguyên máy chủ: https://mcp.sendmux.ai/mcp

Giao thức truyền tải qua máy chủ: Streamable HTTP

Số lượng công cụ được tuyển chọn: 54

Phiên bản giao thức được chứng nhận: 2025-11-25, 2026-07-28

Phiên bản giao thức được runtime chấp nhận: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. Runtime chấp nhận để đảm bảo khả năng tương thích; điều đó không có nghĩa là từng phiên bản đều được chứng nhận.

Cài đặt	Giá trị
URL máy chủ	`https://mcp.sendmux.ai/mcp`
Máy chủ cấp quyền	`https://app.sendmux.ai`
Kiểm tra tình trạng	`https://mcp.sendmux.ai/health`

Dùng bộ sưu tập Postman khi bạn muốn kiểm thử các yêu cầu MCP từ Postman:

Khi bạn kết nối, Sendmux sẽ yêu cầu bạn chọn một nhóm, các bề mặt sản phẩm và quyền truy cập hộp thư nếu có. Mã thông báo truy cập có thời hạn ngắn. Mã thông báo làm mới được luân chuyển mỗi lần sử dụng và có thể có hiệu lực tối đa 30 ngày, trừ khi kết nối bị ngắt hoặc hết hạn.

[!NOTE]

Nếu bạn cấp quyền cho nhiều hộp thư, hãy bắt đầu quy trình làm việc với hộp thư bằng mailbox_list_granted_mailboxes và truyền mailbox_id được trả về cho các công cụ thao tác trên một hộp thư.

Chế độ kết nối

[card] OAuth qua máy chủ

Dùng khi ứng dụng khách của bạn có thể mở luồng OAuth MCP qua trình duyệt.

[card] stdio cục bộ

Dùng khi tác nhân lập trình của bạn có thể chạy một lệnh cục bộ trên máy.

[card] HTTP riêng tư

Dùng khi ứng dụng khách cần một URL nhưng bạn tự chạy gói MCP.

Cầu nối npm

Yêu cầu Node.js 22 trở lên. Chạy cầu nối npm:

npx -y sendmux-mcp

Cầu nối kết nối các ứng dụng khách stdio với máy chủ qua máy chủ bằng OAuth qua trình duyệt. Các công cụ tuân theo quyền cấp qua máy chủ của bạn.

{
  "mcpServers": {
    "sendmux": {
      "command": "npx",
      "args": ["-y", "sendmux-mcp"]
    }
  }
}

Gói cục bộ

Cài đặt gói cục bộ từ PyPI:

pip install sendmux-mcp

Chạy một bề mặt:

SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending

Chạy tất cả các bề mặt sản phẩm:

SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY=smx_mbx_... \
SENDMUX_MANAGEMENT_API_KEY=smx_root_... \
SENDMUX_SENDING_API_KEY=smx_mbx_... \
sendmux-mcp

Máy chủ xác thực tiền tố khóa trước khi khởi động. Management yêu cầu smx_root_. Sending chấp nhận khóa smx_mbx_ có khả năng gửi hoặc mã thông báo smx_agent_ cho tài nguyên Sending được chủ sở hữu phê duyệt. Mailbox chấp nhận khóa smx_mbx_ hoặc mã thông báo smx_agent_ có phạm vi giới hạn.

HTTP riêng tư

Chế độ HTTP hữu ích khi ứng dụng khách MCP kết nối với URL máy chủ nhưng bạn vẫn muốn tự chạy gói.

SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765

Điểm cuối mặc định là /mcp. /health trả về các bề mặt đã chọn. Chế độ HTTP yêu cầu SENDMUX_MCP_HTTP_BEARER_TOKEN, trừ khi bạn khởi động chế độ này bằng --allow-unauthenticated-http.

Tham khảo cấu hình

[accordion] Biến môi trường

Cài đặt Môi trường Mặc định
Bề mặt công cụ SENDMUX_MCP_SURFACES Bắt buộc đối với sendmux-mcp
Khóa API dự phòng SENDMUX_API_KEY Không có
Khóa API Mailbox SENDMUX_MAILBOX_API_KEY Không có
Khóa API Management SENDMUX_MANAGEMENT_API_KEY Không có
Khóa API Sending SENDMUX_SENDING_API_KEY Không có
URL cơ sở API Management và Mailbox SENDMUX_APP_BASE_URL https://app.sendmux.ai/api/v1
URL cơ sở API Sending SENDMUX_SENDING_BASE_URL https://smtp.sendmux.ai/api/v1
Ngân sách thời gian thử lại, tính bằng giây SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS Chưa đặt
Giao thức truyền tải SENDMUX_MCP_TRANSPORT stdio
Máy chủ HTTP SENDMUX_MCP_HOST 127.0.0.1
Cổng HTTP SENDMUX_MCP_PORT 8765
Đường dẫn HTTP SENDMUX_MCP_PATH /mcp
Mã thông báo bearer HTTP SENDMUX_MCP_HTTP_BEARER_TOKEN Bắt buộc đối với HTTP
Nguồn gốc trình duyệt được phép SENDMUX_MCP_ALLOWED_ORIGINS Không có nguồn gốc trình duyệt

Cài đặt	Môi trường	Mặc định
Bề mặt công cụ	`SENDMUX_MCP_SURFACES`	Bắt buộc đối với `sendmux-mcp`
Khóa API dự phòng	`SENDMUX_API_KEY`	Không có
Khóa API Mailbox	`SENDMUX_MAILBOX_API_KEY`	Không có
Khóa API Management	`SENDMUX_MANAGEMENT_API_KEY`	Không có
Khóa API Sending	`SENDMUX_SENDING_API_KEY`	Không có
URL cơ sở API Management và Mailbox	`SENDMUX_APP_BASE_URL`	`https://app.sendmux.ai/api/v1`
URL cơ sở API Sending	`SENDMUX_SENDING_BASE_URL`	`https://smtp.sendmux.ai/api/v1`
Ngân sách thời gian thử lại, tính bằng giây	`SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS`	Chưa đặt
Giao thức truyền tải	`SENDMUX_MCP_TRANSPORT`	`stdio`
Máy chủ HTTP	`SENDMUX_MCP_HOST`	`127.0.0.1`
Cổng HTTP	`SENDMUX_MCP_PORT`	`8765`
Đường dẫn HTTP	`SENDMUX_MCP_PATH`	`/mcp`
Mã thông báo bearer HTTP	`SENDMUX_MCP_HTTP_BEARER_TOKEN`	Bắt buộc đối với HTTP
Nguồn gốc trình duyệt được phép	`SENDMUX_MCP_ALLOWED_ORIGINS`	Không có nguồn gốc trình duyệt

[accordion] Đầu vào môi trường được bảo vệ

SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY="$SENDMUX_MAILBOX_KEY" \
SENDMUX_MANAGEMENT_API_KEY="$SENDMUX_ROOT_KEY" \
SENDMUX_SENDING_API_KEY="$SENDMUX_SENDING_KEY" \
sendmux-mcp

Khám phá công cụ

[accordion] Cách hoạt động của tính năng khám phá công cụ

Tên công cụ được tạo từ các bề mặt API công khai hiện tại. Mở bộ chọn công cụ của ứng dụng khách MCP sau khi cấp quyền để xem các công cụ có sẵn cho kết nối đó.

Kết nối qua máy chủ chỉ hiển thị các công cụ được phép theo bề mặt sản phẩm, quyền và quyền cấp cho hộp thư đã chọn. Máy chủ cục bộ hiển thị các công cụ tương ứng với bề mặt và khóa bạn cung cấp khi khởi động.

Khắc phục sự cố

[accordion] Không có công cụ nào xuất hiện

Xác nhận các bề mặt sản phẩm và quyền đã cấp. Kết nối qua máy chủ chỉ hiển thị các công cụ được quyền cấp phép cho phép.

[accordion] Máy chủ cục bộ không khởi động được

Kiểm tra tiền tố khóa API. Management cần smx_root_; Sending chấp nhận smx_mbx_ hoặc smx_agent_ cho tài nguyên Sending được chủ sở hữu phê duyệt; Mailbox chấp nhận smx_mbx_ hoặc smx_agent_ có phạm vi giới hạn.

[accordion] Máy chủ HTTP trả về 401

Gửi Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN> đến HTTP riêng tư hoặc hoàn tất OAuth cho MCP qua máy chủ.

[accordion] Máy chủ HTTP trả về 403 origin_forbidden

Thêm nguồn gốc của ứng dụng khách trình duyệt vào SENDMUX_MCP_ALLOWED_ORIGINS cho HTTP riêng tư.

[accordion] Quá nhiều công cụ trong một ứng dụng khách

Chỉ kết nối các bề mặt bạn cần hoặc tắt các công cụ không dùng trong ứng dụng khách.

Bước tiếp theo

[card] A2A

Dùng Sendmux thông qua điểm cuối tác nhân A2A 1.0 với OAuth qua máy chủ.

[card] Ứng dụng khách MCP

Cấu hình Sendmux MCP trong Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed và nhiều ứng dụng khác.

[card] SDK

Dùng các ứng dụng khách được quản lý bằng gói từ mã ứng dụng.

[card] CLI

Cài đặt CLI bằng Snap, Homebrew hoặc npm khi bạn cần truy cập qua terminal.

[card] Khóa API

Tạo thông tin xác thực có phạm vi giới hạn cho các thiết lập MCP cục bộ.

Tài liệu này được xây dựng và lưu trữ trên Mintlify, một nền tảng tài liệu dành cho nhà phát triển.