{ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://claude.com/docs/cowork/3p/schemas/bootstrap-config-v2.schema.json", "$ref": "#/definitions/BootstrapConfig", "definitions": { "BootstrapConfig": { "type": "object", "properties": { "$schemaVersion": { "description": "Marks the nested v2 wire format. Optional — a response carrying any cluster key is sniffed as v2 regardless — but setting it explicitly is the documented version marker and is what the app's own JSON export writes.", "type": "number", "const": 2 }, "expiresAt": { "description": "Unix epoch (seconds or milliseconds) after which the client should re-fetch this document. Optional; when absent the client uses its default refresh interval.", "type": "number", "exclusiveMinimum": 0 }, "inference": { "oneOf": [ { "type": "object", "properties": { "provider": { "type": "string", "const": "gateway" }, "baseUrl": { "type": "string", "format": "uri", "title": "Gateway base URL" }, "customHeaders": { "title": "Custom inference headers", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "sessionLifetimeSec": { "title": "Sign-in session lifetime", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "credential": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "static" }, "apiKey": { "type": "string", "title": "Gateway API key" }, "authScheme": { "title": "Gateway auth scheme", "default": "bearer", "type": "string", "enum": [ "bearer", "x-api-key" ] } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "interactive" }, "authFlow": { "type": "string", "enum": [ "browser", "broker" ], "title": "Gateway sign-in flow" }, "oidc": { "type": "object", "properties": { "clientId": { "type": "string", "minLength": 1 }, "issuer": { "type": "string", "format": "uri" }, "authorizationUrl": { "type": "string", "format": "uri" }, "tokenUrl": { "type": "string", "format": "uri" }, "bearerTokenType": { "default": "id_token", "type": "string", "enum": [ "id_token", "access_token" ] }, "scopes": { "type": "string", "minLength": 1 }, "appendOfflineAccess": { "default": true, "type": "boolean" }, "resource": { "type": "string", "format": "uri" }, "redirectPort": { "type": "integer", "minimum": 1024, "maximum": 65535 }, "additionalRedirectReferrerHosts": { "type": "string" } }, "required": [ "clientId" ], "title": "Gateway SSO IdP (OIDC)" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "helper-script" }, "command": { "title": "Helper script", "type": "string" }, "ttlSec": { "title": "Helper script TTL", "default": 3600, "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "timeoutSec": { "title": "Credential helper timeout", "default": 60, "type": "integer", "exclusiveMinimum": 0, "maximum": 600 }, "silentRefreshEnabled": { "title": "Re-run helper for silent refresh", "default": true, "type": "boolean" }, "awsEnv": { "type": "object", "properties": { "profile": { "type": "string", "title": "AWS profile name" }, "awsDir": { "type": "string", "title": "AWS config directory" }, "awsCliPath": { "type": "string", "title": "AWS CLI path" }, "region": { "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$", "title": "AWS region" } } }, "authScheme": { "title": "Gateway auth scheme", "default": "bearer", "type": "string", "enum": [ "bearer", "x-api-key" ] } }, "required": [ "kind" ] } ] } }, "required": [ "provider" ] }, { "type": "object", "properties": { "provider": { "type": "string", "const": "anthropic" }, "customHeaders": { "title": "Custom inference headers", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "sessionLifetimeSec": { "title": "Sign-in session lifetime", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "credential": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "static" }, "apiKey": { "type": "string", "title": "Claude API key" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "interactive" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "helper-script" }, "command": { "title": "Helper script", "type": "string" }, "ttlSec": { "title": "Helper script TTL", "default": 3600, "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "timeoutSec": { "title": "Credential helper timeout", "default": 60, "type": "integer", "exclusiveMinimum": 0, "maximum": 600 }, "silentRefreshEnabled": { "title": "Re-run helper for silent refresh", "default": true, "type": "boolean" }, "awsEnv": { "type": "object", "properties": { "profile": { "type": "string", "title": "AWS profile name" }, "awsDir": { "type": "string", "title": "AWS config directory" }, "awsCliPath": { "type": "string", "title": "AWS CLI path" }, "region": { "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$", "title": "AWS region" } } } }, "required": [ "kind" ] } ] } }, "required": [ "provider" ] }, { "type": "object", "properties": { "provider": { "type": "string", "const": "bedrock" }, "region": { "title": "AWS region", "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$" }, "baseUrl": { "title": "Bedrock base URL", "type": "string", "format": "uri" }, "serviceTier": { "type": "string", "enum": [ "flex", "priority" ], "title": "Bedrock service tier" }, "customHeaders": { "title": "Custom inference headers", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "sessionLifetimeSec": { "title": "Sign-in session lifetime", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "credential": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "static" }, "bearerToken": { "type": "string", "title": "AWS bearer token" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "interactive" }, "ssoStartUrl": { "type": "string", "format": "uri", "title": "AWS SSO start URL" }, "ssoRegion": { "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$", "title": "AWS SSO region" }, "ssoAccountId": { "type": "string", "minLength": 1, "title": "AWS SSO account ID" }, "ssoRoleName": { "type": "string", "minLength": 1, "title": "AWS SSO role name" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "vendor-profile" }, "profile": { "type": "string", "title": "AWS profile name" }, "awsDir": { "type": "string", "title": "AWS config directory" }, "awsCliPath": { "type": "string", "title": "AWS CLI path" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "helper-script" }, "command": { "title": "Helper script", "type": "string" }, "ttlSec": { "title": "Helper script TTL", "default": 3600, "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "timeoutSec": { "title": "Credential helper timeout", "default": 60, "type": "integer", "exclusiveMinimum": 0, "maximum": 600 }, "silentRefreshEnabled": { "title": "Re-run helper for silent refresh", "default": true, "type": "boolean" }, "awsEnv": { "type": "object", "properties": { "profile": { "type": "string", "title": "AWS profile name" }, "awsDir": { "type": "string", "title": "AWS config directory" }, "awsCliPath": { "type": "string", "title": "AWS CLI path" }, "region": { "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$", "title": "AWS region" } } } }, "required": [ "kind" ] } ] } }, "required": [ "provider" ] }, { "type": "object", "properties": { "provider": { "type": "string", "const": "mantle" }, "region": { "title": "AWS region", "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$" }, "baseUrl": { "title": "Bedrock base URL", "type": "string", "format": "uri" }, "customHeaders": { "title": "Custom inference headers", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "sessionLifetimeSec": { "title": "Sign-in session lifetime", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "credential": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "static" }, "bearerToken": { "type": "string", "title": "AWS bearer token" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "helper-script" }, "command": { "title": "Helper script", "type": "string" }, "ttlSec": { "title": "Helper script TTL", "default": 3600, "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "timeoutSec": { "title": "Credential helper timeout", "default": 60, "type": "integer", "exclusiveMinimum": 0, "maximum": 600 }, "silentRefreshEnabled": { "title": "Re-run helper for silent refresh", "default": true, "type": "boolean" }, "awsEnv": { "type": "object", "properties": { "profile": { "type": "string", "title": "AWS profile name" }, "awsDir": { "type": "string", "title": "AWS config directory" }, "awsCliPath": { "type": "string", "title": "AWS CLI path" }, "region": { "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$", "title": "AWS region" } } } }, "required": [ "kind" ] } ] } }, "required": [ "provider" ] }, { "type": "object", "properties": { "provider": { "type": "string", "const": "vertex" }, "projectId": { "type": "string", "minLength": 1, "title": "GCP project ID" }, "region": { "type": "string", "pattern": "^([a-z]+-[a-z]+\\d{1,2}|global|eu|us)$", "title": "GCP region" }, "baseUrl": { "type": "string", "format": "uri", "title": "Vertex AI base URL" }, "customHeaders": { "title": "Custom inference headers", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "sessionLifetimeSec": { "title": "Sign-in session lifetime", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "credential": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "oauth" }, "clientId": { "type": "string", "minLength": 1, "title": "Vertex OAuth client ID" }, "clientSecret": { "type": "string", "minLength": 1, "title": "Vertex OAuth client secret" }, "scopes": { "type": "string", "minLength": 1, "title": "Vertex OAuth scopes" }, "loginHint": { "type": "string", "minLength": 1, "title": "Vertex OAuth login hint" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "workforce" }, "audience": { "type": "string", "minLength": 1, "title": "Workforce Identity audience" }, "userProject": { "type": "string", "minLength": 1, "title": "Workforce Identity billing project" }, "authFlow": { "type": "string", "enum": [ "browser", "broker" ], "title": "Workforce Identity sign-in flow" }, "oidc": { "type": "object", "properties": { "clientId": { "type": "string", "minLength": 1 }, "issuer": { "type": "string", "format": "uri" }, "authorizationUrl": { "type": "string", "format": "uri" }, "tokenUrl": { "type": "string", "format": "uri" }, "scopes": { "type": "string", "minLength": 1 }, "redirectPort": { "type": "integer", "minimum": 1024, "maximum": 65535 }, "omitOfflineAccess": { "type": "boolean" }, "additionalRedirectReferrerHosts": { "type": "string" } }, "required": [ "clientId" ], "title": "Workforce Identity IdP (OIDC)" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "vendor-profile" }, "credentialsFile": { "type": "string", "title": "GCP credentials file path" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "helper-script" }, "command": { "title": "Helper script", "type": "string" }, "ttlSec": { "title": "Helper script TTL", "default": 3600, "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "timeoutSec": { "title": "Credential helper timeout", "default": 60, "type": "integer", "exclusiveMinimum": 0, "maximum": 600 }, "silentRefreshEnabled": { "title": "Re-run helper for silent refresh", "default": true, "type": "boolean" }, "awsEnv": { "type": "object", "properties": { "profile": { "type": "string", "title": "AWS profile name" }, "awsDir": { "type": "string", "title": "AWS config directory" }, "awsCliPath": { "type": "string", "title": "AWS CLI path" }, "region": { "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$", "title": "AWS region" } } } }, "required": [ "kind" ] } ] } }, "required": [ "provider" ] }, { "type": "object", "properties": { "provider": { "type": "string", "const": "foundry" }, "resource": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$", "title": "Azure AI Foundry resource name" }, "customHeaders": { "title": "Custom inference headers", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "sessionLifetimeSec": { "title": "Sign-in session lifetime", "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "credential": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "static" }, "apiKey": { "type": "string", "title": "Azure AI Foundry API key" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "interactive" }, "tenantId": { "type": "string", "minLength": 1, "title": "Entra ID tenant ID" }, "clientId": { "type": "string", "minLength": 1, "title": "Entra ID client ID" }, "authFlow": { "type": "string", "enum": [ "device-code", "browser", "broker" ], "title": "Entra ID sign-in flow" } }, "required": [ "kind" ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "helper-script" }, "command": { "title": "Helper script", "type": "string" }, "ttlSec": { "title": "Helper script TTL", "default": 3600, "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "timeoutSec": { "title": "Credential helper timeout", "default": 60, "type": "integer", "exclusiveMinimum": 0, "maximum": 600 }, "silentRefreshEnabled": { "title": "Re-run helper for silent refresh", "default": true, "type": "boolean" }, "awsEnv": { "type": "object", "properties": { "profile": { "type": "string", "title": "AWS profile name" }, "awsDir": { "type": "string", "title": "AWS config directory" }, "awsCliPath": { "type": "string", "title": "AWS CLI path" }, "region": { "type": "string", "pattern": "^[a-z]{2,}(-[a-z]+)+-\\d{1,2}$", "title": "AWS region" } } } }, "required": [ "kind" ] } ] } }, "required": [ "provider" ] } ] }, "otlp": { "type": "object", "properties": { "endpoint": { "type": "string", "format": "uri", "title": "OpenTelemetry collector endpoint" }, "protocol": { "type": "string", "enum": [ "http/protobuf", "http/json", "grpc" ], "title": "OpenTelemetry exporter protocol", "default": "http/protobuf" }, "headers": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" }, "title": "OpenTelemetry exporter headers" }, "authMode": { "type": "string", "enum": [ "none", "inference-credential" ], "title": "Collector authentication" }, "headersHelper": { "type": "string", "minLength": 1, "title": "OpenTelemetry headers helper script" }, "resourceAttributes": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" }, "title": "OpenTelemetry resource attributes" }, "desktopLogLevel": { "type": "string", "enum": [ "off", "error", "warn", "info", "debug" ], "title": "Desktop telemetry export level", "default": "error" }, "contentCapture": { "type": "array", "items": { "type": "string", "enum": [ "userPrompts", "assistantResponses", "toolDetails", "toolContent", "rawApiBodies" ] }, "title": "Content capture categories" }, "tracesEnabled": { "type": "boolean", "title": "Export traces (beta)" } } }, "tokenLimits": { "type": "object", "properties": { "maxPerWindow": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991, "title": "Max tokens per window" }, "windowHours": { "type": "integer", "exclusiveMinimum": 0, "maximum": 720, "title": "Token cap window" } } }, "coworkSurface": { "type": "object", "properties": { "enabled": { "type": "boolean", "title": "Allow Cowork", "default": true } } }, "codeSurface": { "type": "object", "properties": { "enabled": { "type": "boolean", "title": "Allow Code", "default": true } } }, "chatSurface": { "type": "object", "properties": { "enabled": { "type": "boolean", "title": "Allow Chat" }, "advancedFileAnalysis": { "type": "boolean", "title": "Advanced file analysis" } } }, "extensions": { "type": "object", "properties": { "enabled": { "type": "boolean", "title": "Allow desktop extensions", "default": false }, "signatureRequired": { "type": "boolean", "title": "Require signed extensions", "default": false } } }, "autoUpdate": { "type": "object", "properties": { "disabled": { "type": "boolean", "title": "Block auto-updates", "default": false }, "enforcementHours": { "type": "integer", "exclusiveMinimum": 0, "maximum": 72, "title": "Auto-update enforcement window" }, "viaUpdatesHost": { "type": "boolean", "title": "Check for updates on releases.claude.com", "default": false } } }, "featureDiscovery": { "type": "object", "properties": { "disabled": { "type": "boolean", "title": "Hide feature announcements", "default": false } } }, "models": { "type": "object", "properties": { "discoveryEnabled": { "type": "boolean", "title": "Model discovery" }, "prefer1mContext": { "type": "boolean", "title": "Default to 1M context" }, "list": { "minItems": 1, "type": "array", "items": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "labelOverride": { "type": "string" }, "supports1m": { "type": "boolean" }, "prefer1m": { "type": "boolean" }, "anthropicFamilyTier": { "type": "string", "enum": [ "sonnet", "opus", "haiku", "fable", "mythos" ] }, "isFamilyDefault": { "type": "boolean" } }, "required": [ "name" ] } ] }, "title": "Model list" } } }, "plugins": { "type": "object", "properties": { "settings": { "type": "object", "properties": { "mcpServers": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "default": {}, "type": "object", "properties": { "toolPolicy": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "allow", "ask", "ask-session", "blocked" ] } } } } } }, "title": "Organization plugin settings" }, "marketplaces": { "type": "array", "items": { "default": null, "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "source": { "type": "string", "const": "github" }, "repo": { "type": "string", "pattern": "^[^\\s/]+\\/[^\\s/]+$" }, "ref": { "type": "string", "minLength": 1 }, "path": { "type": "string", "minLength": 1 }, "expectedName": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,126}[A-Za-z0-9_-])?$" }, "installationPreference": { "type": "string", "enum": [ "available", "auto_install", "required" ] }, "credentialKind": { "type": "string", "enum": [ "anonymous", "userGit", "credentialHelper" ] }, "credentialHelper": { "type": "string", "minLength": 1 } }, "required": [ "source", "repo" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "git" }, "url": { "type": "string", "format": "uri" }, "ref": { "type": "string", "minLength": 1 }, "path": { "type": "string", "minLength": 1 }, "expectedName": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,126}[A-Za-z0-9_-])?$" }, "installationPreference": { "type": "string", "enum": [ "available", "auto_install", "required" ] }, "credentialKind": { "type": "string", "enum": [ "anonymous", "userGit", "credentialHelper" ] }, "credentialHelper": { "type": "string", "minLength": 1 } }, "required": [ "source", "url" ] }, { "type": "object", "properties": { "source": { "type": "string", "const": "url" }, "url": { "type": "string", "format": "uri" }, "manifestSha256": { "type": "string", "pattern": "^[0-9a-fA-F]{64}$" }, "expectedName": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,126}[A-Za-z0-9_-])?$" }, "installationPreference": { "type": "string", "enum": [ "available", "auto_install", "required" ] }, "credentialKind": { "type": "string", "enum": [ "anonymous", "userGit", "credentialHelper", "inferenceCredential" ] }, "credentialHelper": { "type": "string", "minLength": 1 } }, "required": [ "source", "url" ] } ] }, { "type": "null" } ] }, "title": "Plugin marketplaces" } } }, "telemetry": { "type": "object", "properties": { "orgUuid": { "type": "string", "title": "Organization UUID" }, "disableEssential": { "type": "boolean", "title": "Block essential telemetry", "default": false }, "disableNonessential": { "type": "boolean", "title": "Block nonessential telemetry", "default": false }, "disableNonessentialServices": { "type": "boolean", "title": "Block nonessential services", "default": false } } }, "mcp": { "type": "object", "properties": { "managedServers": { "type": "array", "items": { "default": null, "anyOf": [ { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "transport": { "not": {} }, "url": { "not": {} }, "command": { "not": {} }, "oauth": { "not": {} }, "headers": { "not": {} }, "headersHelper": { "not": {} }, "headersHelperTtlSec": { "not": {} }, "headersHelperRefreshBufferSec": { "not": {} }, "args": { "not": {} }, "env": { "not": {} }, "envHelper": { "not": {} }, "envHelperTtlSec": { "not": {} }, "startupTimeoutSec": { "not": {} }, "server": { "type": "string", "const": "microsoft365" }, "tenantId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, { "enum": [ "common", "organizations", "consumers" ], "type": "string" } ] }, "clientId": { "type": "string", "minLength": 1 }, "azureCloud": { "type": "string", "enum": [ "global", "us-gov-high", "us-gov-dod" ] }, "scope": { "type": "string" }, "toolPolicy": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "allow", "ask", "ask-session", "blocked" ] } }, "scopes": { "not": {} } }, "required": [ "name", "server", "tenantId", "clientId" ] }, { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "transport": { "not": {} }, "url": { "not": {} }, "command": { "not": {} }, "oauth": { "not": {} }, "headers": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "headersHelper": { "type": "string", "minLength": 1 }, "headersHelperTtlSec": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "headersHelperRefreshBufferSec": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "args": { "not": {} }, "env": { "not": {} }, "envHelper": { "not": {} }, "envHelperTtlSec": { "not": {} }, "startupTimeoutSec": { "not": {} }, "server": { "type": "string", "const": "websearch" }, "provider": { "type": "string", "enum": [ "brave", "tavily", "exa", "custom" ] }, "customUrl": { "type": "string", "format": "uri" }, "toolPolicy": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "allow", "ask", "ask-session", "blocked" ] } } }, "required": [ "name", "server", "provider" ] }, { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "transport": { "not": {} }, "url": { "not": {} }, "command": { "not": {} }, "oauth": { "not": {} }, "headers": { "not": {} }, "headersHelper": { "not": {} }, "headersHelperTtlSec": { "not": {} }, "headersHelperRefreshBufferSec": { "not": {} }, "args": { "not": {} }, "env": { "not": {} }, "envHelper": { "not": {} }, "envHelperTtlSec": { "not": {} }, "startupTimeoutSec": { "not": {} }, "server": { "type": "string", "const": "github" }, "clientId": { "type": "string" }, "host": { "type": "string", "format": "uri" }, "scope": { "type": "string" }, "toolsets": { "type": "string" }, "readOnly": { "type": "boolean" }, "toolPolicy": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "allow", "ask", "ask-session", "blocked" ] } }, "scopes": { "not": {} } }, "required": [ "name", "server", "clientId" ] } ] }, { "oneOf": [ { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "server": { "not": {} }, "transport": { "type": "string", "enum": [ "http", "sse" ] }, "url": { "type": "string", "format": "uri" }, "oauth": { "anyOf": [ { "type": "boolean", "const": true }, { "type": "object", "properties": { "scope": { "type": "string", "minLength": 1 }, "appendOfflineAccess": { "type": "boolean" }, "scopes": { "not": {} }, "additionalRedirectReferrerHosts": { "type": "string" } } }, { "type": "object", "properties": { "clientId": { "type": "string", "minLength": 1 }, "clientSecret": { "type": "string", "minLength": 1 }, "clientSecretHelper": { "type": "string", "minLength": 1 }, "authorizationServer": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } }, "authorizationUrl": { "type": "string", "format": "uri" }, "tokenUrl": { "type": "string", "format": "uri" }, "tenantId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, { "type": "string", "enum": [ "common", "organizations", "consumers" ] } ] }, "authFlow": { "type": "string", "enum": [ "browser", "broker" ] }, "scope": { "type": "string", "minLength": 1 }, "appendOfflineAccess": { "type": "boolean" }, "callbackHost": { "type": "string", "enum": [ "127.0.0.1", "localhost" ] }, "callbackPort": { "type": "integer", "minimum": 1024, "maximum": 65535 }, "additionalRedirectReferrerHosts": { "type": "string" }, "scopes": { "not": {} }, "mode": { "not": {} } }, "required": [ "clientId" ] }, { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "dcr" } }, "required": [ "mode" ] }, { "type": "object", "properties": { "mode": { "type": "string", "const": "byo" }, "clientId": { "type": "string", "minLength": 1 }, "clientSecret": { "type": "string", "minLength": 1 }, "clientSecretHelper": { "type": "string", "minLength": 1 }, "authorizationServer": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } }, "authorizationUrl": { "type": "string", "format": "uri" }, "tokenUrl": { "type": "string", "format": "uri" }, "tenantId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, { "type": "string", "enum": [ "common", "organizations", "consumers" ] } ] }, "authFlow": { "type": "string", "enum": [ "browser", "broker" ] }, "scope": { "type": "string", "minLength": 1 }, "appendOfflineAccess": { "type": "boolean" }, "callbackHost": { "type": "string", "enum": [ "127.0.0.1", "localhost" ] }, "callbackPort": { "type": "integer", "minimum": 1024, "maximum": 65535 }, "additionalRedirectReferrerHosts": { "type": "string" }, "scopes": { "not": {} } }, "required": [ "mode" ] } ] } ] }, "headers": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "headersHelper": { "type": "string", "minLength": 1 }, "headersHelperTtlSec": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "headersHelperRefreshBufferSec": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "toolPolicy": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "allow", "ask", "ask-session", "blocked" ] } } }, "required": [ "name", "transport", "url" ] }, { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "server": { "not": {} }, "transport": { "type": "string", "const": "stdio" }, "command": { "type": "string", "minLength": 1 }, "args": { "type": "array", "items": { "type": "string" } }, "env": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" } }, "envHelper": { "type": "string", "minLength": 1 }, "envHelperTtlSec": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "startupTimeoutSec": { "type": "integer", "minimum": 5, "maximum": 600 }, "toolPolicy": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "enum": [ "allow", "ask", "ask-session", "blocked" ] } } }, "required": [ "name", "transport", "command" ] } ] } ] }, { "type": "null" } ] }, "title": "Managed MCP servers" }, "persistentAlwaysAllowEnabled": { "type": "boolean", "title": "Allow persistent tool approvals", "default": true }, "localStdioEnabled": { "type": "boolean", "title": "Allow user-added MCP servers", "default": true } } }, "workspace": { "type": "object", "properties": { "disabledBuiltinTools": { "type": "array", "items": { "type": "string" }, "title": "Disabled built-in tools" }, "disableBundledSkills": { "type": "boolean", "title": "Disable bundled skills and workflows" }, "skillCreationEnabled": { "type": "boolean", "title": "Allow user-created skills" }, "builtinToolPolicy": { "type": "object", "propertyNames": { "type": "string", "enum": [ "Bash", "Read", "Write", "Edit", "Glob", "Grep", "NotebookEdit", "WebFetch", "WebSearch", "Task", "TodoWrite", "TaskCreate", "TaskUpdate", "TaskGet", "TaskList", "TaskStop", "Skill", "REPL", "JavaScript", "AskUserQuestion", "ToolSearch", "SendUserMessage" ] }, "additionalProperties": { "type": "string", "enum": [ "allow", "ask" ] }, "title": "Built-in tool policy" }, "autoModeEnabled": { "type": "boolean", "title": "Allow Auto mode", "default": false }, "toolSearchEnabled": { "type": "boolean", "title": "Enable tool search", "default": false }, "allowedFolders": { "type": "array", "items": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "isDefaultSelected": { "type": "boolean" }, "mode": { "type": "string", "enum": [ "rw", "ro" ] } }, "required": [ "path" ] } ] }, "title": "Allowed workspace folders" }, "allowedEgressHosts": { "type": "array", "items": { "type": "string", "minLength": 1 }, "title": "Allowed egress hosts" }, "endUserAttribution": { "type": "boolean", "title": "End-user attribution" }, "userContentRendererUrl": { "type": "string", "format": "uri", "title": "Artifact preview iframe origin" } } }, "authentication": { "type": "object", "properties": { "disableClaudeAiSignIn": { "type": "boolean", "title": "Disable Claude.ai sign-in", "default": false }, "disableDeepLinks": { "type": "boolean", "title": "Disable claude:// deep-link handling", "default": false }, "microsoftAuthBroker": { "type": "string", "enum": [ "auto", "disabled" ], "title": "Microsoft 365 native sign-in broker", "default": "auto" } } }, "appearance": { "type": "object", "properties": { "deploymentDisplayName": { "type": "string", "minLength": 1, "maxLength": 60, "title": "Deployment display name" }, "deploymentDisplaySubtitle": { "type": "string", "minLength": 1, "maxLength": 60, "title": "Deployment display subtitle" } } }, "claudeAiImport": { "type": "object", "properties": { "enabled": { "default": false, "type": "boolean" }, "exportEnabled": { "default": false, "type": "boolean" }, "bannerBehavior": { "type": "string", "enum": [ "off", "detect", "show" ] } }, "title": "Claude.ai data import" }, "banner": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "text": { "type": "string" }, "backgroundColor": { "type": "string" }, "textColor": { "type": "string" }, "linkUrl": { "type": "string" } }, "title": "Organization banner" } }, "description": "Per-user bootstrap configuration response. Nested subset of managed-config-v2 (bootstrapable keys only). Structural reference for editor autocomplete — the client applies further validation that this schema does not express (https-only and non-loopback URLs, origin-pinning under gateway SSO). Unrecognised keys are ignored; flat top-level keys are also accepted at runtime for back-compat but not advertised here." } } }