Claude Platform Docs
Managed Agentsエンタープライズ設定

設定リファレンス

セルフホスト型Claude Managed Agentsサーバーの設定の配置場所を確認し、各設定のキー、環境変数、デフォルト、および目的を調べます。

このページでは、セルフホスト型Claude Managed Agentsサーバーの設定の配置場所を示し、設定を一覧にしています。機能をセットアップするには、シングルサインオン、エージェントアイデンティティと認証情報、推論プロバイダーを参照してください。

設定の配置場所

サーバーは、設定を1つのYAMLファイルから、認証情報を環境から読み取ります。

  • Docker Compose： ファイルは、展開したアーカイブ内のdocker-compose.ymlの隣にあるcompose.config.yamlです。これを編集してから、そのディレクトリでdocker compose restart cma-serverを実行します。
  • Kubernetes： ファイルは、サーバーHelmチャートのserver.config値です。valuesファイルで編集し、helm upgradeを実行してから、kubectl -n cma-server rollout restart deployment -l anthropic.com/role=serverを実行してサーバーを再起動します。Kubernetesにデプロイするを参照してください。

サーバーがセルフホスト型のページに記載された設定を拒否する場合は、サーバーをアップグレードしてください。アーカイブの最上位にあるcma-server.example.yamlには、一般的なキーの注記が記載されています。

認証情報はファイルには記述しません。サーバーは、認証情報を環境変数から、またはクラウドがホストに関連付けるアイデンティティから読み取ります。

Composeスタックに認証情報を渡す

Composeスタックでは、サーバーコンテナはdocker-compose.yml内のcma-serverサービスのenvironment:リストにある変数のみを受け取ります。別の変数を渡すには、次のようにします。

  1. その名前をリストに追加し、.envでその値を設定します。
  2. 認証情報がファイルの場合は、そのファイルをdocker-compose.ymlの隣に置き、docker-compose.yml内のx-server-mountsリストに- ./gcp-key.json:/etc/cma-server/gcp-key.json:roのような行を追加します。最初のコロンの後のパスは、コンテナ内でのファイルのパスです。そのパスを、.envでの変数の値として、またはファイルを指定する設定の値として使用します。
  3. docker compose up -dを実行します。再起動では.envは再読み込みされません。

アップグレードではdocker-compose.ymlが置き換えられるため、新しいリリースのスタックを起動する前に、そのリリースのファイルでこれらの編集を繰り返してください。

表の読み方

各設定には設定ファイル内のキーがあり、ほとんどの設定には環境変数もあります。変数はファイルより優先され、ファイルはデフォルトより優先されます。設定ファイルに不明なキーがある場合、サーバーは起動せず、エラーにそのキーの場所が示されます。

  • キー： キー内の各ドットは、ファイル内のネストの1レベルを表します。たとえば、server.addrはserverセクション内のaddrキーです。
  • 変数： 変数名はCMA_に続けてキーを大文字で記述したもので、各ドットは2つのアンダースコアに置き換えられます。
  • ファイルのみ： この設定には変数がありません。
  • 環境変数のみ： この設定がファイルにあると、サーバーは起動しません。
  • bedrockのみ、および同様のラベル： この設定は、そのプロバイダー、ストア、またはシークレットマネージャーでのみ機能します。別のものを使用しているときにこの設定を行うと、サーバーは起動しません。
  • リスト： リストは、ファイルではYAMLリスト、変数ではカンマ区切りの文字列です。
  • 期間： 期間は、30s、5m、1hのように単位付きの数値です。
  • 整数： 整数は符号、先頭のゼロ、アンダースコアを含まない数字のみです。

起動時、サーバーは設定した値とほとんどのデフォルト値を、それぞれの値の出所とともにログに記録します（例：server.addr=0.0.0.0:8400 (file)）。シークレットの代わりに***を記録しますが、サーバー自身が生成したサーバーAPIキーは例外です。

サーバーとログ

設定
環境変数		デフォルト説明
server.addr
CMA_SERVER__ADDR		127.0.0.1:8400サーバーがリッスンするアドレス。
server.api_key
CMA_SERVER__API_KEY		なしサーバーAPIキー。auth.refuse_server_api_keyがtrueでない限り、store.backend: postgresでは必須です。memoryでは、何も設定しない場合サーバーがキーを生成し、起動時にログに記録します。
server.id_marker
CMA_SERVER__ID_MARKER		localサーバーが作成する各IDのプレフィックスに続く部分。localではsesn_local_01…となり、noneではホスト型サービスと同様にsesn_01…となります。
server.shutdown_delay
CMA_SERVER__SHUTDOWN_DELAY		0s停止シグナルを受け取った後、「readiness probe」（レディネスプローブ）がnot_readyを返している間にサーバーがリクエストの処理を続ける時間。最大値は5mです。
server.max_connections
CMA_SERVER__MAX_CONNECTIONS		0server.addrでサーバーが同時に開いたままにする接続の最大数。0は無制限を意味します。上限に達すると、新しい接続は、別の接続が閉じるか、そのクライアントが断念するまで待機します。イベントストリーム、ワーカーのポーリング、ヘルスプローブはすべてカウントされます。Kubernetesでは、プローブの待機時間が長すぎるポッドをkubeletが再起動します。
logging.format
CMA_LOGGING__FORMAT		textログ形式。textまたはjsonです。
logging.level
CMA_LOGGING__LEVEL		infoサーバーがログに記録する最低レベル。値はdebug、info、warn、errorです。
logging.errors
CMA_LOGGING__ERRORS		false4xxおよび5xxレスポンスのエラーメッセージをログに含めるかどうか。メッセージにはクライアントが送信した値が引用される場合があります。
health.check_interval
CMA_HEALTH__CHECK_INTERVAL		60sレディネスプローブのために、サーバーが推論用の認証情報をチェックする頻度。最小値は5sです。
health.upstream_affects_readiness
CMA_HEALTH__UPSTREAM_AFFECTS_READINESS		true推論プロバイダーがサーバーの認証情報を拒否している間、レディネスプローブが503を返すかどうか。

