【用途】 该技能用于通过 Rube MCP（Composio）自动化 SendGrid 的邮件相关操作，包括发送邮件、管理联系人与列表、配置发件人身份、处理模板以及查看邮件分析数据。
【准备工作】 使用前需要：
- 连接 Rube MCP（需 RUBE_SEARCH_TOOLS 可用）。
- 在 RUBE_MANAGE_CONNECTIONS 中以 sendgrid 工具包建立有效的 SendGrid 连接。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
设置步骤：
- 在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥。
- 确认 RUBE_SEARCH_TOOLS 有响应。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包为 sendgrid。
- 若连接非 ACTIVE，按返回的认证链接完成 SendGrid API 密钥认证。
- 确认连接状态为 ACTIVE 后再运行工作流。
【核心工作流】
-
创建并发送营销活动（Single Sends） 适用场景：向联系人列表或分群创建并发送营销邮件。 工具顺序：SENDGRID_RETRIEVE_ALL_LISTS、SENDGRID_CREATE_A_LIST（可选）、SENDGRID_ADD_OR_UPDATE_A_CONTACT（可选）、SENDGRID_GET_ALL_SENDER_IDENTITIES、SENDGRID_CREATE_SINGLE_SEND（必需）。 关键参数：name、email__config__subject、email__config__html__content、email__config__plain__content、email__config__sender__id、email__config__design__id、send__to__list__ids、send__to__segment__ids、send__to__all、email__config__suppression__group__id 或 email__config__custom__unsubscribe__url（合规必需其一）。 注意：CREATE 时设置 send_at 不会真正排程，仅预填 UI 日期，需另用 Schedule 端点；send_at:"now" 仅对 Schedule 端点有效；发件人须先验证；嵌套参数用双下划线表示法。
-
管理联系人与列表 适用场景：创建联系人列表、增改联系人、按邮箱搜索或从列表移除联系人。 工具顺序：SENDGRID_RETRIEVE_ALL_LISTS、SENDGRID_CREATE_A_LIST、SENDGRID_GET_A_LIST_BY_ID、SENDGRID_ADD_OR_UPDATE_A_CONTACT、SENDGRID_GET_CONTACTS_BY_EMAILS、SENDGRID_GET_CONTACTS_BY_IDENTIFIERS、SENDGRID_GET_LIST_CONTACT_COUNT、SENDGRID_REMOVE_CONTACTS_FROM_A_LIST、SENDGRID_REMOVE_LIST_AND_OPTIONAL_CONTACTS、SENDGRID_IMPORT_CONTACTS。 关键参数：contacts（最多 30,000 个或 6MB，每个至少含 email、phone_number_id、external_id、anonymous_id 之一）、list_ids。 注意：增改联系人为异步，返回 202 与 job_id，需等 10–30 秒；列表 ID 为 UUID；列表名需唯一；删除列表不可逆，需用户明确确认；邮箱会自动转为小写。
-
管理发件人身份 适用场景：设置或查看发件人身份（From 地址）。 工具顺序：SENDGRID_GET_ALL_SENDER_IDENTITIES、SENDGRID_CREATE_A_SENDER_IDENTITY、SENDGRID_VIEW_A_SENDER_IDENTITY、SENDGRID_UPDATE_A_SENDER_IDENTITY、SENDGRID_CREATE_VERIFIED_SENDER_REQUEST、SENDGRID_AUTHENTICATE_A_DOMAIN。 关键参数：from__email、from__name、reply__to__email、nickname、address、city、country（CAN-SPAM 合规必需）。 注意：新发件人须先验证；每账户最多 100 个发件人身份；避免使用 DMARC 严格的域名（如 gmail.com、yahoo.com）作为 From 地址。
-
查看邮件统计与活动 适用场景：查看投递统计、退信率、打开/点击指标或邮件活动。 工具顺序：SENDGRID_RETRIEVE_GLOBAL_EMAIL_STATISTICS、SENDGRID_GET_ALL_CATEGORIES、SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_CATEGORIES、SENDGRID_FILTER_ALL_MESSAGES、SENDGRID_FILTER_MESSAGES_BY_MESSAGE_ID、SENDGRID_REQUEST_CSV、SENDGRID_DOWNLOAD_CSV。 关键参数：start_date、end_date、aggregated_by、limit/offset；SENDGRID_FILTER_ALL_MESSAGES 的 query、limit。 注意：SENDGRID_FILTER_ALL_MESSAGES 需要付费附加组件，否则返回 403；全局统计嵌套在 details[].stats[0].metrics；分类统计仅近 13 个月；每请求最多 10 个分类；CSV 导出每 12 小时一次，链接 3 天后过期。
-
管理抑制 适用场景：检查或管理退订组以满足合规。 工具顺序：SENDGRID_GET_SUPPRESSION_GROUPS、SENDGRID_RETRIEVE_ALL_SUPPRESSION_GROUPS_FOR_AN_EMAIL_ADDRESS。 注意：被抑制地址即使位于营销列表中也无法投递；实际发送数可能少于列表数。
【常见模式】 ID 解析：始终先将名称解析为 ID，再执行操作。 分页：列表检索用 page_token/page_size（最大 1000），统计用 offset/limit（最大 500），应始终翻页以免遗漏列表。 异步：联系人操作为异步，返回 202 与 job_id，需等待后验证。
【已知限制】 ID 格式：营销列表 ID 为 UUID，旧版列表 ID 为整数，发件人身份 ID 为整数，动态模板 ID 以 "d-" 开头，联系人 ID 为 UUID。 速率限制：可能返回 HTTP 429，需遵循 Retry-After；CSV 导出每 12 小时一次；批量 upsert 上限 30,000 个或 6MB。 参数特性：嵌套参数用双下划线；CREATE_SINGLE_SEND 的 send_at 仅设 UI 默认值不排程；旧版 Contact Database API 可能在新账户返回 403，建议优先使用 Marketing API 工具。
【快速参考】 资料提供了一张任务与工具 slug 及关键参数的对照表，涵盖列表管理、联系人管理、Single Send、发件人身份、域名认证、统计、活动筛选、CSV 导出、分类、抑制组、模板等操作。