用途：Lumail 插件通过 https://lumail.io/mcp 的 OAuth MCP 连接，把 Claude Code 和 Codex 接入一个 Lumail 组织。无需创建、粘贴或保存 API 令牌，由宿主完成浏览器 OAuth 流程，用户选择组织，访问令牌保存在宿主的凭据存储中。
首次调用前：确认服务器已连接并完成认证。Claude Code 运行 claude mcp get plugin:lumail:lumail；Codex 运行 codex mcp list。预期状态为 connected，URL 为 https://lumail.io/mcp。若状态为 needs authentication，运行 claude mcp login plugin:lumail:lumail 或 codex mcp login lumail，并告知用户会打开浏览器窗口。不要向用户索要 API 令牌。
能力范围：连接仅限用户在授权时选定的单个组织及其成员身份，只有 owner 和 admin 可授权。读取（lumail.read）包括 list_subscribers、get_subscriber、list_tags、list_campaigns、get_campaign、render_campaign、get_campaign_analytics、get_campaign_progress、list_workflows、get_workflow、list_workflow_groups、get_workflow_group、get_org_stats、get_subscriber_stats、get_subscriber_growth、get_email_senders、get_custom_fields、get_email_snippets、get_writing_style、get_available_variables、get_skill。写入（lumail.write）包括 add_subscriber、get_or_create_tags、bulk_add_tags、bulk_remove_tags、create_campaign、edit_campaign、duplicate_campaign、auto_fit_campaign_images、create_workflow、configure_workflow_draft、update_workflow_draft、create_workflow_group、update_workflow_group、set_workflow_group。
不可用操作：发送活动、安排发送、发布或激活工作流、取消订阅某人以及所有删除操作，均不在此 OAuth 端点注册，并非权限受限。用户需要时应指向 Lumail 应用或 API 令牌 MCP 端点。
工作规则：先读后写，创建或编辑前先调用对应的 list_* 或 get_*。活动以草稿开始，create_campaign 与 edit_campaign 只产生草稿，不可暗示已发送。工作流按单一图配置：先 get_skill（type 为 workflow），再用 get_workflow 读取当前状态，然后调用 configure_workflow_draft 并传入读取到的精确 updatedAt，过期值会被拒绝。标签需解析而非臆造，get_or_create_tags 返回 bulk_add_tags 与 bulk_remove_tags 所需的 id。批量标签操作立即生效，执行前用 list_subscribers 确认目标集合并向用户复述数量。
速率限制：每组织每分钟 Free 100、Premium 700、Business 2000；429 会带 Retry-After，应等待而非立即重试。
错误：401 带 WWW-Authenticate 表示令牌过期或被撤销，需重新运行宿主登录命令；提示仅 owner 和 admin 可授权时，需重新授权并选择自己是 owner 或 admin 的组织；Tool not found 可能是该端点有意省略的发送/删除工具，或受组织套餐限制，先检查 list_* 可用性。
替代方式：lumail 技能覆盖 npx lumail，可访问包括发送在内的完整 API，使用 npx lumail auth login 单独认证（同样的浏览器 OAuth，lumail.cli 作用域）。仅在用户明确要求此 MCP 连接未暴露的操作且主动提出时使用。