データベース

この表のstore.backend以外のすべての設定は、store.backend: postgresの場合にのみ適用されます。

設定
環境変数		デフォルト説明
store.backend
CMA_STORE__BACKEND		memoryサーバーがデータを保持する場所。値は、再起動で消去されるmemoryと、postgresです。
store.database_url
CMA_STORE__DATABASE_URL		なしPostgreSQLの接続文字列。postgresでは必須です。
store.control_database_url
CMA_STORE__CONTROL_DATABASE_URL		store.database_urlの値ハートビートなど、サーバー自身の保守用接続に使用する接続文字列。
store.listen_database_url
CMA_STORE__LISTEN_DATABASE_URL		store.database_urlの値サーバーが通知をリッスンする1つの接続に使用する接続文字列。トランザクションモードの「connection pooler」（コネクションプーラー）では、この接続を扱えません。
store.migrate_database_url
CMA_STORE__MIGRATE_DATABASE_URL		store.database_urlの値サーバーのmigrateコマンドが使用する接続文字列。トランザクションモードのコネクションプーラーでは、この接続を扱えません。
store.pool_max_conns
CMA_STORE__POOL_MAX_CONNS		241つのサーバーのプールが開くデータベース接続の最大数。最小値は4です。
store.event_poll_interval
CMA_STORE__EVENT_POLL_INTERVAL		25ms各サーバーが、そのクライアントがストリーミングしているセッションの最新イベントをデータベースに問い合わせる頻度。別のサーバーが記録したイベントは、最大でおよそこの時間待ってからストリームに届きます。
store.credentials_encryption_key
CMA_STORE__CREDENTIALS_ENCRYPTION_KEY
環境変数のみ		なしデータベースに保存される認証情報を暗号化するキー。base64形式の32ランダムバイトで指定します。Docker ComposeおよびKubernetesのインストールではこれが設定されます。store.allow_unencrypted_credentialsがtrueでない限り、これがないとサーバーは起動しません。
store.allow_unencrypted_credentials
CMA_STORE__ALLOW_UNENCRYPTED_CREDENTIALS		falseサーバーがstore.credentials_encryption_keyなしで起動できるかどうか。キーがない場合、サーバーは認証情報をデータベースに平文で保存します。git.allowed_hostnamesにホストが記載されている場合、またはDocker ComposeやサーバーHelmチャートでインストールする場合、trueは効果がありません。
store.credentials_encryption_keys_retiring
CMA_STORE__CREDENTIALS_ENCRYPTION_KEYS_RETIRING
環境変数のみ		なしキーのローテーション中にサーバーが引き続き復号に使用できる以前の暗号化キー。この設定にはstore.credentials_encryption_keyが必要です。

推論プロバイダー

プロバイダーのセットアップについては、推論プロバイダーを参照してください。

設定
環境変数		デフォルト説明
inference.provider
CMA_INFERENCE__PROVIDER		anthropicサーバーがモデル呼び出しを送信する先。値はanthropic、bedrock、vertex、foundry、gatewayです。
inference.headers
ファイルのみ		なしサーバーがすべてのモデル呼び出しに追加するリクエストヘッダー。ヘッダー名から値へのマップで指定します。すべての値を引用符で囲んでください。trueや0042のように、YAMLがテキストとして読み取らない引用符なしの値があると、サーバーは起動を拒否します。gatewayでは、値に{ from: request_id }または{ from: session_id }も指定できます。
inference.model_fallback
CMA_INFERENCE__MODEL_FALLBACK		trueanthropicのみ。モデル呼び出しでサーバー側フォールバックを要求するかどうか。これらの呼び出しにはfallbacksフィールドとヘッダーanthropic-beta: server-side-fallback-2026-07-01が含まれます。ANTHROPIC_BASE_URLで指定したプロキシが、このフィールドまたはヘッダーを拒否する場合があります。プロキシが400または422で応答した場合、サーバーはそれらを除いて呼び出しを再送信します。
inference.metadata.user_id
CMA_INFERENCE__METADATA__USER_ID		なしanthropicおよびfoundryのみ、またはformat: anthropic-messagesを指定したgateway。サーバーがすべてのモデル呼び出しでmetadata.user_idとして送信する1つの識別子。起動ログに出力されます。この設定がない場合、サーバーはラベルcma-serverを送信します。metadata.user_idをオフにすることはできません。プロバイダーまたはプロキシがこれを拒否した場合、すべてのモデル呼び出しが失敗します。ネットワーク外に送信されるものを参照してください。

