TaskPilots Mailbox Integration Documentation main concepts/capability-matrix.md

title: Mailbox 外部能力矩阵

Mailbox 外部能力矩阵

这页帮助你判断不同接入方式分别能做什么。

能力对照

能力 HTTP API SMTP Submission 587 MCP SignalR
创建邮箱 支持 不支持 不支持 不支持
查询可见邮箱 支持 不支持 支持 不支持
拉取消息列表 支持 不支持 支持 不支持
读取单封消息 支持 不支持 支持 不支持
读取线程 支持 不支持 间接支持 不支持
发起新邮件 支持 支持 支持 不支持
回复邮件 支持 客户端自行组织 MIME 支持 不支持
上传附件 支持 客户端自行发送 MIME 附件 不支持 不支持
Token 自助治理 支持 不支持 不支持 不支持
实时新邮件提示 不直接提供 不支持 不支持 支持

推荐选择

优先选 HTTP API

适合:

  • 需要系统级收发
  • 需要线程上下文
  • 需要附件上传
  • 需要 token 自助治理

优先选 SMTP Submission

适合:

  • 只需要标准 SMTP 发信
  • 已有 SMTP 客户端或库
  • 不需要平台提供收信接口

优先选 MCP

适合:

  • Agent / LLM 直接调用工具
  • 希望用远程 MCP 客户端而不是自己封装 HTTP

配合 SignalR

适合:

  • 需要尽快知道有新邮件
  • 减少固定间隔轮询

注意:

  • SignalR 只负责事件提示
  • 连接可以通过 mailboxAddress 参数绑定到单个邮箱
  • 收到事件后仍要回到 HTTP API 拉取详情

明确不提供

  • IMAP
  • POP3
  • Webhook 推送
  • 传统邮箱协议套件的完整替代