关于 postlane
postlane 为编码 Agent 提供通过 Postlane API 发送事务性邮件及查看发送活动的插件,面向需要接入邮件流程的开发者。它包含指导 Agent 使用 API 的 skill 和提供邮件操作的 MCP 服务,并支持多种编码 Agent。
主要功能
- 01发送事务性邮件
- 02按 ID 查询邮件
- 03列出邮件发送记录
- 04提供编码 Agent 使用指南
适用场景
- 01发送欢迎邮件和密码重置邮件
- 02发送收据与通知
- 03检查邮件发送状态和活动记录
MCP 相关
MCP 服务向客户端提供 send_email、get_email 和 list_emails 工具,通过 Postlane API 操作邮件。使用需要 Postlane API 密钥;list_emails 还要求具备相应读取权限。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cc | any | 否 | 可选抄送 |
| to | any | 是 | 收件人电子邮件地址,或电子邮件地址数组 |
| bcc | any | 否 | 可选密送 |
| from | string | 是 | 已验证的发件人,例如 [email protected] |
| html | string | 否 | |
| text | string | 否 | |
| subject | string | 否 | |
| reply_to | string | 否 | |
| template | string | 否 | 已保存的模板名称,例如 Reset your password |
| variables | object | 否 | |
| idempotency_key | string | 是 | 此逻辑发送的稳定键。重试时请重复使用。 |
详细介绍
面向编码 Agent 的 Postlane
此插件会告知编码 Agent 使用 Postlane 发送交易邮件:欢迎邮件、密码重置邮件、收据和通知。它适用于 Cursor、Claude Code、Gemini CLI、Codex 和任何 MCP 客户端。
它由两部分组成:
- 一个教授如何使用
POST https://www.postlane.email/v1/emails的技能 - 一个提供
send_email、get_email和list_emails的 MCP 服务
每次安装都需要一个来自 https://www.postlane.email/app/api-keys 的 pl_live_… 密钥。如果你需要使用 list_emails,请使用具有 Read activity 或 Full access 权限的密钥。仅发送权限的密钥可以发送邮件,也可以通过 ID 读取一封邮件。from 地址必须属于已在 https://www.postlane.email/app/domains 验证的域名。
Cursor
- 从 Customize 安装插件,或将此文件夹复制到
~/.cursor/plugins/local/postlane,然后重新加载 Cursor。 - 打开 Customize,选择 Postlane,然后设置 Postlane API key。
Claude Code
claude plugin marketplace add zwebso/postlane
claude plugin install postlane@postlane
启用插件时,Claude Code 会要求输入 API 密钥,并将其保存在安全存储中。
Gemini CLI
gemini extensions install https://github.com/zwebso/postlane-plugin
安装过程中,Gemini CLI 会要求输入 API 密钥,并将其保存在系统密钥链中。
Codex 和 ChatGPT
从 Plugins 目录安装 Postlane。该目录中的条目仅包含技能。若要在 Codex 中也使用 MCP 工具,请将下一节中的服务添加到 ~/.codex/config.toml。
任何 MCP 客户端(Cline、VS Code、Windsurf、Claude Desktop)
{
"mcpServers": {
"postlane": {
"command": "npx",
"args": ["-y", "postlane-mcp"],
"env": { "POSTLANE_API_KEY": "pl_live_..." }
}
}
}
隐私
此插件不会在你的计算机上存储任何内容。Postlane 工具运行时,会将你的 API 密钥以及你请求发送的邮件(发件人、收件人、主题和正文)发送到 Postlane API(https://www.postlane.email),不会发送到其他地方。只要工作区存在,Postlane 就会保留发送记录。请参阅隐私政策和服务条款。
开发
npm test 会运行 MCP 服务测试。每个 Agent 都会读取此文件夹中的专属清单:
| Agent | 清单 |
|---|---|
| Cursor | .cursor-plugin/plugin.json 和 mcp.json |
| Claude Code | .claude-plugin/plugin.json 和 .claude-plugin/marketplace.json |
| Gemini CLI | gemini-extension.json |
| Codex 和 ChatGPT | .codex-plugin/plugin.json |
| MCP Registry 和 npm | server.json 和 package.json |
发布时,请确保所有文件中的 version 保持一致。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。