用途：为支持 MCP 的客户端配置或排查 AgentMail 托管服务器，推荐使用 https://mcp.agentmail.to/mcp，避免本地 Node.js 进程。
主要能力：工具目录由托管运行时动态提供，覆盖收件箱、会话、消息、草稿、附件、允许/阻止列表等邮件工作流；以及 AgentID 应用与账户工具（list_apps、search_apps、get_app、connect_app、authorize_inbox、list_accounts）。Agent 注册相关工具有 agent_attach_human 与 agent_verify。OAuth 会话可能额外提供组织选择工具。权威目录见托管运行时及 https://github.com/agentmail-to/agentmail-mcp/blob/main/mcp-manifest.json。
使用方式：Claude Code、Codex、Cursor 建议用 OAuth，不要填空 API key。配置示例：{"mcpServers":{"agentmail":{"type":"http","url":"https://mcp.agentmail.to/mcp"}}}。Claude Code 可直接安装：claude mcp add --transport http agentmail https://mcp.agentmail.to/mcp。首次连接需浏览器登录。Claude.ai、Claude Desktop、ChatGPT 以连接器方式添加并完成 OAuth，无需 API key。不支持 OAuth 的客户端可用 x-api-key 头，或 Authorization: Bearer <am_...>；apiKey 查询参数不推荐。stdio 客户端可用 npm 或 PyPI 的 agentmail-mcp 薄桥接包。验证：重启客户端后检查 MCP 状态，调用 list_inboxes 做只读冒烟测试，调用 list_apps 确认 AgentID 工具。
限制与排查：404 通常因 URL 缺少 /mcp；清单中的工具或参数缺失需新开会话或重连；401 且用 API key 多为密钥错误、撤销、权限不足或环境变量不可用；OAuth 401 多为登录未完成或会话过期。注意 Claude.ai 连接器不同步到 Claude Code。