邮箱和文件夹管理
根据文件夹、搜索、状态和扫描状态筛选条件列出并获取邮件项目;将项目标记为已读或未读;在文件夹之间移动;归档或恢复;以及创建、更新或删除文件夹。
无状态 Streamable HTTP MCP 服务器,让兼容的 AI 编程代理通过 USGM API 管理 US Global Mail 邮箱,包括邮件整理、扫描请求、地址与银行账户管理、货件查看和账户查询。
US Global Mail MCP Server 是一个远程、无状态的 Streamable HTTP MCP 服务器,可让兼容的 AI 编程代理管理 US Global Mail 邮箱。它通过 USGM API 网关提供 MCP 接口,使代理能够处理邮件、扫描、文件夹、地址、银行账户、货件和账户信息。
服务器使用与直接调用 USGM REST API 相同的 bearer API 密钥。MCP 客户端连接到 https://mcp.usglobalmail.com/mcp,网关则继续执行身份验证、速率限制和审计行为。支持生产密钥和沙盒密钥,因此可以先针对沙盒进行开发,再使用真实邮箱数据。
可用工具涵盖读取和账户管理工作流。列表工具使用游标分页,破坏性操作会明确标注。API 密钥应按密码进行处理,并建议为每个代理使用专用密钥。
根据文件夹、搜索、状态和扫描状态筛选条件列出并获取邮件项目;将项目标记为已读或未读;在文件夹之间移动;归档或恢复;以及创建、更新或删除文件夹。
列出并查看扫描或开封扫描请求,为邮件项目请求扫描,取消待处理请求,删除扫描请求,并获取已完成扫描的短期签名下载 URL。扫描请求会产生费用。
列出、获取、创建、更新、设置默认项以及删除配送地址或存款地址。代理还可以管理用于支票存款的银行账户;获取的账户号码仅显示后四位。
以只读模式查看货件请求,并获取账户资料、虚拟邮寄地址、邮箱地址或按类别获取默认地址。
通过 Claude Code、Cursor、VS Code、Windsurf、Cline 和其他 MCP 客户端中的通用远程 HTTP 配置进行连接,可使用生产环境实时密钥或沙盒测试密钥。
列表响应包含 `data`、`next_cursor` 和 `total_count`,允许代理请求更多页面。只读工具和破坏性工具带有注释,有助于区分安全查询和需要确认的操作。
连接 MCP 客户端,使代理能够搜索收到的邮件、查看单个项目、将其标记为已读、移入文件夹,并在引导式邮箱整理工作流中归档邮件。
使用代理识别邮件项目,请求开封扫描操作,监控扫描请求,并在扫描完成后获取临时下载 URL。
管理配送地址和存款地址,或更新用于支票存款的银行账户记录,无需为每种资源分别构建直接 REST 集成。
当工作流需要当前的 US Global Mail 账户信息时,让代理查看货件请求并获取账户资料或虚拟邮寄地址。
使用远程端点 `https://mcp.usglobalmail.com/mcp` 配置 MCP 客户端,并在 `Authorization` 标头中将 USGM API 密钥作为 bearer 令牌发送。Claude Code 还支持使用其 `claude mcp add --transport http` 命令添加服务器。
文档提供了 Claude Code、Cursor 和 VS Code 的配置,并说明使用带 URL 和授权标头的远程 HTTP 服务器的 Windsurf、Cline 及其他 MCP 客户端遵循相同的配置结构。
可以。将 `usgmk_test_…` 密钥与 USGM 沙盒配合使用。沙盒被描述为 API 的完整副本,不会接触真实邮件;生产环境使用 `usgmk_live_…` 密钥和实时端点。
丢弃邮件属于破坏性操作,删除文件夹、扫描请求、地址或银行账户也会标记为破坏性操作。服务器会为破坏性工具添加注释,以便代理请求确认。API 密钥应按密码处理,如有泄露应进行轮换。
流量数据仅供参考。