mcpField
S
setting-up-sending-domain

setting-up-sending-domain

github.com/mailtrap云与 DevOps1152 次安装今天更新
代码仓库

关于 setting-up-sending-domain

setting-up-sending-domain 是 Mailtrap 的技能，用于配置并验证实时邮件发送域名，涵盖必需的 DNS 记录、API 自动化、验证及合规步骤。

主要功能

  1. 01创建并验证发送域名
  2. 02获取所需 DNS 记录
  3. 03通过服务商 API 发布 DNS
  4. 04检查验证状态
  5. 05合规步骤指南

适用场景

  1. 01为实时邮件发送准备域名
  2. 02自动化配置域名与 DNS
  3. 03排查 DNS 验证待处理状态
  4. 04设置发送子域名

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mailtrap/mailtrap-skills --skill setting-up-sending-domain

安装后在 Claude Code 中输入/setting-up-sending-domain确认已加载。

详细介绍

设置 Mailtrap 发送域

概览

在正式发送邮件前，必须添加并验证你控制的域名。Mailtrap 会在 UI 中显示该域名所需的所有 DNS 记录：请按原样添加完整记录集（不要挑选其中一部分）。DNS 验证通过后，如果系统要求，请完成合规步骤。

子域名与根域名：添加你将在 From 地址中使用的确切主机名。如果你从 notifications.mycompany.com 发送邮件，请将该子域名添加为发送域，而不只是添加 mycompany.com，除非你确实从根域名发送邮件。

如需了解常见主机的分步操作，请打开 发送域设置 中对应的指南（Cloudflare、Route 53 等），并对照实时 UI 中显示的值进行操作。

相关技能：authorizing-api-requests（令牌、环境变量、account_id 解析）、sending-emails（域名就绪后使用）。

适用场景

  • 设置新的发送域、验证卡住或有合规相关问题
  • DNS 托管在 Cloudflare、AWS、Google、Namecheap、GoDaddy、DigitalOcean 等平台

不适用场景

  • 不使用自定义域名进行沙盒测试（参见 testing-with-sandbox）

授权

以下发送域 API 调用需要 Authorization: Bearer $MAILTRAP_API_TOKEN，并且路径中需要 $MAILTRAP_ACCOUNT_ID。技能 authorizing-api-requests 介绍了令牌范围、存储方式，以及通过 GET https://mailtrap.io/api/accounts 解析 $MAILTRAP_ACCOUNT_ID 的单行命令。

自动化设置（API 和 DNS 提供商）

编写脚本或构建 AI 辅助自动化时，优先采用此方式：

  1. 通过 API 获取 DNS 记录和状态 — 使用发送域 API：
  • GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/sending_domains — 列出域名
  • GET https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/sending_domains/{sending_domain_id} — 返回 dns_records（每条记录包含 type、name、value 和验证 status）以及 dns_verified。发布 DNS 记录后轮询此接口。
  1. 通过 API 创建域名 —
  • 当工作流以编程方式配置域名时，使用 domain_name 调用 POST https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/sending_domains。
  1. 以编程方式发布 DNS 记录 —
  • 使用 DNS 托管服务商的 API（例如 Cloudflare API、AWS Route 53、Google Cloud DNS）或 IaC 创建返回的记录。记录名称和值必须与 API 响应完全一致。

人工备用方案：无法使用 API 自动化时，依次进入发送域 > 添加域名 > 将值复制到注册商的 UI 中 > 验证。

工作流（摘要）

  1. 进入发送域 > 添加域名并输入域名。
  2. 从 UI 或发送域 API 获取所需记录；在 DNS 托管服务商处按显示的内容准确创建所有列出的记录（名称、类型和值）。
  3. 等待 DNS 传播。如果验证仍处于待处理状态，请使用 dig、nslookup 或在线 DNS 查询工具，确认每条记录都已公开可查，然后再次点击验证。
  4. 根据提示完成合规流程。

产品操作指南：发送域设置。

DNS 提供商指南（文档）

Mailtrap 为常见提供商提供了按操作路径编写的指南。打开与用户的 DNS 托管商相对应的页面，并结合实时 UI 记录进行操作：

如果用户的提供商未列出，同样适用此规则：将 Mailtrap 中的每条记录都复制到为发件人域名提供服务的 DNS 区域中。

重要的 DNS 注意事项（代理 DNS）

如果你的 DNS 提供商会代理记录（例如 Cloudflare 的橙色云朵，以及其他地方类似的 CDN／代理模式），除非 Mailtrap 文档明确允许代理，否则与验证相关的记录必须设为仅 DNS（灰色云朵／非代理）。代理的 CNAME 和类似记录通常会导致 SPF／DKIM 验证失败。此限制同样适用于任何在 DNS 前端使用代理的托管商。

评论

支持 Markdown