← 記事一覧

連携ガイド

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に任せ、実際の送信は承認ゲートに載せます。担当者が宛先と内容を確認してから通す運用になり、誤送信や誤った一斉送信を防げます。


Grantry

Resendへのアクセスに、権限の判断を1枚挟む。

無料で始める

導入前のご相談は [email protected] へどうぞ。