クラウドプロバイダー

設定
環境変数		デフォルト説明
inference.region
CMA_INFERENCE__REGION		なしbedrockおよびvertexのみ。AWSリージョン、またはGoogle Cloud’s Agent Platformのロケーション。vertexでは必須です。これがない場合、bedrockはAWS SDKのデフォルトチェーンが見つけたリージョンを使用します。
inference.project_id
CMA_INFERENCE__PROJECT_ID		なしvertexのみ。呼び出しが行われるGoogle Cloudプロジェクト。Googleの認証情報がプロジェクトを指定していない限り必須です。
inference.api
CMA_INFERENCE__API		invoke_modelbedrockのみ。呼び出しを伝送するAmazon Bedrock API。invoke_modelまたはmessagesです。messagesはClaude in Amazon Bedrock（bedrock-mantle）で説明されているエンドポイントです。これを使用する場合、サーバーのAWSロールにはbedrock:InvokeModelとbedrock:InvokeModelWithResponseStreamの代わりにbedrock-mantle:CreateInferenceが必要です。
inference.list_models
CMA_INFERENCE__LIST_MODELS		truebedrockのみ。サーバーがAmazon BedrockのClaudeモデルのリストを読み取るかどうか。これらのリストにより、エージェントはサーバーのリリース後に登場したモデルを使用できます。
inference.model_id_prefix
CMA_INFERENCE__MODEL_ID_PREFIX		us.anthropic.bedrockのみ。サーバーが各モデルIDの前に付加するテキスト。inference.api: messagesでは、デフォルトはanthropic.です。
inference.model_id_overrides
ファイルのみ		なしbedrock、vertex、foundryのみ。モデルIDからプロバイダーが期待する正確なIDへのマップ。foundryでは、そのIDはデプロイメント名です。
inference.foundry.resource
CMA_INFERENCE__FOUNDRY__RESOURCE		なしfoundryのみ。Foundryリソースの名前。これかinference.foundry.base_urlのどちらか一方を設定し、両方は設定しないでください。
inference.foundry.base_url
CMA_INFERENCE__FOUNDRY__BASE_URL		なしfoundryのみ。デフォルトでは、呼び出しはhttps://<resource>.services.ai.azure.com/anthropicに送信されます。プロキシなど別のアドレスでリソースにアクセスするには、代わりにそのURLをここに設定します。URLは/anthropicで終わります。

モデルゲートウェイ

これらの設定はinference.provider: gatewayの場合にのみ適用されます。モデルゲートウェイを参照してください。

設定
環境変数		デフォルト説明
inference.gateway.url
CMA_INFERENCE__GATEWAY__URL		なし必須。モデル呼び出しを受け取るURL。bedrock-invokeおよびvertex-raw-predictでは、{model}がモデルIDの入る位置を示します。vertex-raw-predictでは、URLは/{model}:rawPredictで終わる必要があります。
inference.gateway.format
CMA_INFERENCE__GATEWAY__FORMAT		なし必須。ゲートウェイが受け付けるリクエスト形式。bedrock-invoke、anthropic-messages、またはvertex-raw-predictです。
inference.gateway.model_map
ファイルのみ		なし必須。エージェントが指定できる各モデルIDから、ゲートウェイが期待するIDへのマップ。inference.headersと同様に、すべての値を引用符で囲んでください。
inference.gateway.streaming
CMA_INFERENCE__GATEWAY__STREAMING		falseサーバーがその形式のストリーミング呼び出しを送信するかどうか。有効にすると、モデルが生成するにつれて応答が届きます。bedrock-invokeでは、その呼び出しは-with-response-streamを末尾に付加した同じURLに送信されます。vertex-raw-predictでは、その呼び出しは:rawPredictの代わりに:streamRawPredictを含む同じURLに送信されます。inference.gateway.urlには:rawPredictを残してください。
inference.credentials.supplier
CMA_INFERENCE__CREDENTIALS__SUPPLIER		なし必須。ゲートウェイの認証情報の取得元。envは1つの長期間有効なキーを意味し、oauth_exchangeは短期間有効なトークンを意味し、azureはサーバー自身のAzureアイデンティティに発行されたMicrosoft Entra IDトークンを意味します。
inference.credentials.env.var
CMA_INFERENCE__CREDENTIALS__ENV__VAR		なしenvでは必須。キーを保持する環境変数の名前。
inference.credentials.azure.scope
CMA_INFERENCE__CREDENTIALS__AZURE__SCOPE		なしazureでは必須。サーバーがトークンを要求するスコープ。ゲートウェイのアプリ登録のアプリケーションID URIまたはアプリケーションIDの後に/.defaultを付けたものです。
inference.credentials.send_as.header
CMA_INFERENCE__CREDENTIALS__SEND_AS__HEADER		Authorization認証情報を伝送するリクエストヘッダー。
inference.credentials.send_as.scheme
CMA_INFERENCE__CREDENTIALS__SEND_AS__SCHEME		Bearerヘッダー内で認証情報の前に置かれる語。Authorization以外のヘッダーでは、デフォルトはスキームなしです。
inference.credentials.renew_before
CMA_INFERENCE__CREDENTIALS__RENEW_BEFORE		90soauth_exchangeで、サーバーがトークンをどれだけ早く置き換えるか。サーバーは、キャッシュ済みトークンの有効期限のこの時間前にその使用を停止し、次のモデル呼び出しのために別のトークンを取得します。値はトークンの有効期間より小さくしてください。有効期間がこの値未満のトークンは、サーバーが拒否します。

