Sendmux Email MCP

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 Sendmux.

Sendmux có hai kết nối MCP. Sử dụng Doc Search MCP khi bạn muốn công cụ AI tìm kiếm tài liệu Sendmux. Sử dụng MCP khi bạn muốn một agent làm việc với các công cụ Sendmux mà bạn ủy quyền.

Kết nối	Sử dụng cho	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	Sử 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ộ

Thông tin

MCP cung cấp bộ công cụ agent được tuyển chọn, không phải mọi endpoint API. Sử dụng SDK, CLI hoặc tài liệu tham khảo API khi bạn cần phạm vi endpoint đầy đủ.

Doc Search MCP

Doc Search MCP cung cấp search_sendmux.

```bash theme={null} claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp ``` 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.

```json theme={null}
{
  "mcpServers": {
    "sendmux-docs": {
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```

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.

```json theme={null}
{
  "servers": {
    "sendmux-docs": {
      "type": "http",
      "url": "https://sendmux.ai/docs/mcp"
    }
  }
}
```

Thêm máy chủ này vào `~/.codex/config.toml` hoặc một dự án đáng tin cậy `.codex/config.toml`.

```toml theme={null}
[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	Sử dụng cho	Truy cập
Mailbox	Tìm kiếm, đọc, sắp xếp và gửi từ các hộp thư được cấp quyền.	Cấp quyền lưu trữ 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 cục bộ
Management	Quản lý tài nguyên nhóm như tên 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 lưu trữ với quyền truy cập Management hoặc khóa smx_root_ cục bộ
Sending	Gửi email đơn lẻ hoặc hàng loạt.	Cấp quyền lưu trữ với quyền truy cập Sending, khóa smx_mbx_ hoặc mã thông báo smx_agent_ tài nguyên Sending được chủ sở hữu phê duyệt cục bộ

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

Thông tin

Danh tính gói: sendmux-mcp

Phiên bản gói: 2.1.2

Tài nguyên lưu trữ: https://mcp.sendmux.ai/mcp

Giao thức truyền tải lưu trữ: 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 chấp nhận khi chạy: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. Việc chấp nhận khi chạy cung cấp khả năng tương thích; không chứng nhận từng phiên bản.

Cài đặt	Giá trị
URL máy chủ	https://mcp.sendmux.ai/mcp
Máy chủ ủy quyền	https://app.sendmux.ai
Kiểm tra sức khỏe	https://mcp.sendmux.ai/health

Sử dụng bộ sưu tập Postman khi bạn muốn kiểm tra yêu cầu MCP từ Postman:

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

Lưu ý

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

Chế độ kết nối

Sử dụng khi máy khách của bạn có thể mở luồng OAuth MCP dựa trên trình duyệt. Sử dụng khi agent lập trình của bạn có thể khởi chạy lệnh cục bộ trên máy của bạn. Sử dụng khi máy khách cần URL nhưng bạn tự chạy gói 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ả 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_ 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.

HTTP riêng tư

Chế độ HTTP hữu ích khi máy khách MCP của bạn kết nối đến 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

Endpoint 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 nó một cách tường minh với --allow-unauthenticated-http.

Tài liệu tham khảo cấu hình

| Cài đặt | Môi trường | Mặc định | | - | - | - | | Bề mặt công cụ | `SENDMUX_MCP_SURFACES` | Bắt buộc cho `sendmux-mcp` | | Dự phòng khóa API | `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 cho 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 | ```bash theme={null} 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ụ

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

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

Xử lý sự cố

Xác nhận bề mặt sản phẩm đã chọn và quyền được cấp. Kết nối lưu trữ chỉ hiển thị các công cụ được phép theo cấp quyền. Kiểm tra tiền tố khóa API. Management cần `smx_root_`; Sending chấp nhận `smx_mbx_` hoặc mã thông báo `smx_agent_` 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. Gửi `Authorization: Bearer ` đến HTTP riêng tư hoặc hoàn tất OAuth cho MCP lưu trữ. Thêm nguồn gốc của máy khách trình duyệt vào `SENDMUX_MCP_ALLOWED_ORIGINS` cho HTTP riêng tư. Chỉ kết nối các bề mặt bạn cần hoặc vô hiệu hóa các công cụ không sử dụng trong máy khách.

Các bước tiếp theo

Sử dụng Sendmux thông qua endpoint agent A2A 1.0 với OAuth lưu trữ. Cấu hình Sendmux MCP trong Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed và nhiều công cụ khác. Sử dụng máy khách được quản lý gói từ mã ứng dụng. Cài đặt CLI với Snap, Homebrew hoặc npm khi bạn cần truy cập terminal. Tạo thông tin xác thực có phạm vi cho thiết lập MCP cục bộ.