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. 03DNS検証が保留中の際の調査
  4. 04送信用サブドメインの設定

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/setting-up-sending-domainを入力して読み込まれたか確認します。

詳細

Mailtrap 送信ドメインの設定

概要

ライブ送信を開始する前に、自分が管理するドメインを追加して認証する必要があります。Mailtrap は、そのドメインに必要なすべての DNS レコードをUIに表示します。表示されたとおりに一式すべて追加してください（一部だけ選ばないでください）。DNS の認証が完了したら、求められた場合はコンプライアンスの手順を完了します。

サブドメインとルートドメイン： From アドレスで使用する正確なホスト名を追加してください。notifications.mycompany.com から送信する場合は、mycompany.com だけではなく、そのサブドメインを送信ドメインとして追加します。ただし、ルートドメインから実際に送信する場合は除きます。

一般的なホストでのクリック手順については、Sending domain setup の該当するガイド（Cloudflare、Route 53 など）を開き、ライブのUIに表示される値と照らし合わせながら進めてください。

関連スキル： authorizing-api-requests（トークン、環境変数、account_id の解決）、sending-emails（ドメインの準備完了後）。

使用する場合

  • 新しい送信ドメインの設定、認証が進まない場合、またはコンプライアンスに関する質問
  • Cloudflare、AWS、Google、Namecheap、GoDaddy、DigitalOcean などでの DNS 設定

使用しない場合

  • カスタムドメインを使わないサンドボックスのみのテスト（testing-with-sandbox を参照）

認証

以下の送信ドメイン API 呼び出しでは、Authorization: Bearer $MAILTRAP_API_TOKEN と、パス内の $MAILTRAP_ACCOUNT_ID が必要です。トークンのスコープと保存方法、および GET https://mailtrap.io/api/accounts から $MAILTRAP_ACCOUNT_ID を解決するワンライナーについては、スキル authorizing-api-requests で説明しています。

設定の自動化（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 による自動化が利用できない場合は、Sending Domains > Add domain > レジストラーのUIに値をコピー > Verify の順に進めます。

ワークフロー（概要）

  1. Sending Domains > Add domain を選び、ドメイン名を入力します。
  2. UIまたは送信ドメイン API から必要なレコードを取得し、表示どおりに（名前、タイプ、値を含めて）一覧にあるレコードをすべて DNS ホストに作成します。
  3. DNS の伝播を待ちます。認証が保留中のままの場合は、dig、nslookup、またはオンライン DNS ルックアップを使って、Verify を再度クリックする前に各レコードが公開されていることを確認します。
  4. 求められた場合は、コンプライアンスの手順を完了します。

製品の操作ガイド：Sending domain setup。

DNS プロバイダーガイド（ドキュメント）

Mailtrap では、一般的なプロバイダー向けにクリック手順付きのガイドを公開しています。ユーザーの DNS ホストに該当するページを開き、最新の UI レコードと照らし合わせながら設定してください。

ユーザーのプロバイダーが一覧にない場合も、同じルールが適用されます。Mailtrap に表示されているすべてのレコードを、From ドメインを管理する DNS ゾーンにコピーしてください。

DNS に関する重要な注意点（プロキシ経由の DNS）

DNS プロバイダーがレコードをプロキシ経由で処理する場合（Cloudflare のオレンジ色の雲や、他サービスの同様の CDN／プロキシモードなど）、Mailtrap のドキュメントでプロキシが明示的に許可されていない限り、認証関連のレコードはDNS のみ（灰色の雲／プロキシなし）にする必要があります。プロキシ経由の CNAME などは、SPF／DKIM の認証を妨げることがよくあります。同じ制約は、DNS の前段にプロキシを配置するすべてのホストに適用されます。

コメント

Markdown 対応