短期間有効なゲートウェイトークン

これらの設定はinference.credentials.supplier: oauth_exchangeの場合にのみ適用されます。短期間有効なトークンを参照してください。exchange設定はグループとして任意です。これらがない場合、サーバーはコールバックが返したものをゲートウェイに送信します。

設定
環境変数		デフォルト説明
inference.credentials.assertion.url
CMA_INFERENCE__CREDENTIALS__ASSERTION__URL		なし必須。署名付きアサーションを返すHTTPコールバックのURL。
inference.credentials.assertion.auth.type
CMA_INFERENCE__CREDENTIALS__ASSERTION__AUTH__TYPE		なし必須。サーバーがコールバックに対して認証する方法。mtlsまたはbearer_fileです。
inference.credentials.assertion.auth.cert_file
CMA_INFERENCE__CREDENTIALS__ASSERTION__AUTH__CERT_FILE		なしmtlsでは必須。サーバーのクライアント証明書のパス。
inference.credentials.assertion.auth.key_file
CMA_INFERENCE__CREDENTIALS__ASSERTION__AUTH__KEY_FILE		なしmtlsでは必須。クライアント証明書の秘密鍵のパス。
inference.credentials.assertion.auth.token_file
CMA_INFERENCE__CREDENTIALS__ASSERTION__AUTH__TOKEN_FILE		なしbearer_fileでは必須。ベアラートークンを保持するファイルのパス。
inference.credentials.assertion.auth.ca_file
CMA_INFERENCE__CREDENTIALS__ASSERTION__AUTH__CA_FILE		なしサーバーがコールバックに対して信頼する認証局を含むPEMファイルのパス。
inference.credentials.assertion.forward_metadata
CMA_INFERENCE__CREDENTIALS__ASSERTION__FORWARD_METADATA		なしサーバーがその値をコールバックに送信するセッションメタデータのキー。これらはリクエスト本文のsession.metadataとして届きます。値はAPI呼び出し元が書き込んだものそのままなので、自身の記録と照合してください。
inference.credentials.exchange.token_url
CMA_INFERENCE__CREDENTIALS__EXCHANGE__TOKEN_URL		なし交換を行う場合は必須。サーバーがアサーションをトークンと交換するOAuthトークンエンドポイント。
inference.credentials.exchange.grant_type
CMA_INFERENCE__CREDENTIALS__EXCHANGE__GRANT_TYPE		なし交換を行う場合は必須。サーバーが送信するgrant_type（例：urn:ietf:params:oauth:grant-type:jwt-bearer）。
inference.credentials.exchange.encoding
CMA_INFERENCE__CREDENTIALS__EXCHANGE__ENCODING		formサーバーが交換リクエストをエンコードする方法。formまたはmultipartです。
inference.credentials.exchange.expiry
CMA_INFERENCE__CREDENTIALS__EXCHANGE__EXPIRY		expires_inサーバーがトークンの有効期間を読み取る場所。expires_inは、レスポンスのexpires_inとトークンのexpクレームのうち早いほうを意味します。jwt_expはexpクレームのみを意味します。
inference.credentials.exchange.headers
ファイルのみ		なしトークンエンドポイント用の追加リクエストヘッダー。ヘッダー名から値へのマップで指定します。inference.headersと同様に、すべての値を引用符で囲んでください。
inference.credentials.exchange.ca_file
CMA_INFERENCE__CREDENTIALS__EXCHANGE__CA_FILE		なしサーバーがトークンエンドポイントに対して信頼する認証局を含むPEMファイルのパス。

シングルサインオン

サインインのセットアップについては、シングルサインオンを参照してください。

設定
環境変数		デフォルト説明
auth.issuers
ファイルのみ		なしサーバーがトークンを受け付けるOpenID Connect発行者。発行者エントリを参照してください。
auth.refuse_server_api_key
ファイルのみ		falseサーバーがすべてのルートでサーバーAPIキーを拒否するかどうか。trueには少なくとも1つの発行者が必要です。その場合、キーを受け取るすべての管理CLIコマンドは失敗します。

発行者エントリ

auth.issuersの各エントリは、次のフィールドを受け取ります。

