TaskPilots Mailbox Integration Documentation main reference/public-endpoints-and-urls.md

title: Mailbox 公开地址与入口

Mailbox 公开地址与入口

这页只保留公开可用的访问地址，不混入内部运维地址。

公开地址

  • HTTP API：https://mailbox.feinian.net
  • Swagger UI：https://mailbox.feinian.net/swagger
  • OpenAPI JSON：https://mailbox.feinian.net/swagger/v1/swagger.json
  • SignalR Hub：https://mailbox.feinian.net/hubs/mailbox-events
  • MCP Endpoint：https://mailbox.feinian.net/mcp
  • MCP 文档：https://mailbox.feinian.net/docs/mcp
  • MCP Manifest：https://mailbox.feinian.net/docs/mcp/server.json
  • fallback 根证书下载：https://mailbox.feinian.net/ca.crt
  • SMTP Submission：smtp.agent-mx.taskpilots.net:587

使用规则

  • 正常情况下 HTTPS / MCP / SMTP STARTTLS 使用公网可信证书
  • Swagger 页面可公开访问，但实际 API 调用仍按现有 Bearer 鉴权和权限范围生效
  • 第三方公开集成统一使用 token-first 公开 API，不再提供 trusted-apps 兼容地址
  • 只有 fallback 自签名模式下，才需要 https://mailbox.feinian.net/ca.crt
  • SMTP Submission 的公开入口固定为 smtp.agent-mx.taskpilots.net:587

不在本页出现的内容

以下内容不属于公开接入地址：

  • 内部 relay 地址
  • router / gateway / 宿主机地址
  • /api/admin/*
  • 运维凭证