mcpField
P
postlane

postlane

本地服务
postlane.email通信协作02 周前更新

关于 postlane

postlane 为编码 Agent 提供通过 Postlane API 发送事务性邮件及查看发送活动的插件,面向需要接入邮件流程的开发者。它包含指导 Agent 使用 API 的 skill 和提供邮件操作的 MCP 服务,并支持多种编码 Agent。

主要功能

  1. 01发送事务性邮件
  2. 02按 ID 查询邮件
  3. 03列出邮件发送记录
  4. 04提供编码 Agent 使用指南

适用场景

  1. 01发送欢迎邮件和密码重置邮件
  2. 02发送收据与通知
  3. 03检查邮件发送状态和活动记录

MCP 相关

MCP 服务向客户端提供 send_email、get_email 和 list_emails 工具,通过 Postlane API 操作邮件。使用需要 Postlane API 密钥;list_emails 还要求具备相应读取权限。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"zwebso-postlane": {
"command": "npx",
"args": [
"-y",
"postlane-mcp"
],
"env": {
"POSTLANE_API_KEY": "<POSTLANE_API_KEY>"
}
}
}
}
启动命令npx -y postlane-mcp
需要配置的环境变量
POSTLANE_API_KEY密钥Bearer key from https://www.postlane.email/app/api-keys. It starts with pl_live_.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmpostlane-mcp0.1.0

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
ccany否可选抄送
toany是收件人电子邮件地址,或电子邮件地址数组
bccany否可选密送
fromstring是已验证的发件人,例如 [email protected]
htmlstring否
textstring否
subjectstring否
reply_tostring否
templatestring否已保存的模板名称,例如 Reset your password
variablesobject否
idempotency_keystring是此逻辑发送的稳定键。重试时请重复使用。

详细介绍

面向编码 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

  1. 从 Customize 安装插件,或将此文件夹复制到 ~/.cursor/plugins/local/postlane,然后重新加载 Cursor。
  2. 打开 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 CLIgemini-extension.json
Codex 和 ChatGPT.codex-plugin/plugin.json
MCP Registry 和 npmserver.json 和 package.json

发布时,请确保所有文件中的 version 保持一致。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。