フィールドデフォルト説明
nameなし必須。ログ行における発行者のラベル。サーバーはこれを各リソースの作成者の一部としても記録します。
issuer_urlなし必須。発行者のURL。そのトークンのissクレームと完全に一致させます。サーバーは、このホストと、発行者のディスカバリードキュメントが指定するjwks_uriのホストから署名鍵を取得します。ネットワークで送信接続を制限している場合は、両方のホストを許可してください。
audiencesなし必須。トークンのaudクレームが持つことのできる値。アプリケーションがすでに保持しているトークンを転送する場合は、各アプリケーションのクライアントIDを列挙してください。
rolesなしgroupとroleのペアのリスト。グループは完全一致で、または*が任意の文字列、?が1文字を表すパターンとして一致します。ロールはadmin、developer、またはuserです。一致するロールのうち最も高いものが適用されます。roles、default_role、またはその両方を設定してください。
default_roleなしグループがどのrolesエントリにも一致しない呼び出し元のロール。このオーディエンスのトークンを取得できる全員がアクセス権を持つべき場合にのみ設定してください。
subject_claimsub呼び出し元を識別するクレーム。/で始まる名前は、ネストされたクレームへのJSON Pointerです。
stable_subjectfalsesubject_claimがsubまたはoid以外のクレームを指定する場合にのみ適用されます。プロバイダーがある人物のそのクレームの値を変更せず、他の人に割り当てることもないことを確認するには、trueを設定します。サーバーはこれをチェックしません。falseの場合、エージェントトークンはactor_subおよびactor_issクレームを省略します。
groups_claimgroups呼び出し元のグループを列挙するクレーム。/で始まる名前は、ネストされたクレームへのJSON Pointerです。
jwks_fileなしJSON Web Key Setファイルのパス。サーバーはここから署名鍵を読み取り、発行者には一切接続しません。
login_client_idなしターミナルログインが使用するアプリケーションのクライアントID。これを設定できる発行者は1つだけです。
login_scopes[openid]ログインが要求するスコープ。このフィールドにはlogin_client_idが必要です。

シークレットマネージャー

ストアのセットアップについては、シークレットマネージャーを参照してください。

設定
環境変数		デフォルト説明
secret_store.type
CMA_SECRET_STORE__TYPE		なしボールトの認証情報を保持するシークレットマネージャー。値はaws_secrets_manager、gcp_secret_manager、azure_key_vault、hashicorp_vaultです。これがない場合、ボールトの認証情報はデータベースに残ります。
secret_store.prefix
CMA_SECRET_STORE__PREFIX		なしsecret_store.typeを使用する場合は必須。サーバーが作成するすべてのシークレットの名前の先頭部分。aws_secrets_managerとhashicorp_vaultでは/、gcp_secret_managerでは-または_、azure_key_vaultでは-で終わる必要があります。
secret_store.region
CMA_SECRET_STORE__REGION		なしaws_secrets_managerのみで、その場合は必須。シークレットを保持するAWSリージョン。
secret_store.project
CMA_SECRET_STORE__PROJECT		なしgcp_secret_managerのみで、その場合は必須。シークレットを保持するGoogle CloudプロジェクトのID。
secret_store.vault_url
CMA_SECRET_STORE__VAULT_URL		なしazure_key_vaultのみで、その場合は必須。キーボールトのURL（例：https://my-vault.vault.azure.net）。

HashiCorp Vault

これらの設定はsecret_store.type: hashicorp_vaultの場合にのみ適用されます。ログイン方法はtoken_file、kubernetes、approleのいずれか1つだけを設定してください。

設定
環境変数		デフォルト説明
secret_store.address
CMA_SECRET_STORE__ADDRESS		なし必須。Vaultサーバーのhttps:// URL。
secret_store.namespace
CMA_SECRET_STORE__NAMESPACE		なしマウントとログイン方法を保持するVault Enterpriseのネームスペース。
secret_store.mount
CMA_SECRET_STORE__MOUNT		secretKVバージョン2シークレットエンジンのパス。
secret_store.ca_cert_file
CMA_SECRET_STORE__CA_CERT_FILE		なしVaultの証明書に署名した認証局を含むPEMファイルのパス。
secret_store.token_file
CMA_SECRET_STORE__TOKEN_FILE		なしVault Agentなどの別のプロセスが最新の状態に保つVaultトークンを含むファイルのパス。
secret_store.kubernetes.role
CMA_SECRET_STORE__KUBERNETES__ROLE		なしkubernetesでは必須。サーバーがログインに使用するVaultロール。これをサーバーのサービスアカウントにバインドしてください。
secret_store.kubernetes.mount_path
CMA_SECRET_STORE__KUBERNETES__MOUNT_PATH		kubernetesVaultがKubernetesログイン方法をマウントする場所。
secret_store.kubernetes.service_account_token_file
CMA_SECRET_STORE__KUBERNETES__SERVICE_ACCOUNT_TOKEN_FILE		/var/run/secrets/kubernetes.io/serviceaccount/tokenサーバーが各ログイン時に提示するサービスアカウントトークンのパス。
secret_store.approle.role_id
CMA_SECRET_STORE__APPROLE__ROLE_ID		なしapproleでは必須。サーバーがログインに使用するAppRoleロールのID。
secret_store.approle.secret_id_file
CMA_SECRET_STORE__APPROLE__SECRET_ID_FILE		なしapproleでは必須。ロールのsecret_idを含むファイルのパス。
secret_store.approle.mount_path
CMA_SECRET_STORE__APPROLE__MOUNT_PATH		approleVaultがAppRoleログイン方法をマウントする場所。

