SmartleadをAIエージェントに安全に連携する｜権限・承認・監査の設計

Smartlead（コールドメール）をAIエージェントにつなぐと、キャンペーンの分析、リードリストの整備、シーケンスの下書きを自動化できます。便利な一方で、キャンペーンの作成やリード追加、稼働状態の変更は実際の送信につながる操作です。連携の前に権限設計を決めておくべきです。

Smartlead連携でまず起きる問題

SmartleadをそのままAIエージェントに渡すと、典型的に次の問題が起きます。

APIキーの散在：プロンプトやローカルのMCP設定に置いた認証情報は、漏れたときにSmartleadの操作が丸ごと露出します。
読み取りと書き込みが同じ扱い：参照も更新も、エージェントから見れば同じ「ツール呼び出し」です。区別がなければ、AIは同じ気軽さで実行します。
外部に飛ぶ操作：キャンペーン稼働やリード追加は、相手への実際の送信につながり取り消せません。

読み取りは自由に、書き込みは承認制に

実務的な原則はシンプルです。参照系は自由に、更新系は人間の承認を経てから。Smartleadの操作をこの2種類に仕分けます。

自由に実行してよい（読み取り）：キャンペーン・リード・統計・メールアカウント・送信履歴の参照。分析はここで完結します。
承認を挟む（書き込み）：キャンペーンの作成、リードの追加、シーケンス保存、稼働ステータスの変更。特に稼働開始は送信につながります。

こうしておけば、AIエージェントは分析や下書きまで一人で走り切り、外部や本番に効く操作の直前だけ担当者が確認する、という運用になります。

生のAPIキーをエージェントに渡さない

もう一つの要点は認証情報の置き場所です。SmartleadのAPIキーをエージェントのランタイムやプロンプトに置くのは避けます。認証情報はサーバー側に暗号化して保管し、エージェントにはスコープ付きの権限トークンを1つだけ渡す。こうすれば、あるワーカーのトークンが漏れても、失効はそのワーカーの範囲に限定でき、Smartlead本体の認証情報を作り直す必要はありません。

すべての操作を監査ログに残す

Smartlead を扱う以上、「誰が・どのワーカーで・何をしたか」を後から追えることは必須です。承認された操作もブロックされた操作も、ワーカー・ロール・ツール・接続・リクエスト・結果まで記録しておけば、後からの調査や説明責任にそのまま使えます。

Grantryでの実現方法

Grantryは、AIエージェントと業務ツールの間に入る権限レイヤーです。 Smartleadを含むMCP対応のサービスに対して、ワーカーごとにスコープ付きトークンを1つ発行し、読み取りは自由に、キャンペーン稼働などの書き込みは承認ゲート越しに、そして全コールを監査ログに残します。 Claude CodeやCodexなどのMCPクライアントを、ワーカートークン付きでGrantryのエンドポイントに向けるだけで、エージェント側のコード変更なしに始められます。

よくある質問

AIエージェントにSmartleadのAPIキーを直接渡しても大丈夫ですか？

推奨しません。プロンプトやローカルのMCP設定に置いたAPIキーは、Smartleadでできる操作すべて（例：キャンペーンの稼働・リード追加）を許す常時オファーになります。APIキーはサーバー側に暗号化して保管し、エージェントにはスコープ付きの権限トークンを1つだけ渡す設計が安全です。

Smartleadのキャンペーンの稼働・リード追加をAIに自動実行させても問題ないですか？

キャンペーンの稼働・リード追加は影響が大きい、または戻せない書き込みです。キャンペーンの参照などの読み取り・分析は自由に実行させ、キャンペーンの稼働・リード追加は人間の承認を経てから実行する承認ゲートを挟むのが実務的です。

AIに準備だけさせて、送信開始は人が承認できますか？

できます。キャンペーンやリードの参照・分析・シーケンス下書きまでをAIに任せ、リード追加やキャンペーンの稼働開始は承認ゲートに載せます。担当者が確認してから送信が始まる運用になります。