关于 Lumail
Lumail 为 Claude Code 和 Codex 提供 Agent 插件、技能及 MCP 连接,用于邮件营销任务。OAuth 可读取营销数据并创建草稿;发送及其他受限操作不通过 MCP 端点开放。
主要功能
- 01基于 OAuth 的组织访问
- 02读取订阅者和营销活动数据
- 03创建订阅者及营销活动草稿
- 04管理标签和工作流草稿
- 05营销与文案写作技能
- 06通过 Lumail CLI 访问完整 API
适用场景
- 01查看新闻邮件表现和订阅者增长
- 02起草新品发布邮件活动
- 03添加订阅者并应用标签
- 04创建欢迎邮件工作流草稿
MCP 相关
该插件通过 Lumail 的 OAuth 2.1 保护端点 https://lumail.io/mcp 连接 Claude Code 和 Codex。它提供读取和草稿管理操作;发送、定时发送、发布、激活、退订和删除操作不能通过 OAuth 使用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://lumail.io/mcpclaude mcp add --transport http melvynx-lumail https://lumail.io/mcp{"mcpServers":{"melvynx-lumail":{"type":"http","url":"https://lumail.io/mcp"}}}在 Cursor 中打开{"servers":{"melvynx-lumail":{"type":"http","url":"https://lumail.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"melvynx-lumail":{"type":"http","url":"https://lumail.io/mcp"}}}{"mcpServers":{"melvynx-lumail":{"serverUrl":"https://lumail.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Lumail Agent 技能和插件
安装 Lumail 的 Agent 技能,或将 Lumail 连接到 Claude Code 和 Codex。此仓库包含可复用的营销和文案撰写技能,以及 Lumail CLI 和 OAuth MCP 插件技能。
Agent 插件使用浏览器 OAuth 进行身份验证。这些会话没有可创建、粘贴或存储的 API 令牌。wordpress/ 中的 WordPress 插件是个例外:它在服务器上使用 lum_ 组织令牌。
安装
最快的方法是让你的 Agent 来安装。将以下内容粘贴到 Claude Code 中:
Read lumail.io/claude-code and install the Lumail plugin for me.
或粘贴到 Codex 中:
Read lumail.io/codex and set up the Lumail connection for me.
或者,如果要使用终端工作流(完整 API,包括发送),请粘贴到任意 Agent 中:
Read lumail.io/cli and set up the Lumail CLI for me.
如果你更愿意亲自运行:
claude plugin marketplace add https://github.com/Melvynx/lumail-skills.git
claude plugin install lumail@lumail
claude mcp login plugin:lumail:lumail
完整指南:docs/claude-code-install.md · docs/codex-install.md
此仓库包含什么
| 路径 | 内容 |
|---|---|
wordpress/ | WordPress 插件 — [lumail_form] → Lumail 订阅者 |
.claude-plugin/marketplace.json | Claude Code 市场描述文件 |
claude/.claude-plugin/plugin.json | Claude Code 插件,在其中声明 MCP 服务 |
codex/.codex-plugin/plugin.json | Codex 插件元数据 |
codex/.mcp.json | Codex MCP 服务配置 |
.agents/plugins/marketplace.json | Codex 市场描述文件 |
skills/lumail/ | lumail CLI 技能(npx lumail)——规范版本 |
skills/lumail-plugin/ | 如何使用 MCP 连接及其限制和错误 |
skills/marketing/ | 营销策略、定位、优惠、漏斗和发布 |
skills/copywritting/ | 用于邮件、页面、广告、脚本和 CTA 的转化文案 |
claude/skills 和 codex/skills 是 skills/ 的实际副本(符号链接在 Windows 检出时会失效),因此这两个宿主都附带相同的技能。先编辑顶层的 skills/,然后同步副本。
连接的工作方式
该插件将两个宿主都指向 https://lumail.io/mcp,这是一个受 OAuth 2.1 保护的资源。宿主通过动态客户端注册来注册自身,运行 PKCE,并自行存储访问令牌。在浏览器流程中,你需要登录、选择 Agent 可以访问的组织,并批准相应权限范围。只有组织的所有者和管理员才能授权。
访问令牌会将组织作为声明,因此会话永远无法访问你账户中的其他组织。你可以在 Lumail 设置的已连接应用列表中撤销访问权限,权限会在下一次请求时失效,无需清理本地配置。
Agent 能做什么
读取 — 订阅者、标签、营销活动、营销活动分析和进度、工作流和工作流组、组织统计数据、订阅者增长情况、发件人、自定义字段、片段、写作风格。
写入 — 添加订阅者、创建和应用标签、创建和编辑营销活动草稿、复制营销活动、创建和配置工作流草稿。
OAuth 不支持 — 发送、安排发送、发布或启用工作流、取消订阅,以及所有删除操作。这些工具未在此端点注册,因此即使你批准了请求,Agent 也无法使用它们。请在 Lumail 应用中完成这些操作;如果希望在终端中操作,也可以使用 npx lumail。
CLI
npx lumail 可以访问完整 API,包括发送。它使用相同的浏览器流程进行身份验证:
npx lumail auth login
此仓库中的 lumail 技能会教 Agent 使用整个 CLI。
WordPress 插件
wordpress/ 是一个 PHP 插件:提供用于设置 lum_ 令牌的设置页面、短代码
[lumail_form],以及服务端 POST /api/v2/subscribers。将该文件夹复制到
wp-content/plugins/lumail。详情请参阅:wordpress/README.md
和 wordpress/BUILD.md。
示例提示词
How did last week's newsletter perform compared to the one before?Draft a launch campaign with three subject line options.Add [email protected] to my newsletter and tag them vip.Build a three-email welcome sequence over a week and leave it as a draft.Show me subscriber growth over the last 30 days.
支持
采用 MIT 许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。