# 自社運用Managed Agentsのデータ境界

> セルフホスト型Managed Agentsはサービス本体と履歴保存を自社に置く構成。サーバが外部へ出す通信、3種の資格情報、1デプロイ1テナントの分離設計を整理する。

- Canonical: https://kuucorp.com/blog/self-hosted-managed-agents-server-data-boundary-multitenancy-design/
- Date: 2026-11-18
- Last modified: 2026-11-18
- Publisher: Kuu株式会社 (https://kuucorp.com)

---
セッション履歴を自社のデータベースに置けない。モデル呼び出しはBedrockやFoundry、社内のモデルゲートウェイに固定したい。セルフホストサンドボックスではツール実行しか自社に移せず、この2点は満たせない。2026年11月12日のリリースノートに載ったセルフホスト型[Managed Agents](/glossary/managed-agents/)は、サービス本体まで自社に置くことでこの要件に応える。本記事は、一次情報をもとに境界の引き方を設計判断として整理する。

## セルフホスト型Managed Agentsは何を自社に置くのか

> サービス本体とサンドボックスを自社で運用し、モデルだけをAnthropicか選んだ提供元に残す構成です。

公式ドキュメントは3つの選択肢を区別している。既定のクラウドサンドボックスは3要素すべてをAnthropicが持つ。セルフホストサンドボックスは実行環境だけが自社側になる。セルフホスト型Managed Agentsはサービスも自社側に移り、モデルだけが外に残る。

構成要素は4つある。サーバ（`cma-server`）はAPIとエージェントループを担い、シェルやファイルのツールは実行しない。データベースはPostgreSQL 16以降で、未設定なら履歴はメモリ保持となり再起動で消える。ワーカーはサンドボックスでツールを動かす。管理用のadmin CLIが環境と環境キーを作る。サンドボックス単体の設計は[セルフホストサンドボックスのメモリ同期設計](/blog/managed-agents-self-hosted-sandbox-memory-sync-design/)を参照してほしい。

## サーバは何を社外へ送るのか

> サーバの接続先は推論提供元・DB・許可したMCP等に限られ、Anthropicとの通信はClaude API利用時のみです。

各モデル呼び出しには、会話履歴、ツール入力、ツール結果が含まれる。Claude APIが提供元のときは、セッション・エージェント・環境のIDを載せた3つのヘッダも付く。IDに名前や内容は含まれないが、生成時刻は読み取れる。このヘッダを止める設定はない。

提供元をBedrock等に変えれば、これらのヘッダは送られない。Anthropicはサーバへのリモートアクセスを持たず、サーバが受け付ける資格情報もAnthropicは発行しない。監査では、公式の接続先一覧とegressプロキシのログを突き合わせる。

## 資格情報と権限はどう分けるのか

> サーバAPIキー・推論資格情報・環境キーの3種を、保持者ごとに分けて配布するのが設計の基本です。

| 資格情報 | 保持者 | 認証対象 |
|---|---|---|
| サーバAPIキー | アプリ・CLI・管理者 | サーバへのリクエスト |
| 推論資格情報 | サーバのみ | 推論提供元への呼び出し |
| 環境キー | ワーカー | 1環境の作業キューとセッション |

環境キーは、その環境内の全セッションのイベント読み取りとツール結果の投稿ができる。エージェントが実行するコードが触れるサンドボックスに置いてはならない。呼び出し側の統制にはOIDCのシングルサインオンを使い、トークンのグループを`developer`または`user`のロールへ対応づけ、サーバAPIキーは管理者に限る。

## ホステッド版との差分で何を設計し直すのか

> 履歴やスキルは移行されず、定期実行やWebhookも使えないため、移行前に公式の差分表を確認します。

公式の差分ページによると、ホステッド版の履歴は引き継がれず、エージェント、スキル、vault資格情報、メモリストアは作り直しになる。使えない機能は、クラウド環境、Files API、`mcp_oauth`のvault資格情報、定期実行、Webhook、dreamsなどだ。定期実行は自前のcron、Webhookはイベントストリームのポーリングで代替する。

既定で閉じている機能もある。MCPサーバは`mcp.allowed_hostnames`に完全一致で載せたホストにしか接続しない。Gitリポジトリは`git.allowed_hostnames`と`git.allowed_push_refs`が必要で、強制プッシュはサーバでは拒否されないため、ブランチ保護はGitホスト側で行う。`web_search`と`web_fetch`は設定で有効化し、提供元によっては使えない。MCPツール結果は既定100 KiBで切り詰められる。

## テナント分離はデプロイ単位でどう設計するのか

> 1つのデプロイが扱えるのは1テナント・1信頼レベルで、分離したい単位ごとにデプロイを分けるのが公式の設計方針です。

同一デプロイ内の環境は信頼レベルを分けない。サーバAPIキーは全環境に届き、ロールを持つ呼び出し元は全環境でセッションを実行できる。テナントや、信頼できるコードと信頼できないコードの混在には、DB・サーバAPIキー・ワーカーを別にしたデプロイを割り当てる。

SSOでは、デプロイごとに他と重ならない`audiences`を設定して他デプロイのトークンを拒否し、`default_role`は置かない。モデルゲートウェイを共用する場合は、`inference.headers`に`x-tenant-id`のようなヘッダを持たせて区別する。

### 規模別の運用負荷

サーバ、DB、サンドボックス、リリース更新のすべてが運用責任になる。ホステッド版でAnthropicが担っていたメモリストアのホスト、異常な利用の検知、サーバ保護も自社の責務だ。Prometheusの指標エンドポイントは認証なしで、既定ではローカルホストのみで待ち受ける。Kubernetesでは全ポッドで公開されうるため、NetworkPolicyで遮断する。

## 参考

- [Self-hosted Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/self-hosted)
- [Data and access in self-hosted Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/self-hosted-data-and-access)
- [Differences from the hosted service](https://platform.claude.com/docs/en/managed-agents/self-hosted/differences)
- [Claude Platform Release notes](https://platform.claude.com/docs/en/release-notes/overview)

## まとめ

セルフホスト型Managed Agentsは、履歴保存と推論提供元の選択権を自社に取り戻す一方、サーバの保護、アップデート、テナント分離を運用側に移す。導入判断は、差分表の不可機能が自社の要件に影響しないかの確認から始める。マルチテナントの統制設計やエージェント基盤の大規模展開は、[大企業向けAI変革プログラム RDE](https://kuucorp.com/services/rde/)で相談できる。
