API と MCP によるドメインエイリアス

ドメインエイリアスを使うと、あるドメインで別のドメインの受信アドレスを利用できます。hello@company.example がメールを受信できる場合、2つ目のメールボックスやエイリアスを作成して管理することなく、hello@brand.example 宛てのメールを同じ場所に配信できます。

この機能は受信専用です。From アドレスの作成、SMTP の変更、接続したドメイン名での送信は行いません。

便利な使用場面

複数のブランドドメイン、顧客メールを引き続き受信する旧ドメイン、または同じ受信トレイ名を共有する各国向けドメインを企業が所有している場合に、ドメインエイリアスが役立ちます。

例:

hello@brand.example   → hello@company.example
billing@brand.example → billing@company.example

@ より前の部分は完全に同じままです。プライマリドメインに一致するアドレスが存在しない場合、TrekMail が自動的に作成することはありません。

プランと上限

1つの接続ドメインが同時に参照できるプライマリドメインは1つです。プライマリドメインは、アカウントの通常のドメイン上限まで複数の接続ドメインに対応できます。1つのドメインを接続ドメインとプライマリドメインの両方にはできないため、ルーティングが単純になり、ループを防止できます。

両方のドメインが同じアカウントに属し、受信メールに TrekMail を使用し、アクティブで、MX レコードが正常に機能している必要があります。プラン、アカウント、または DNS の状態が後で変わった場合、TrekMail は保存済みの接続を維持しますが、要件が再び満たされるまで配信を一時停止します。

優先される設定

ドメインエイリアスが動作するのは、TrekMail が接続ドメインに設定済みの完全一致アドレスを確認した後です。既存のメールボックス、エイリアス、転送アドレス、メールボックス転送、catch-all 設定は、ドキュメントに記載された優先順位を維持します。

つまり、意図的に設定した sales@brand.example ルールが sales@company.example に暗黙のうちに置き換わることはありません。

REST API

3つのエンドポイントでは接続ドメインの ID を使用します。

既存の連携を壊さないように、エンドポイントは元の /matching-addresses パスを維持します。ダッシュボードとドキュメントでは、より明確な業界用語である ドメインエイリアス を使用します。

PUT と DELETE には Idempotency-Key ヘッダーが必要です。同じキーを使用して同じ成功済みリクエストを繰り返しても安全です。

ドメインを接続する

PUT /api/v1/domains/42/matching-addresses
Authorization: Bearer tm_live_...
Idempotency-Key: matching-brand-company-v1
Content-Type: application/json

{
  "primary_domain_id": 7
}

結果を読み取る

{
  "configured": true,
  "enabled": true,
  "delivering": true,
  "status": "delivering",
  "paused_reason": null,
  "alias_domain": {
    "id": 42,
    "domain": "brand.example"
  },
  "primary_domain": {
    "id": 7,
    "domain": "company.example"
  },
  "primary_domain_restricted": false
}

configured は接続が保存されているかどうかを示します。delivering は現在動作しているかどうかを示します。保存済みの行をメールが流れている証拠とみなさず、両方を確認してください。

トークンが接続ドメインにはアクセスできてもプライマリドメインにはアクセスできない場合、レスポンスは primary_domain_restricted を true に設定し、プライマリドメインの識別情報を非表示にします。トークンの許可リスト外にあるドメインを漏えいすることはありません。

配信状態

MCP ツール

同じワークフローを3つのドメインツールから利用できます。

• get_domain_alias: 保存済みの接続と現在の配信状態を読み取ります。
• set_domain_alias: プライマリドメインを接続または変更します。
• remove_domain_alias: confirm_remove: true の指定後に接続を解除します。

ホスト型 MCP では OAuth 中に承認された権限が適用されます。ローカルでホストする MCP の管理者は、書き込み操作に明示的な承認を必須とすることができます。どちらの方式でも、アカウントプラン、トークンスコープ、ドメイン許可リスト、サーバー側の検証が適用されます。

ツール名と顧客向けタイトルには ドメインエイリアス を使用します。REST エンドポイントは互換性のため元のパスを維持します。

安全な削除とダウングレード

接続を削除しても、どちらのドメインもメールボックスも削除されません。完全一致メールボックス、エイリアス、転送アドレス、catch-all ルールは変更されません。マッチングだけに依存していた一致しないアドレスはバウンスする可能性があるため、削除を確定する前にドメインを確認してください。

接続ドメインを削除すると、その接続は自動的に削除されます。接続ドメインが依存している間は TrekMail でプライマリドメインを削除できません。先にそれらのドメインの接続を解除してください。

Nano にダウングレードすると、接続は保存されたままですが配信を停止します。Starter 以上に戻すと、プライマリドメインを再入力せずに接続が復元されます。

監査証跡

API または MCP によるすべての変更は、AI エージェントと API → 監査ログ に表示されます。接続イベントと変更イベントには、両方のドメイン ID、該当する場合は以前のプライマリドメイン、操作したトークン、リクエスト ID、時刻が記録されます。削除イベントには削除された接続が記録されます。メールの内容や認証情報がこれらのイベントに書き込まれることはありません。

トラブルシューティング用チェックリスト

1. 両方のドメインが アクティブ と表示され、受信メールに TrekMail を使用していることを確認します。
2. 両方のドメインの MX レコードが正常であることを確認します。
3. アカウントが Starter、Pro、Agency のいずれかであることを確認します。
4. configured、delivering、status、paused_reason をまとめて確認します。
5. 完全一致メールボックス、エイリアス、転送アドレス、catch-all ルールがすでにそのアドレスを処理していないか確認します。
6. 最後の接続、変更、削除について監査ログを確認します。