名称: postmark-automation 描述: “通过Rube MCP (Composio)自动化Postmark电子邮件投递任务：发送模板邮件、管理模板、监控投递统计和退回邮件。始终首先搜索工具以获取当前模式。” 要求: mcp: [rube] 类别: 电子邮件

通过Rube MCP进行Postmark自动化

通过Composio的Postmark工具包和Rube MCP自动化Postmark事务性电子邮件操作。

工具包文档: composio.dev/toolkits/postmark

先决条件

Rube MCP必须已连接（RUBE_SEARCH_TOOLS可用）
通过RUBE_MANAGE_CONNECTIONS使用工具包postmark激活Postmark连接
始终首先调用RUBE_SEARCH_TOOLS以获取当前工具模式

设置

获取Rube MCP: 在客户端配置中将https://rube.app/mcp添加为MCP服务器。无需API密钥—只需添加端点即可工作。

通过确认RUBE_SEARCH_TOOLS响应来验证Rube MCP是否可用
使用工具包postmark调用RUBE_MANAGE_CONNECTIONS
如果连接不是ACTIVE，请按照返回的认证链接完成Postmark认证
在运行任何工作流之前确认连接状态显示为ACTIVE

核心工作流

1. 发送模板批量电子邮件

使用时机: 用户希望在一个调用中向多个收件人发送模板邮件

工具序列:

POSTMARK_LIST_TEMPLATES - 查找可用模板及其ID [先决条件]
POSTMARK_VALIDATE_TEMPLATE - 在发送前使用模型数据验证模板 [可选]
POSTMARK_SEND_BATCH_WITH_TEMPLATES - 使用模板发送批量邮件 [必需]

关键参数:

TemplateId或TemplateAlias: 要使用的模板标识符
Messages: 包含From、To、TemplateModel的消息对象数组
TemplateModel: 匹配模板变量的键值对

常见问题:

每批调用最多500条消息
必须指定TemplateId或TemplateAlias之一，不能同时使用
TemplateModel的键必须与模板变量名称完全匹配（区分大小写）
发件人地址必须是已验证的Sender Signature或来自已验证的域名

2. 管理电子邮件模板

使用时机: 用户希望创建、编辑或检查电子邮件模板

工具序列:

POSTMARK_LIST_TEMPLATES - 列出所有模板及其ID和名称 [必需]
POSTMARK_GET_TEMPLATE - 获取完整模板详细信息，包括HTML/文本正文 [可选]
POSTMARK_EDIT_TEMPLATE - 更新模板内容或设置 [可选]
POSTMARK_VALIDATE_TEMPLATE - 使用样本数据测试模板渲染 [可选]

关键参数:

TemplateId: 用于GET/EDIT操作的数字模板ID
Name: 模板显示名称
Subject: 电子邮件主题行（支持模板变量）
HtmlBody: 模板的HTML内容
TextBody: 纯文本回退内容
TemplateType: ‘Standard’或’Layout’

常见问题:

模板ID是数字整数，不是字符串
编辑模板会替换整个内容；包含所有您想保留的字段
布局模板包装标准模板；更改布局会影响所有链接的模板
在发送前验证以尽早捕获缺失变量

3. 监控投递统计

使用时机: 用户希望检查电子邮件投递健康状态、打开/点击率或出站概览

工具序列:

POSTMARK_GET_DELIVERY_STATS - 获取按类型统计的退回次数 [必需]
POSTMARK_GET_OUTBOUND_OVERVIEW - 获取发送/打开/点击/退回摘要 [必需]
POSTMARK_GET_TRACKED_EMAIL_COUNTS - 获取随时间变化的跟踪电子邮件量 [可选]

关键参数:

fromdate: 统计过滤的开始日期（YYYY-MM-DD）
todate: 统计过滤的结束日期（YYYY-MM-DD）
tag: 按消息标签过滤统计
messagestreamid: 按消息流过滤（例如，‘outbound’、‘broadcast’）

常见问题:

日期参数使用YYYY-MM-DD格式，不含时间组件
统计是聚合的；个别消息跟踪需要单独的API调用
messagestreamid 默认为所有流，如果未指定

4. 管理退回和投诉

