Sendmux Email MCP
ทางการSendmux คือ API อินบ็อกซ์อีเมลและ API อีเมลสำหรับเอเจนต์ AI
คุณทำอะไรได้บ้างด้วย Sendmux Email MCP?
- ค้นหาเอกสาร Sendmux — ขอให้ผู้ช่วย AI ค้นหาคู่มือและเอกสารอ้างอิง API ของ Sendmux ผ่าน
search_sendmux - ทำงานกับกล่องจดหมายที่ได้รับสิทธิ์ — ค้นหา อ่าน จัดระเบียบ และส่งอีเมลจากกล่องจดหมายที่คุณให้สิทธิ์ โดยเริ่มจาก
mailbox_list_granted_mailboxesเมื่อได้รับสิทธิ์หลายกล่อง - จัดการทรัพยากรของทีม — จัดการโดเมน กล่องจดหมาย บัญชีส่งอีเมล บันทึก เมตริก การเรียกเก็บเงิน และเว็บฮุกด้วยสิทธิ์ Management
- ส่งอีเมลเดี่ยวหรือเป็นชุด — ส่งข้อความเดียวหรือส่งเป็นชุดผ่านส่วน Sending โดยใช้คีย์ที่ส่งอีเมลได้หรือโทเค็นเอเจนต์ที่ได้รับอนุมัติ
- เลือกการตั้งค่าแบบโฮสต์หรือในเครื่อง — เชื่อมต่อผ่าน OAuth แบบโฮสต์ที่
https://mcp.sendmux.ai/mcpหรือเรียกใช้แพ็กเกจsendmux-mcpในเครื่องด้วยคีย์เฉพาะแต่ละส่วน
เอกสาร
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 ในเครื่อง |
[!NOTE]
MCP มีชุดเครื่องมือสำหรับเอเจนต์ที่คัดสรรไว้ ไม่ใช่ทุก endpoint ของ API ใช้ SDK, CLI หรือเอกสารอ้างอิง API เมื่อต้องการครอบคลุม endpoint ทั้งหมด
Doc Search MCP
Doc Search MCP เปิดให้ใช้ search_sendmux
[accordion] Claude Code
claude mcp add sendmux-docs --transport http https://sendmux.ai/docs/mcp
[accordion] Cursor
เพิ่มเซิร์ฟเวอร์นี้ใน
.cursor/mcp.jsonสำหรับโปรเจกต์เดียว หรือใน~/.cursor/mcp.jsonสำหรับทุกโปรเจกต์{ "mcpServers": { "sendmux-docs": { "url": "https://sendmux.ai/docs/mcp" } } }
[accordion] VS Code
เพิ่มเซิร์ฟเวอร์นี้ใน
mcp.jsonของผู้ใช้หรือเวิร์กสเปซ{ "servers": { "sendmux-docs": { "type": "http", "url": "https://sendmux.ai/docs/mcp" } } }
[accordion] Codex
เพิ่มเซิร์ฟเวอร์นี้ใน
~/.codex/config.tomlหรือใน.codex/config.tomlของโปรเจกต์ที่เชื่อถือได้[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_ หรือโทเค็น smx_agent_ สำหรับทรัพยากร Sending ที่เจ้าของอนุมัติเมื่อใช้งานในเครื่อง |
MCP แบบโฮสต์เป็นค่าเริ่มต้นเมื่อไคลเอ็นต์ของคุณรองรับ MCP ระยะไกลที่ใช้ browser OAuth โดยให้ Sendmux อยู่ในขั้นตอนการอนุญาต หลีกเลี่ยงการแจกจ่ายคีย์ API ด้วยตนเองให้เอเจนต์ และแสดงเฉพาะเครื่องมือที่ได้รับอนุญาตจากสิทธิ์ที่ให้ไว้
[!NOTE]
แพ็กเกจ PyPI:
sendmux-mcpเวอร์ชัน PyPI:
2.1.3แพ็กเกจ npm:
sendmux-mcpเวอร์ชัน npm:
1.0.0เวอร์ชันข้อมูลเมตาของรีจิสทรี:
2.1.4ทรัพยากรแบบโฮสต์:
https://mcp.sendmux.ai/mcpทรานสปอร์ตแบบโฮสต์: Streamable HTTP
จำนวนเครื่องมือที่คัดสรรไว้: 54
เวอร์ชันโปรโตคอลที่รับรอง:
2025-11-25,2026-07-28เวอร์ชันโปรโตคอลที่รันไทม์ยอมรับ:
2024-11-05,2025-03-26,2025-06-18,2025-11-25,2026-07-28การยอมรับในรันไทม์ช่วยให้ใช้งานร่วมกันได้ แต่ไม่ได้รับรองแต่ละเวอร์ชัน
| การตั้งค่า | ค่า |
|---|---|
| URL เซิร์ฟเวอร์ | https://mcp.sendmux.ai/mcp |
| เซิร์ฟเวอร์การอนุญาต | https://app.sendmux.ai |
| การตรวจสอบสถานะ | https://mcp.sendmux.ai/health |
ใช้คอลเลกชัน Postman เมื่อต้องการทดสอบคำขอ MCP จาก Postman:
เมื่อเชื่อมต่อ Sendmux จะขอให้คุณเลือกทีม ส่วนต่าง ๆ ของผลิตภัณฑ์ และสิทธิ์เข้าถึงกล่องจดหมายตามความเหมาะสม โทเค็นการเข้าถึงมีอายุสั้น โทเค็นรีเฟรชจะหมุนเวียนเมื่อใช้งาน และมีอายุได้สูงสุด 30 วัน เว้นแต่จะยกเลิกการเชื่อมต่อหรือหมดอายุ
[!NOTE]
หากให้สิทธิ์เข้าถึงกล่องจดหมายมากกว่าหนึ่งกล่อง ให้เริ่มเวิร์กโฟลว์ของกล่องจดหมายด้วย
mailbox_list_granted_mailboxesแล้วส่งmailbox_idที่ได้รับกลับมาให้เครื่องมือ ที่ทำงานกับกล่องจดหมายเดียว
โหมดการเชื่อมต่อ
[card] Hosted OAuth
ใช้เมื่อไคลเอ็นต์ของคุณเปิดโฟลว์ MCP OAuth ผ่านเบราว์เซอร์ได้
[card] Local stdio
ใช้เมื่อเอเจนต์เขียนโค้ดของคุณเรียกใช้คำสั่งในเครื่องบนคอมพิวเตอร์ของคุณได้
[card] Private HTTP
ใช้เมื่อไคลเอ็นต์ต้องการ URL แต่คุณเรียกใช้แพ็กเกจ MCP เอง
npm bridge
ต้องใช้ Node.js 22 ขึ้นไป เรียกใช้ npm bridge:
npx -y sendmux-mcp
bridge เชื่อมต่อไคลเอ็นต์ stdio กับเซิร์ฟเวอร์แบบโฮสต์ผ่าน browser OAuth เครื่องมือจะเป็นไปตามสิทธิ์ที่ให้ไว้กับบริการแบบโฮสต์
{
"mcpServers": {
"sendmux": {
"command": "npx",
"args": ["-y", "sendmux-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_ ที่ส่งอีเมลได้ หรือโทเค็น smx_agent_ สำหรับทรัพยากร Sending ที่เจ้าของอนุมัติ Mailbox รองรับคีย์ smx_mbx_ หรือโทเค็น smx_agent_ ที่กำหนดขอบเขตไว้
Private 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
ค่าเริ่มต้นของ endpoint คือ /mcp /health แสดงส่วนที่เลือกไว้ โหมด HTTP ต้องใช้ SENDMUX_MCP_HTTP_BEARER_TOKEN เว้นแต่คุณจะเริ่มใช้งานด้วย --allow-unauthenticated-http อย่างชัดเจน
ข้อมูลอ้างอิงการกำหนดค่า
[accordion] ตัวแปรสภาพแวดล้อม
การตั้งค่า สภาพแวดล้อม ค่าเริ่มต้น ส่วนของเครื่องมือ 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 ฐาน API ของ Management และ Mailbox SENDMUX_APP_BASE_URLhttps://app.sendmux.ai/api/v1URL ฐาน API ของ Sending SENDMUX_SENDING_BASE_URLhttps://smtp.sendmux.ai/api/v1งบเวลาสำหรับการลองใหม่ หน่วยเป็นวินาที SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDSไม่ได้ตั้งค่า ทรานสปอร์ต SENDMUX_MCP_TRANSPORTstdioโฮสต์ HTTP SENDMUX_MCP_HOST127.0.0.1พอร์ต HTTP SENDMUX_MCP_PORT8765พาธ HTTP SENDMUX_MCP_PATH/mcpโทเค็น bearer ของ HTTP SENDMUX_MCP_HTTP_BEARER_TOKENจำเป็นสำหรับ HTTP ต้นทางของเบราว์เซอร์ที่อนุญาต SENDMUX_MCP_ALLOWED_ORIGINSไม่มีต้นทางของเบราว์เซอร์
[accordion] การป้อนข้อมูลสภาพแวดล้อมที่มีการป้องกัน
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
การค้นหาเครื่องมือ
[accordion] การค้นหาเครื่องมือทำงานอย่างไร
ชื่อเครื่องมือสร้างขึ้นจากส่วนต่าง ๆ ของ API สาธารณะในปัจจุบัน เปิดตัวเลือกเครื่องมือของไคลเอ็นต์ MCP หลังจากอนุญาตแล้ว เพื่อดูเครื่องมือที่การเชื่อมต่อนั้นใช้ได้
การเชื่อมต่อแบบโฮสต์จะแสดงเฉพาะเครื่องมือที่ได้รับอนุญาตจากส่วนของผลิตภัณฑ์ สิทธิ์ และสิทธิ์เข้าถึงกล่องจดหมายที่เลือก เซิร์ฟเวอร์ในเครื่องจะแสดงเครื่องมือสำหรับส่วนต่าง ๆ และคีย์ที่คุณระบุเมื่อเริ่มต้น
การแก้ไขปัญหา
[accordion] ไม่มีเครื่องมือปรากฏ
ตรวจสอบส่วนของผลิตภัณฑ์และสิทธิ์ที่ให้ไว้ การเชื่อมต่อแบบโฮสต์จะแสดงเฉพาะเครื่องมือที่ได้รับอนุญาตจากสิทธิ์ที่ให้ไว้
[accordion] เซิร์ฟเวอร์ในเครื่องเริ่มทำงานไม่สำเร็จ
ตรวจสอบคำนำหน้าของคีย์ API Management ต้องใช้
smx_root_; Sending รองรับsmx_mbx_หรือsmx_agent_สำหรับทรัพยากร Sending ที่เจ้าของอนุมัติ; Mailbox รองรับsmx_mbx_หรือsmx_agent_ที่กำหนดขอบเขตไว้
[accordion] เซิร์ฟเวอร์ HTTP ตอบกลับ 401
ส่ง
Authorization: Bearer <SENDMUX_MCP_HTTP_BEARER_TOKEN>ไปยัง private HTTP หรือดำเนินการ OAuth ให้เสร็จสิ้นสำหรับ MCP แบบโฮสต์
[accordion] เซิร์ฟเวอร์ HTTP ตอบกลับ 403 origin_forbidden
เพิ่มต้นทางของไคลเอ็นต์เบราว์เซอร์ใน
SENDMUX_MCP_ALLOWED_ORIGINSสำหรับ private HTTP
[accordion] มีเครื่องมือมากเกินไปในไคลเอ็นต์เดียว
เชื่อมต่อเฉพาะส่วนที่จำเป็น หรือปิดใช้เครื่องมือที่ไม่ต้องการในไคลเอ็นต์
ขั้นตอนถัดไป
[card] A2A
ใช้ Sendmux ผ่าน endpoint เอเจนต์ A2A 1.0 ที่มี hosted OAuth
[card] MCP clients
กำหนดค่า Sendmux MCP ใน Claude Code, Cursor, Codex, Gemini CLI, Qwen Code, Zed และอื่น ๆ
[card] SDKs
ใช้ไคลเอ็นต์ที่จัดการแพ็กเกจจากโค้ดแอปพลิเคชัน
[card] CLI
ติดตั้ง CLI ด้วย Snap, Homebrew หรือ npm เมื่อต้องการใช้งานผ่านเทอร์มินัล
[card] API keys
สร้างข้อมูลรับรองที่กำหนดขอบเขตไว้สำหรับการตั้งค่า MCP ในเครื่อง
เอกสารนี้สร้างและโฮสต์บน Mintlify ซึ่งเป็นแพลตฟอร์มเอกสารสำหรับนักพัฒนา