連携ガイド
ResendをAIエージェントに安全に連携する|権限・承認・監査の設計
Resend(メール配信)をAIエージェントにつなぐと、配信状況の確認、ドメイン設定の点検、メール下書きの作成を自動化できます。便利な一方で、メール送信は相手に届いてしまえば取り消せない操作です。連携の前に権限設計を決めておくべきです。
Resend連携でまず起きる問題
ResendをそのままAIエージェントに渡すと、典型的に次の問題が起きます。
- APIキーの散在:プロンプトやローカルのMCP設定に置いた認証情報は、漏れたときにResendの操作が丸ごと露出します。
- 読み取りと書き込みが同じ扱い:参照も更新も、エージェントから見れば同じ「ツール呼び出し」です。区別がなければ、AIは同じ気軽さで実行します。
- 誤送信・一斉送信:メール送信は宛先や内容を誤っても取り消せず、一斉送信なら影響が広がります。
読み取りは自由に、書き込みは承認制に
実務的な原則はシンプルです。参照系は自由に、更新系は人間の承認を経てから。Resendの操作をこの2種類に仕分けます。
- 自由に実行してよい(読み取り):メール・ドメイン・APIキー一覧の参照。配信状況の確認はここで完結します。
- 承認を挟む(書き込み):メールの送信。宛先・内容を誤ると取り返しがつきません。
こうしておけば、AIエージェントは分析や下書きまで一人で走り切り、外部や本番に効く操作の直前だけ担当者が確認する、という運用になります。
生のAPIキーをエージェントに渡さない
もう一つの要点は認証情報の置き場所です。ResendのAPIキーをエージェントのランタイムやプロンプトに置くのは避けます。 認証情報はサーバー側に暗号化して保管し、エージェントにはスコープ付きの権限トークンを1つだけ渡す。 こうすれば、あるワーカーのトークンが漏れても、失効はそのワーカーの範囲に限定でき、Resend本体の認証情報を作り直す必要はありません。
すべての操作を監査ログに残す
Resend を扱う以上、「誰が・どのワーカーで・何をしたか」を後から追えることは必須です。 承認された操作もブロックされた操作も、ワーカー・ロール・ツール・接続・リクエスト・結果まで記録しておけば、 後からの調査や説明責任にそのまま使えます。
Grantryでの実現方法
Grantryは、AIエージェントと業務ツールの間に入る権限レイヤーです。 Resendを含むMCP対応のサービスに対して、ワーカーごとにスコープ付きトークンを1つ発行し、 読み取りは自由に、メール送信などの書き込みは承認ゲート越しに、そして全コールを監査ログに残します。 Claude CodeやCodexなどのMCPクライアントを、ワーカートークン付きでGrantryのエンドポイントに向けるだけで、 エージェント側のコード変更なしに始められます。
よくある質問
AIエージェントにResendのAPIキーを直接渡しても大丈夫ですか?
推奨しません。プロンプトやローカルのMCP設定に置いたAPIキーは、Resendでできる操作すべて(例:メール送信)を許す常時オファーになります。APIキーはサーバー側に暗号化して保管し、エージェントにはスコープ付きの権限トークンを1つだけ渡す設計が安全です。
Resendのメール送信をAIに自動実行させても問題ないですか?
メール送信は影響が大きい、または戻せない書き込みです。配信状況の参照などの読み取り・分析は自由に実行させ、メール送信は人間の承認を経てから実行する承認ゲートを挟むのが実務的です。
AIにメールの下書きまでさせて、送信は人が承認できますか?
できます。配信状況やドメインの参照、メールドラフト作成までをAIに任せ、実際の送信は承認ゲートに載せます。担当者が宛先と内容を確認してから通す運用になり、誤送信や誤った一斉送信を防げます。