エージェントアイデンティティ

エージェントトークンのセットアップについては、エージェントアイデンティティを参照してください。この表のいずれかの設定を行うと、この機能が有効になります。その場合、サーバーにはagent_identity.issuerと、署名鍵の場所としてkey_file、key_secret、kms_keyのいずれか1つだけが必要です。

設定
環境変数		デフォルト説明
agent_identity.issuer
CMA_AGENT_IDENTITY__ISSUER		なしエージェントトークンがissクレームとして持つhttps:// URL。
agent_identity.key_file
CMA_AGENT_IDENTITY__KEY_FILE		なしトークンに署名するPEM秘密鍵のパス。
agent_identity.key_secret
CMA_AGENT_IDENTITY__KEY_SECRET		なしシークレットマネージャー内でPEM秘密鍵を保持するシークレットの名前（secret_store.prefixを除く）。
agent_identity.kms_key.provider
CMA_AGENT_IDENTITY__KMS_KEY__PROVIDER		なし署名鍵を保持する鍵管理サービス。aws_kmsまたはgcp_kmsです。
agent_identity.kms_key.key
CMA_AGENT_IDENTITY__KMS_KEY__KEY		なしkms_key.providerを使用する場合は必須。aws_kmsでは鍵のARN、gcp_kmsでは1つの鍵バージョンのリソース名です。
agent_identity.published_key_files
CMA_AGENT_IDENTITY__PUBLISHED_KEY_FILES		なし鍵セット用の追加のPEM公開鍵のパス。サーバーはこれらの鍵を公開しますが、これらで署名することはありません。署名鍵をローテーションするときにこの設定を使用します。
agent_identity.token_lifetime
CMA_AGENT_IDENTITY__TOKEN_LIFETIME		5mトークンのiatクレームからexpクレームまでの時間。すでに送信されたトークンは、そのexpまで有効です。最小値はlimits.mcp_call_timeoutに1mを加えた値で、最大値は15mです。
agent_identity.jwks_uri
CMA_AGENT_IDENTITY__JWKS_URI		<issuer>/.well-known/jwks.json発行者のディスカバリードキュメントが鍵セットとして示すURL。発行者URL配下以外の場所で鍵セットをホストする場合にのみ設定してください。
agent_identity.direct.audiences
ファイルのみ		なしトークンを取得できる受信者。各エントリには、audience URLと、その受信者のMCPサーバーのURLプレフィックスであるurlsがあります。
agent_identity.actor.enabled
CMA_AGENT_IDENTITY__ACTOR__ENABLED		trueサーバーがツール呼び出しのトークンにactor_subおよびactor_issクレームを追加するかどうか。actor_subは、セッションを作成した呼び出し元のサブジェクトです。actor_issは、呼び出し元がサインインに使用したauth.issuersエントリのissuer_urlです。どちらのクレームも、呼び出し元がその呼び出しを承認したことを意味するものではありません。

エグレスゲートウェイ

ゲートウェイのセットアップについては、環境変数の認証情報を参照してください。この表のその他の設定は、egress.gateway_enabled: trueの場合にのみ設定してください。これがない場合、いずれかが設定されているとサーバーは起動しません。

設定
環境変数		デフォルト説明
egress.gateway_enabled
CMA_EGRESS__GATEWAY_ENABLED		falseサーバーがエグレスゲートウェイと連携し、environment_variableのボールト認証情報を受け付けるかどうか。
egress.allowed_hostnames
CMA_EGRESS__ALLOWED_HOSTNAMES		なしサンドボックスがゲートウェイ経由でアクセスできる、完全一致の公開ホスト名。api.example.comのようにポートのないエントリは、https URLではポート443、http URLではポート80を許可します。api.example.com:8443のようにポート付きのエントリは、そのポートのみを許可します。
egress.swap_header_names
CMA_EGRESS__SWAP_HEADER_NAMES		Authorizationゲートウェイが認証情報の値を入れることができるリクエストヘッダー。独自のリストはデフォルトを置き換えるため、そのリストにAuthorizationを含めてください。
egress.gateway_listen
CMA_EGRESS__GATEWAY_LISTEN		:8410ゲートウェイのみにサービスを提供する、サーバーの2番目のリスナーのアドレス。デフォルトではすべてのインターフェースでリッスンします。
egress.gateway_key_file
CMA_EGRESS__GATEWAY_KEY_FILE		なし必須。ゲートウェイがサーバーに提示するキーを含むファイルのパス。
egress.ca_cert_file
CMA_EGRESS__CA_CERT_FILE		なし必須。ゲートウェイの認証局のPEM証明書のパス。
egress.gateway_proxy_address
CMA_EGRESS__GATEWAY_PROXY_ADDRESS		なし必須。サンドボックスがゲートウェイのプロキシポートにアクセスするhost:port。

