ホスト型サービスとの違い

セルフホスト型Claude Managed Agentsサーバーは、このページで説明する違いを除き、AnthropicがホストするManaged Agentsサービスと同じAPIを備えています。以下の表では、それぞれへの対処方法を示します。アプリケーションをお使いのサーバーに移行する前に、これらを確認してください。ホスト型サービスからは、セッション履歴も含めて何もコピーされません。エージェント、スキル、ボールトの認証情報、メモリストアは、お使いのサーバー上で改めて作成してください。

お使いのサーバーにのみある機能

利用できない機能

動作が異なる機能

サーバー設定が必要な機能

これらの各機能は、サーバーの設定ファイルを変更するまで、無効であるか、すべてのホストを拒否します。

MCPサーバーには許可リストへの登録が必要

サーバーは、その設定ファイルのmcp.allowed_hostnamesにホストが記載されている「Model Context Protocol」、すなわちMCPのサーバーにのみ接続します：

mcp:
  allowed_hostnames:
    - mcp.example.com

ホストは完全一致で照合されます。ワイルドカードは使用できず、エントリはそのホストのサブドメインには一致しません。リストはデフォルトで空です。MCPサーバーのホストがリストに追加されるまで、お使いのサーバーはそのサーバーを指定するエージェントの保存を拒否します。

プライベートネットワーク内のMCPサーバーにはMCPトンネルは不要です。MCPコネクタの説明に従ってそのURLをエージェント定義に記載し、ホストを「allowlist」（許可リスト）に追加してください。URLには次の2つのルールが適用されます。

• MCPサーバーがループバックアドレス上にある場合を除き、httpsを使用する必要があります。
• ホストがプライベートアドレスまたは予約済みアドレスにのみ解決される名前である場合、お使いのサーバーはデフォルトで接続を拒否します。状況に合った対処方法を選んでください：

Gitリポジトリには許可リストへの登録が必要

ホスト型サービスでは、セルフホスト型サンドボックスを使用するセッションはgithub_repositoryリソースを持つことができません。お使いのサーバーでは、セッションはこれを持つことができます。サーバーは、設定ファイルに対象リポジトリのGitホストが記載されるまでこれらのリソースを拒否します。エージェントは記載したブランチにのみプッシュできます：

git:
  allowed_hostnames:
    - github.com
  allowed_push_refs:
    - refs/heads/agent/

次の点に注意してください：

• URL： ホストはgithub.comである必要はありませんが、URLはHTTPSを使用する必要があります。
• トークン： Gitのトラフィックはお使いのサーバーを経由し、サーバーがトークンを付加するため、クライアントが送信するトークンがサンドボックスに届くことはありません。
• ブランチ： エージェントにはブランチのリストが伝えられないため、プロンプトでブランチ名を指定してください。
• 強制プッシュ： サーバーは「force push」（強制プッシュ）を拒否しないため、エージェントは記載した任意のブランチを上書きできます。強制プッシュを拒否するには、Gitホスト側でブランチを保護してください。

GitHubへのアクセスでは、リクエストとトークンのローテーション方法を示しています。クローンが失敗した場合、セッションは原因を示すsession.errorイベントを受け取ります。プッシュを確認するには、Gitホスト上でブランチを探してください。サーバーのログは、ホストが拒否したプッシュに対してもokと表示します。

Webツールにはサーバー設定が必要

web_searchツールとweb_fetchツールはデフォルトで無効です。有効にするには、サーバーの設定ファイルに次を追加してください：

web_tools:
  enabled: true

この設定のみの場合、ホスト型サービスと同様に、各エージェント自身のドメインリストとコンテンツ制限が適用されます。

すべてのエージェントのツールを制限するには、web_tools.allowed_domains、web_tools.blocked_domains、またはweb_tools.max_content_tokensを設定してください。これらの設定はいずれも、ツールを有効にする効果もあります。サーバーは、これらの設定で許可される範囲を超えるものを求めるエージェントの保存を拒否します。たとえば、web_tools.allowed_domainsの範囲外のドメインを許可するエージェントや、より大きなコンテンツ制限を設定するエージェントは拒否されます。そのようなエージェントがすでに存在する場合、更新するまでセッションを開始できません。

ツールが無効な間、エージェントがどうなるかは、そのツールセット内のweb_searchとweb_fetchのエントリによって異なります：

どのWebツールが存在するかは推論プロバイダーによっても異なります。

推論プロバイダーによって異なる点

一部の機能は、サーバーのinference.provider設定の特定の値でのみ動作します。この表は、その他の値の場合に何が起こるかを示しています。これらのケースの一部ではエラーが返されません。

web_searchとweb_fetchの行は、Webツールを有効にした後に適用されます。それまでは、どちらのツールもどのプロバイダーでも動作しません。

anthropicの場合、サーバーはデフォルトでClaude APIのサーバーサイドフォールバックを要求します。これにより、安全性分類器がリクエストを拒否すると、別のClaudeモデル（性能が低い可能性があります）が応答することがあります。モデルはAnthropicが選択し、変更を報告するイベントはありませんが、セッションを読み取るとそのモデルのIDが表示されます。フォールバックを無効にするには、inference.model_fallback: falseを設定してください。その他のプロバイダーでは、そのようなリクエストは拒否としてターンを終了します。

各機能をサポートするモデルとリージョンについては、プロバイダーのドキュメントを参照してください。カスタムツール、MCPツール、ワーカーが実行するツールは、どのプロバイダーでも同じです。

高速モードを受け付けるモデル

デフォルトでは、サーバーのモデルカタログには、高速モードを受け付けるモデルとして、Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.6の4つのモデルが記載されています。Claude Opus 4.6では、Claude APIはリクエストを受け付けますが、標準速度で実行します。inference.providerの次の値は例外です：

• foundry： カタログにはClaude Opus 5.5のみが記載されています。
• format: vertex-raw-predictを指定したgateway： カタログにはどのモデルも記載されていません。
• vertex： カタログにはどのモデルも記載されておらず、どの設定でもこれは変更できません。

カタログの記載内容を変更するには、モデルエントリを参照してください。

すでにセルフホスト型サンドボックスを実行している場合

ワーカーのソフトウェアは同じなので、既存のワーカーをお使いのサーバーに接続できます。独自のワーカーを実行するでは、ポーリングするプロセスに設定する3つの値と、最初に変更すべき点を示しています。Webhookをきっかけに起動するワーカーは、ここでは動作しません。