TaskPilots Mailbox Integration Documentation main mcp/overview.md

title: Mailbox MCP 集成

Mailbox MCP 集成

MCP 适合 Agent / LLM / MCP 客户端以工具方式接入 Mailbox。

地址

  • MCP Endpoint：https://mailbox.feinian.net/mcp
  • 人类文档：https://mailbox.feinian.net/docs/mcp
  • Manifest：https://mailbox.feinian.net/docs/mcp/server.json

前置条件

  1. 已信任根证书
  2. 已准备 mailbox token 或 domain token

根证书下载地址：

认证方式

使用：

  • Authorization: Bearer <token>

工具列表

  • list_mailboxes
  • list_messages
  • get_message
  • send_mail
  • reply_message
  • delete_message

与 HTTP API 的差异

MCP 更适合

  • 远程工具调用
  • 消息列表 cursor 分页
  • 模型直接执行 mailbox 工具

HTTP API 更适合

  • 附件上传
  • token 自助治理
  • 明确的 REST 风格系统集成

重要限制

  • 当前不通过 MCP 提供附件上传
  • 当前不通过 MCP 提供 token 自助治理
  • domain token 读信或发信时通常必须显式提供 mailboxAddress

最小配置示例

{
  "servers": {
    "mailbox": {
      "type": "remote",
      "url": "https://mailbox.feinian.net/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

分页规则

list_messages 使用 cursor 分页：

  • limit 默认 50
  • limit 最大 200
  • cursor 使用上一次返回的 nextCursor
  • direction 可选 Inbound 或 Outbound

下一步