Sendmux Email MCP Server
ทางการSendmux คือ API อินบ็อกซ์อีเมลและ API อีเมลสำหรับเอเจนต์ AI
เอกสาร
MCP
เชื่อมต่อเครื่องมือ AI เข้ากับเอกสารและเครื่องมือผลิตภัณฑ์ของ Sendmux
Sendmux มีการเชื่อมต่อ MCP สองแบบ ใช้ Doc Search MCP เมื่อคุณต้องการให้เครื่องมือ AI ค้นหาเอกสารของ Sendmux ใช้ MCP เมื่อคุณต้องการให้เอเจนต์ทำงานกับเครื่องมือ Sendmux ที่คุณอนุญาต
| การเชื่อมต่อ | ใช้สำหรับ | เซิร์ฟเวอร์ |
|---|---|---|
| Doc Search MCP | ค้นหาคู่มือและเอกสารอ้างอิง API ของ Sendmux | https://sendmux.ai/docs/mcp |
| MCP | ใช้เครื่องมือ Management, Mailbox และ Sending | https://mcp.sendmux.ai/mcp หรือแพ็กเกจ sendmux-mcp แบบโลคอล |
Doc Search MCP
Doc Search MCP เปิดเผย 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 เปิดเผยพื้นผิวผลิตภัณฑ์ที่คุณอนุญาต
| พื้นผิว | ใช้สำหรับ | การเข้าถึง |
|---|---|---|
| Mailbox | ค้นหา อ่าน จัดระเบียบ และส่งจากกล่องจดหมายที่ได้รับอนุญาต | การอนุญาตแบบโฮสต์ที่มีสิทธิ์ Mailbox, คีย์ smx_mbx_ หรือโทเค็น smx_agent_ แบบจำกัดขอบเขตในเครื่อง |
| Management | จัดการทรัพยากรทีม เช่น โดเมน กล่องจดหมาย บัญชีผู้ส่ง บันทึก เมตริก การเรียกเก็บเงิน และเว็บฮุค | การอนุญาตแบบโฮสต์ที่มีสิทธิ์ Management หรือคีย์ smx_root_ ในเครื่อง |
| Sending | ส่งอีเมลเดี่ยวหรือแบบกลุ่ม | การอนุญาตแบบโฮสต์ที่มีสิทธิ์ Sending, คีย์ smx_mbx_ หรือโทเค็นทรัพยากร Sending smx_agent_ ที่เจ้าของอนุมัติในเครื่อง |
MCP แบบโฮสต์เป็นค่าเริ่มต้นเมื่อไคลเอนต์ของคุณรองรับ MCP ระยะไกลด้วย OAuth ผ่านเบราว์เซอร์ ซึ่งจะทำให้ Sendmux อยู่ในขั้นตอนการอนุญาต หลีกเลี่ยงการแจกจ่ายคีย์ API แบบแมนนวลให้กับเอเจนต์ และแสดงเฉพาะเครื่องมือที่อนุญาตโดยการอนุญาต
| การตั้งค่า | ค่า |
|---|---|
| URL เซิร์ฟเวอร์ | https://mcp.sendmux.ai/mcp |
| เซิร์ฟเวอร์การอนุญาต | https://app.sendmux.ai |
| การตรวจสอบความสมบูรณ์ | https://mcp.sendmux.ai/health |
ใช้คอลเลกชัน Postman เมื่อคุณต้องการทดสอบคำขอ MCP จาก Postman:
เมื่อคุณเชื่อมต่อ Sendmux จะขอให้คุณเลือกทีม พื้นผิวผลิตภัณฑ์ และการเข้าถึงกล่องจดหมายตามความเหมาะสม โทเค็นการเข้าถึงมีอายุสั้น โทเค็นรีเฟรชจะหมุนเวียนเมื่อใช้งานและสามารถอยู่ได้นานสูงสุด 30 วัน เว้นแต่การเชื่อมต่อจะถูกตัดหรือหมดอายุ
หากคุณอนุญาตมากกว่าหนึ่งกล่องจดหมาย ให้เริ่มเวิร์กโฟลว์กล่องจดหมายด้วย `mailbox_list_granted_mailboxes` และส่ง `mailbox_id` ที่ส่งคืนมาให้กับเครื่องมือ ที่ทำงานกับหนึ่งกล่องจดหมายโหมดการเชื่อมต่อ
ใช้เมื่อไคลเอนต์ของคุณสามารถเปิดขั้นตอน OAuth ของ MCP ผ่านเบราว์เซอร์ได้ ใช้เมื่อเอเจนต์เขียนโค้ดของคุณสามารถเรียกใช้คำสั่งโลคอลบนเครื่องของคุณได้ ใช้เมื่อไคลเอนต์ต้องการ URL แต่คุณรันแพ็กเกจ MCP ด้วยตัวเองแพ็กเกจโลคอล
ติดตั้งแพ็กเกจโลคอลจาก PyPI:
pip install sendmux-mcp
รันหนึ่งพื้นผิว:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
รันพื้นผิวผลิตภัณฑ์ทั้งหมด:
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
เซิร์ฟเวอร์ตรวจสอบคำนำหน้าคีย์ก่อนเริ่มต้น Management ต้องการ smx_root_ Sending ยอมรับคีย์ smx_mbx_ ที่สามารถส่งได้ หรือโทเค็นทรัพยากร Sending smx_agent_ ที่เจ้าของอนุมัติ Mailbox ยอมรับคีย์ smx_mbx_ หรือโทเค็น smx_agent_ แบบจำกัดขอบเขต
HTTP ส่วนตัว
โหมด HTTP มีประโยชน์เมื่อไคลเอนต์ MCP ของคุณเชื่อมต่อกับ URL เซิร์ฟเวอร์ แต่คุณยังต้องการรันแพ็กเกจด้วยตัวเอง
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
ปลายทางค่าเริ่มต้นคือ /mcp /health ส่งคืนพื้นผิวที่เลือก โหมด HTTP ต้องการ SENDMUX_MCP_HTTP_BEARER_TOKEN เว้นแต่คุณจะเริ่มต้นอย่างชัดเจนด้วย --allow-unauthenticated-http
เอกสารอ้างอิงการกำหนดค่า
| การตั้งค่า | ตัวแปรสภาพแวดล้อม | ค่าเริ่มต้น | | ----------------------------------- | ------------------------------- | -------------------------------- | | พื้นผิวเครื่องมือ | `SENDMUX_MCP_SURFACES` | จำเป็นสำหรับ `sendmux-mcp` | | คีย์ API สำรอง | `SENDMUX_API_KEY` | ไม่มี | | คีย์ API ของ Mailbox | `SENDMUX_MAILBOX_API_KEY` | ไม่มี | | คีย์ API ของ Management | `SENDMUX_MANAGEMENT_API_KEY` | ไม่มี | | คีย์ API ของ Sending | `SENDMUX_SENDING_API_KEY` | ไม่มี | | URL ฐานของ Management และ Mailbox API | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL ฐานของ Sending API | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | การขนส่ง | `SENDMUX_MCP_TRANSPORT` | `stdio` | | โฮสต์ HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | พอร์ต HTTP | `SENDMUX_MCP_PORT` | `8765` | | พาธ HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | โทเค็นผู้ถือ HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | จำเป็นสำหรับ HTTP | | ต้นทางเบราว์เซอร์ที่อนุญาต | `SENDMUX_MCP_ALLOWED_ORIGINS` | ไม่มีต้นทางเบราว์เซอร์ | ```bash theme={null} sendmux-mcp \ --surfaces mailbox,management,sending \ --mailbox-api-key smx_mbx_... \ --management-api-key smx_root_... \ --sending-api-key smx_mbx_... ```การค้นพบเครื่องมือ
ชื่อเครื่องมือถูกสร้างจากพื้นผิว API สาธารณะปัจจุบัน เปิดตัวเลือกเครื่องมือของไคลเอนต์ MCP ของคุณหลังจากการอนุญาตเพื่อดูเครื่องมือที่พร้อมใช้งานสำหรับการเชื่อมต่อนั้นการเชื่อมต่อแบบโฮสต์แสดงเฉพาะเครื่องมือที่อนุญาตโดยพื้นผิวผลิตภัณฑ์ สิทธิ์ และการอนุญาตกล่องจดหมายที่เลือก เซิร์ฟเวอร์โลคอลแสดงเครื่องมือสำหรับพื้นผิวและคีย์ที่คุณให้ไว้เมื่อเริ่มต้น