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 ของ Sendmuxhttps://sendmux.ai/docs/mcp
MCPใช้เครื่องมือ Management, Mailbox และ Sendinghttps://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:

Run in 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 ของ MailboxSENDMUX_MAILBOX_API_KEYไม่มี
คีย์ API ของ ManagementSENDMUX_MANAGEMENT_API_KEYไม่มี
คีย์ API ของ SendingSENDMUX_SENDING_API_KEYไม่มี
URL ฐาน API ของ Management และ MailboxSENDMUX_APP_BASE_URLhttps://app.sendmux.ai/api/v1
URL ฐาน API ของ SendingSENDMUX_SENDING_BASE_URLhttps://smtp.sendmux.ai/api/v1
งบเวลาสำหรับการลองใหม่ หน่วยเป็นวินาทีSENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDSไม่ได้ตั้งค่า
ทรานสปอร์ตSENDMUX_MCP_TRANSPORTstdio
โฮสต์ HTTPSENDMUX_MCP_HOST127.0.0.1
พอร์ต HTTPSENDMUX_MCP_PORT8765
พาธ HTTPSENDMUX_MCP_PATH/mcp
โทเค็น bearer ของ HTTPSENDMUX_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 ซึ่งเป็นแพลตฟอร์มเอกสารสำหรับนักพัฒนา