Sendmux Email MCP
ทางการSendmux คือ API อินบ็อกซ์อีเมลและ API อีเมลสำหรับเอเจนต์ AI
คุณทำอะไรได้บ้างด้วย Sendmux Email MCP?
- ค้นหาเอกสาร Sendmux — ให้ AI ของคุณค้นหาแนวทางหรือข้อมูลอ้างอิง API โดยใช้
search_sendmuxจาก Doc Search MCP - จัดการกล่องจดหมาย — แสดงรายการกล่องจดหมายที่ได้รับอนุญาตด้วย
mailbox_list_granted_mailboxesจากนั้นค้นหา อ่าน หรือจัดระเบียบอีเมลในกล่องจดหมายที่ระบุ - ส่งอีเมลธุรกรรม — ส่งอีเมลเดี่ยวหรือแบบกลุ่มผ่านพื้นผิวการส่งหลังจากอนุมัติการเชื่อมต่อที่สามารถส่งได้
- จัดการทรัพยากรทีม — จัดการโดเมน กล่องจดหมาย บัญชีส่งอีเมล บันทึก ตัวชี้วัด การเรียกเก็บเงิน และเว็บฮุคผ่านพื้นผิวการจัดการ
- รันเซิร์ฟเวอร์ MCP ในเครื่อง — เริ่มแพ็กเกจ
sendmux-mcpในเครื่องด้วยคีย์ API เฉพาะพื้นผิวสำหรับเครื่องมือกล่องจดหมาย การจัดการ หรือการส่ง
เอกสาร
MCP
เชื่อมต่อเครื่องมือ AI เข้ากับเอกสารและเครื่องมือผลิตภัณฑ์ของ Sendmux
Sendmux มีการเชื่อมต่อ MCP สองแบบ ใช้ Doc Search MCP เมื่อคุณต้องการให้เครื่องมือ AI ค้นหาเอกสารของ Sendmux ใช้ MCP เมื่อคุณต้องการให้เอเจนต์ทำงานกับเครื่องมือ Sendmux ที่คุณอนุญาต
| การเชื่อมต่อ | ใช้สำหรับ | เซิร์ฟเวอร์ |
|---|---|---|
| Doc Search MCP | ค้นหาคู่มือและเอกสารอ้างอิง API ของ Sendmux | https://sendmux.ai/docs/mcp |
| MCP | ใช้เครื่องมือการจัดการ, กล่องจดหมาย และการส่ง | 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 เปิดเผยพื้นผิวผลิตภัณฑ์ที่คุณอนุญาต
| พื้นผิว | ใช้สำหรับ | การเข้าถึง |
|---|---|---|
| กล่องจดหมาย | ค้นหา, อ่าน, จัดระเบียบ และส่งจากกล่องจดหมายที่ได้รับอนุญาต | การอนุญาตแบบโฮสต์ที่มีสิทธิ์เข้าถึงกล่องจดหมาย, คีย์ smx_mbx_ หรือโทเค็น smx_agent_ แบบจำกัดขอบเขตภายในเครื่อง |
| การจัดการ | จัดการทรัพยากรทีม เช่น โดเมน, กล่องจดหมาย, บัญชีผู้ส่ง, บันทึก, เมตริก, การเรียกเก็บเงิน และเว็บฮุค | การอนุญาตแบบโฮสต์ที่มีสิทธิ์เข้าถึงการจัดการ หรือคีย์ smx_root_ ภายในเครื่อง |
| การส่ง | ส่งอีเมลเดี่ยวหรือแบบกลุ่ม | การอนุญาตแบบโฮสต์ที่มีสิทธิ์เข้าถึงการส่ง, คีย์ smx_mbx_ หรือโทเค็นทรัพยากรการส่ง 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` ที่ส่งคืนมาให้กับเครื่องมือ ที่ทำงานกับหนึ่งกล่องจดหมายโหมดการเชื่อมต่อ
ใช้เมื่อไคลเอนต์ของคุณสามารถเปิดขั้นตอน MCP OAuth บนเบราว์เซอร์ได้ ใช้เมื่อเอเจนต์เขียนโค้ดของคุณสามารถเรียกใช้คำสั่งภายในเครื่องบนเครื่องของคุณได้ ใช้เมื่อไคลเอนต์ต้องการ 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
เซิร์ฟเวอร์ตรวจสอบคำนำหน้าคีย์ก่อนเริ่มต้น การจัดการต้องการ smx_root_ การส่งยอมรับคีย์ smx_mbx_ ที่สามารถส่งได้ หรือโทเค็นทรัพยากรการส่ง smx_agent_ ที่เจ้าของอนุมัติ กล่องจดหมายยอมรับคีย์ 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 กล่องจดหมาย | `SENDMUX_MAILBOX_API_KEY` | ไม่มี | | คีย์ API การจัดการ | `SENDMUX_MANAGEMENT_API_KEY` | ไม่มี | | คีย์ API การส่ง | `SENDMUX_SENDING_API_KEY` | ไม่มี | | URL ฐาน API การจัดการและกล่องจดหมาย | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL ฐาน 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 ของคุณหลังจากการอนุญาตเพื่อดูเครื่องมือที่พร้อมใช้งานสำหรับการเชื่อมต่อนั้นการเชื่อมต่อแบบโฮสต์แสดงเฉพาะเครื่องมือที่ได้รับอนุญาตจากพื้นผิวผลิตภัณฑ์, สิทธิ์ และการอนุญาตกล่องจดหมายที่เลือก เซิร์ฟเวอร์ภายในเครื่องแสดงเครื่องมือสำหรับพื้นผิวและคีย์ที่คุณให้ไว้เมื่อเริ่มต้น