Sendmux Email MCP Server
chính thứcSendmux là API hộp thư email và API email dành cho các tác nhân AI.
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. Sử 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. Sử 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 ủ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à tham khảo API của Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Sử dụng các công cụ Quản lý, Hộp thư và Gửi. | https://mcp.sendmux.ai/mcp hoặc gói cục bộ sendmux-mcp |
Doc Search MCP
Doc Search MCP cung cấp search_sendmux.
```json theme={null}
{
"mcpServers": {
"sendmux-docs": {
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"sendmux-docs": {
"type": "http",
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```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 |
|---|---|---|
| Hộp thư | Tìm kiếm, đọc, sắp xếp và gửi từ các hộp thư được cấp. | Cấp quyền lưu trữ với quyền truy cập Hộp thư, khóa smx_mbx_, hoặc mã thông báo smx_agent_ có phạm vi cục bộ |
| Quản lý | 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ý, số liệu, thanh toán và webhook. | Cấp quyền lưu trữ với quyền truy cập Quản lý, hoặc khóa smx_root_ cục bộ |
| Gửi | 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 Gửi, khóa smx_mbx_, hoặc mã thông báo smx_agent_ tài nguyên Gửi đượ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 các tác nhân và chỉ hiển thị các công cụ được phép bởi cấp quyề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 các yêu cầu MCP từ Postman:
Khi bạn kết nối, Sendmux yêu cầu bạn chọn một nhóm, bề mặt sản phẩm và quyền truy cập hộp thư nếu có liên quan. 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.
Nếu bạn cấp nhiều hơn một hộp thư, hãy bắt đầu quy trình làm việc hộp thư với `mailbox_list_granted_mailboxes` và truyền `mailbox_id` 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 tác nhân mã hóa của bạn có thể khởi chạy một lệnh cục bộ trên máy của bạn. Sử dụng khi máy khách cần một 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. Quản lý yêu cầu smx_root_. Gửi 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 Gửi được chủ sở hữu phê duyệt. Hộp thư 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 với một 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 nó một cách rõ ràng với --allow-unauthenticated-http.
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` | | Khóa API dự phòng | `SENDMUX_API_KEY` | Không có | | Khóa API hộp thư | `SENDMUX_MAILBOX_API_KEY` | Không có | | Khóa API quản lý | `SENDMUX_MANAGEMENT_API_KEY` | Không có | | Khóa API gửi | `SENDMUX_SENDING_API_KEY` | Không có | | URL cơ sở API quản lý và hộp thư | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL cơ sở API gửi | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Phương 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 \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```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 máy khách MCP sau khi ủy quyền để xem các công cụ có sẵn cho kết nối đó.Kết nối lưu trữ chỉ hiển thị các công cụ được phép bởi các 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 các bề mặt và khóa bạn cung cấp khi khởi động.