使用时机: 用户希望查看退回的电子邮件或垃圾邮件投诉

工具序列:

POSTMARK_GET_BOUNCES - 列出退回消息及其详细信息 [必需]
POSTMARK_GET_SPAM_COMPLAINTS - 列出垃圾邮件投诉记录 [可选]
POSTMARK_GET_DELIVERY_STATS - 获取退回摘要计数 [可选]

关键参数:

count: 每页返回的记录数
offset: 结果的分页偏移量
type: 退回类型过滤器（例如，‘HardBounce’、‘SoftBounce’、‘SpamNotification’）
fromdate/todate: 日期范围过滤器
emailFilter: 按收件人电子邮件地址过滤

常见问题:

退回类型包括：HardBounce、SoftBounce、SpamNotification、SpamComplaint、Transient等
硬退回表示永久性投递失败；这些地址应被移除
垃圾邮件投诉影响发件人声誉；定期监控
分页使用count和offset，而不是页面令牌

5. 配置服务器设置

使用时机: 用户希望查看或修改Postmark服务器配置

工具序列:

POSTMARK_GET_SERVER - 检索当前服务器设置 [必需]
POSTMARK_EDIT_SERVER - 更新服务器配置 [可选]

关键参数:

Name: 服务器显示名称
SmtpApiActivated: 启用/禁用SMTP API访问
BounceHookUrl: 退回通知的Webhook URL
InboundHookUrl: 入站电子邮件处理的Webhook URL
TrackOpens: 启用/禁用打开跟踪
TrackLinks: 链接跟踪模式（‘None’、‘HtmlAndText’、‘HtmlOnly’、‘TextOnly’）

常见问题:

服务器编辑影响通过该服务器发送的所有消息
Webhook URL必须是公开可访问的HTTPS端点
更改SmtpApiActivated会立即影响SMTP中继访问
跟踪设置仅适用于未来消息，不能追溯

常见模式

模板变量解析

1. 使用TemplateId调用POSTMARK_GET_TEMPLATE
2. 检查HtmlBody/TextBody中的{{variable}}占位符
3. 构建匹配键的TemplateModel字典
4. 调用POSTMARK_VALIDATE_TEMPLATE验证渲染

分页

设置count为每页结果数（因端点而异）
使用offset跳过先前获取的结果
每页按计数递增偏移量，直到返回结果 < 计数
响应元数据中可能会返回总记录数

已知问题

认证:

Postmark使用服务器级API令牌，而非账户级
每个服务器有自己的令牌；确保正确的服务器上下文
发件人地址必须是已验证的Sender Signature或来自已验证的域名

速率限制:

批量发送每批限制为500条消息
API速率限制因端点而异；在429响应时实施退避

响应解析:

响应数据可能嵌套在data或data.data下
使用回退模式进行防御性解析
模板ID始终是数字整数

快速参考

任务	工具缩写	关键参数
发送批量模板邮件	POSTMARK_SEND_BATCH_WITH_TEMPLATES	Messages, TemplateId/TemplateAlias
列出模板	POSTMARK_LIST_TEMPLATES	Count, Offset, TemplateType
获取模板详细信息	POSTMARK_GET_TEMPLATE	TemplateId
编辑模板	POSTMARK_EDIT_TEMPLATE	TemplateId, Name, Subject, HtmlBody
验证模板	POSTMARK_VALIDATE_TEMPLATE	TemplateId, TemplateModel
投递统计	POSTMARK_GET_DELIVERY_STATS	(无或日期过滤器)
出站概览	POSTMARK_GET_OUTBOUND_OVERVIEW	fromdate, todate, tag
获取退回	POSTMARK_GET_BOUNCES	count, offset, type, emailFilter
获取垃圾邮件投诉	POSTMARK_GET_SPAM_COMPLAINTS	count, offset, fromdate, todate
跟踪电子邮件计数	POSTMARK_GET_TRACKED_EMAIL_COUNTS	fromdate, todate, tag
获取服务器配置	POSTMARK_GET_SERVER	(无)
编辑服务器配置	POSTMARK_EDIT_SERVER	Name, TrackOpens, TrackLinks

由 Composio 提供支持