MCPサーバー

MCPサーバーには許可リストのエントリが必要を参照してください。

設定
環境変数		デフォルト説明
mcp.allowed_hostnames
CMA_MCP__ALLOWED_HOSTNAMES		なしサーバーが接続できるMCPサーバーの完全一致のホスト名。これがない場合、サーバーはどこにも接続しません。
mcp.private_hostnames
ファイルのみ		なしmcp.allowed_hostnamesのうち、プライベートアドレスに解決される可能性のあるホスト名。
mcp.max_result_bytes
CMA_MCP__MAX_RESULT_BYTES		102400（100 KiB）1つのMCPツール結果のうち、モデルが参照する最大バイト数。最小値は1024です。

Gitリポジトリ

Gitリポジトリには許可リストのエントリが必要を参照してください。

設定
環境変数		デフォルト説明
git.allowed_hostnames
CMA_GIT__ALLOWED_HOSTNAMES		なしセッションのリポジトリが置かれることのできるGitホスト。ホスト名はワイルドカードなしで完全一致し、エントリはそのサブドメインを対象としません。エントリは、ポート443、またはgit.example.com:8443のようにエントリが指定する1つのポートを許可します。この設定がない場合、サーバーはリポジトリを受け付けません。
git.private_hostnames
ファイルのみ		なしgit.allowed_hostnamesのうち、プライベートアドレスに解決されるホスト名。ポートなしで記述します。その他のホスト名については、サーバーはそのパブリックアドレスにのみ接続します。
git.allowed_push_refs
CMA_GIT__ALLOWED_PUSH_REFS		なしエージェントがプッシュできるブランチ（それぞれrefs/heads/配下）。/で終わるエントリは、その配下のすべてのブランチを許可します。その他のエントリは、その1つのブランチを許可します。この設定がない場合、エージェントはプッシュできません。
git.commit_author_name
CMA_GIT__COMMIT_AUTHOR_NAME		Claudeエージェントのコミットの作成者名。git.commit_author_emailと一緒に設定してください。
git.commit_author_email
CMA_GIT__COMMIT_AUTHOR_EMAIL		noreply@anthropic.comエージェントのコミットの作成者メールアドレス。git.commit_author_nameと一緒に設定してください。
git.max_concurrent_transfers
CMA_GIT__MAX_CONCURRENT_TRANSFERS		321つのサーバーが同時に処理するGitリクエストの最大数。最小値は1です。
git.max_session_transfer_bytes
CMA_GIT__MAX_SESSION_TRANSFER_BYTES		8589934592（8 GiB）1つのサーバーが1つのセッションのために処理するGitトラフィックの最大量（バイト単位、アップロードとダウンロードの合計）。カウントは、サンドボックスがセッションを引き継ぐたびにゼロから再開します。上限に達すると、サーバーはそのセッションの以降のGitリクエストを403で拒否します。0は無制限を意味します。それ以外の場合、最小値は1048576です。
git.max_push_bytes
CMA_GIT__MAX_PUSH_BYTES		2147483648（2 GiB）1回のプッシュで送信できる最大バイト数。最小値は1048576です。

Gitリポジトリには次の制限が適用されます。

  • プロトコル： サーバーはSSHやGit LFSをサポートしておらず、名前が変更されたリポジトリのリダイレクトなど、リダイレクトを拒否します。
  • トークン： Gitホストは、ユーザー名x-access-tokenでのHTTP Basic認証のパスワードとしてトークンを受け付ける必要があります。
  • URL： リポジトリURLには1つのオーナーと1つのリポジトリ名しか含まれないため、GitLabのサブグループ内のリポジトリは使用できません。
  • ホスト： git.allowed_hostnamesに記載されていないホスト上のURLに対しては、サーバーは400を返します。エラーメッセージには、他のホストを記載していても、URLはgithub.com上にある必要があると示されます。
  • プッシュ： サーバーは、ブランチを削除するプッシュや、タグなどブランチ以外のものを変更するプッシュを常に拒否します。

Webツールとスキル

Webツールにはサーバー設定が必要を参照してください。

設定
環境変数		デフォルト説明
web_tools.enabled
CMA_WEB_TOOLS__ENABLED		falseエージェントがweb_searchおよびweb_fetchツールを使用できるかどうか。別のweb_tools設定を行った場合、デフォルトはtrueになります。
web_tools.allowed_domains
CMA_WEB_TOOLS__ALLOWED_DOMAINS		なしエージェントがWebツールで読み取れる唯一のドメイン。エントリはそのサブドメインも対象とします。
web_tools.blocked_domains
CMA_WEB_TOOLS__BLOCKED_DOMAINS		なしどのエージェントもWebツールで読み取れないドメイン。これかweb_tools.allowed_domainsのどちらか一方を設定し、両方は設定しないでください。
web_tools.max_content_tokens
CMA_WEB_TOOLS__MAX_CONTENT_TOKENS		なしweb_fetchが取得した1ページのうち、モデルに返す最大トークン数。
skills.max_name_chars
CMA_SKILLS__MAX_NAME_CHARS		64SKILL.mdファイルに指定できるnameの最大長。最大値は255です。
skills.max_description_chars
CMA_SKILLS__MAX_DESCRIPTION_CHARS		1024SKILL.mdファイルに指定できるdescriptionの最大長。

制限、タイムアウト、スケジューリング

設定
環境変数		デフォルト説明
limits.max_active_sessions
CMA_LIMITS__MAX_ACTIVE_SESSIONS		64store.backend: memoryのみ。同時にターンを実行するセッションの最大数。0は無制限を意味します。
limits.max_live_subagent_threads
CMA_LIMITS__MAX_LIVE_SUBAGENT_THREADS		251つのセッションが同時に保持できるサブエージェントスレッドの最大数。スレッドはアーカイブまたは終了されるまでカウントされるため、アイドル状態のスレッドもカウントされます。上限に達すると、エージェントは別のサブエージェントを開始できません。最小値は1、最大値は4000です。
scheduler.max_concurrent_turns
CMA_SCHEDULER__MAX_CONCURRENT_TURNS		64store.backend: postgresのみ。1つのサーバーが同時に実行するターンの最大数。最小値は1です。サーバーは、サブエージェントのターン専用の追加スロットを確保します。その数はこの値の4分の1で、最低でも4です。デフォルトでは、1つのサーバーで64ターンに加えて16のサブエージェントターンを実行できます。
scheduler.claim_poll_interval
CMA_SCHEDULER__CLAIM_POLL_INTERVAL		1sstore.backend: postgresのみ。空きターンスロットのあるサーバーが、待機中の作業をデータベースで探す頻度。最小値は50msです。
scheduler.sandbox_claim
CMA_SCHEDULER__SANDBOX_CLAIM		immediateワーカーがセッションのサンドボックスを開始できるタイミング。immediateはセッションが作成されるとすぐを意味するため、最初のツール呼び出しの待機時間が最も短くなります。tool_callは、サンドボックスを必要とするセッションの最初のツール呼び出し時を意味するため、そのような呼び出しを行わないセッションはサンドボックスを使用しません。
limits.model_call_timeout
CMA_LIMITS__MODEL_CALL_TIMEOUT		20mサーバーがキャンセルするまでに、1回のモデル呼び出しがリトライを含めて実行できる時間。
limits.stream_idle_timeout
CMA_LIMITS__STREAM_IDLE_TIMEOUT		5mサーバーがその試行を断念するまでに、モデル呼び出しのレスポンスが何も返さずにいられる時間。
limits.mcp_call_timeout
CMA_LIMITS__MCP_CALL_TIMEOUT		4mサーバーが断念するまでに、1回のMCPツール呼び出しが実行できる時間。

モデルとコンパクション

設定
環境変数		デフォルト説明
models.settings
ファイルのみ		なしサーバーの組み込みモデルカタログへの変更。モデルIDをキーとします。モデルエントリを参照してください。
compaction.triggers
ファイルのみ		各モデルのコンテキストウィンドウの約90%モデル上のターンが履歴をコンパクションするコンテキストサイズ（トークン単位）。モデルIDをキーとします。最小値は50000です。各モデルはコンパクションをサポートしている必要があります。

モデルエントリ

models.settingsの各エントリは、カタログ内のモデルを変更するか、モデルを追加します。カタログ内のモデルの場合、省略したフィールドは組み込みの値を保持します。

フィールド説明
fast_supportedモデルがspeed: "fast"を受け付けるかどうか。追加するモデルでは必須です。
inference_geo_supportedモデルがinference_geoを受け付けるかどうか。
forced_tool_choice_supportedモデルが、1つのツールの呼び出しを強制するリクエストを受け付けるかどうか。サーバーがこのようなリクエストを送信するのは、承認されたweb_searchまたはweb_fetch呼び出しを実行する場合のみです。falseの場合、サーバーはこのモデルでツールを強制しません。
effort_supportedモデルがeffortレベルを受け付けるかどうか。
effort_levelsモデルが受け付けるeffortレベル。low、medium、high、xhigh、maxから選びます。組み込みのレベルがないモデルでeffort_supported: trueを指定する場合は必須です。
effort_defaultエージェントがeffortレベルを指定しないセッションのeffortレベル。effort_levelsのいずれかである必要があります。組み込みのデフォルトがないモデルでeffort_supported: trueを指定する場合は必須です。
thinkingサーバーが要求する思考モード。enabledまたはadaptiveです。
thinking_budgetthinking: enabledの場合にサーバーが送信する思考予算（トークン単位）。
max_tokens各モデル呼び出しのmax_tokens値。

サーバー上のコンソール

設定
環境変数		デフォルト説明
console.serve
CMA_CONSOLE__SERVE		trueサーバー上のコンソールを提供するかどうか。

このページは役に立ちましたか？