{ "$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": { "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 }, "inferenceGatewayBaseUrl": { "type": "string", "format": "uri", "title": "Gateway base URL" }, "inferenceCustomHeaders": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" }, "title": "Custom inference headers" }, "inferenceSessionLifetimeSec": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991, "title": "Sign-in session lifetime" }, "inferenceGatewayApiKey": { "type": "string", "title": "Gateway API key" }, "inferenceGatewayAuthScheme": { "type": "string", "enum": [ "bearer", "x-api-key" ], "title": "Gateway auth scheme", "default": "bearer" }, "inferenceGatewayOidc": { "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" }, "redirectPort": { "type": "integer", "minimum": 1024, "maximum": 65535 }, "additionalRedirectReferrerHosts": { "type": "string" } }, "required": [ "clientId" ], "title": "Gateway SSO IdP (OIDC)" }, "inferenceAnthropicApiKey": { "type": "string", "title": "Claude API key" }, "inferenceBedrockRegion": { "type": "string", "title": "AWS region" }, "inferenceBedrockBaseUrl": { "type": "string", "format": "uri", "title": "Bedrock base URL" }, "inferenceBedrockServiceTier": { "type": "string", "enum": [ "flex", "priority" ], "title": "Bedrock service tier" }, "inferenceBedrockBearerToken": { "type": "string", "title": "AWS bearer token" }, "inferenceBedrockSsoStartUrl": { "type": "string", "format": "uri", "title": "AWS SSO start URL" }, "inferenceBedrockSsoRegion": { "type": "string", "pattern": "^[a-z]{2}(-[a-z]+)+-\\d{1,2}$", "title": "AWS SSO region" }, "inferenceBedrockSsoAccountId": { "type": "string", "minLength": 1, "title": "AWS SSO account ID" }, "inferenceBedrockSsoRoleName": { "type": "string", "minLength": 1, "title": "AWS SSO role name" }, "inferenceVertexProjectId": { "type": "string", "title": "GCP project ID" }, "inferenceVertexRegion": { "type": "string", "title": "GCP region" }, "inferenceVertexBaseUrl": { "type": "string", "format": "uri", "title": "Vertex AI base URL" }, "inferenceVertexOAuthClientId": { "type": "string", "minLength": 1, "title": "Vertex OAuth client ID" }, "inferenceVertexOAuthClientSecret": { "type": "string", "minLength": 1, "title": "Vertex OAuth client secret" }, "inferenceVertexOAuthScopes": { "type": "string", "minLength": 1, "title": "Vertex OAuth scopes" }, "inferenceVertexOAuthLoginHint": { "type": "string", "minLength": 1, "title": "Vertex OAuth login hint" }, "inferenceVertexWorkforceAudience": { "type": "string", "minLength": 1, "title": "Workforce Identity audience" }, "inferenceVertexWorkforceUserProject": { "type": "string", "minLength": 1, "title": "Workforce Identity billing project" }, "inferenceVertexWorkforceOidc": { "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)" }, "inferenceFoundryResource": { "type": "string", "title": "Azure AI Foundry resource name" }, "inferenceFoundryApiKey": { "type": "string", "title": "Azure AI Foundry API key" }, "inferenceFoundryAuthFlow": { "type": "string", "enum": [ "device-code", "browser", "broker" ], "title": "Entra ID sign-in flow" }, "otlpEndpoint": { "type": "string", "format": "uri", "title": "OpenTelemetry collector endpoint" }, "otlpProtocol": { "type": "string", "enum": [ "http/protobuf", "http/json", "grpc" ], "title": "OpenTelemetry exporter protocol", "default": "http/protobuf" }, "otlpHeaders": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" }, "title": "OpenTelemetry exporter headers" }, "otlpResourceAttributes": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string" }, "title": "OpenTelemetry resource attributes" }, "otlpDesktopLogLevel": { "type": "string", "enum": [ "off", "error", "warn", "info", "debug" ], "title": "Desktop telemetry export level", "default": "error" }, "otlpContentCapture": { "type": "array", "items": { "type": "string", "enum": [ "userPrompts", "assistantResponses", "toolDetails", "toolContent", "rawApiBodies" ] }, "title": "Content capture categories" }, "otlpTracesEnabled": { "type": "boolean", "title": "Export traces (beta)" }, "inferenceMaxTokensPerWindow": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991, "title": "Max tokens per window" }, "inferenceTokenWindowHours": { "type": "integer", "exclusiveMinimum": 0, "maximum": 720, "title": "Token cap window" }, "coworkTabEnabled": { "type": "boolean", "title": "Allow Cowork tab", "default": true }, "isClaudeCodeForDesktopEnabled": { "type": "boolean", "title": "Allow Claude Code tab", "default": true }, "chatTabEnabled": { "type": "boolean", "title": "Allow Chat tab" }, "chatAdvancedFileAnalysisEnabled": { "type": "boolean", "title": "Advanced file analysis" }, "isDesktopExtensionEnabled": { "type": "boolean", "title": "Allow desktop extensions", "default": false }, "isDesktopExtensionSignatureRequired": { "type": "boolean", "title": "Require signed extensions", "default": false }, "disableAutoUpdates": { "type": "boolean", "title": "Block auto-updates", "default": false }, "autoUpdaterEnforcementHours": { "type": "integer", "exclusiveMinimum": 0, "maximum": 72, "title": "Auto-update enforcement window" }, "disableFeatureDiscovery": { "type": "boolean", "title": "Hide feature announcements", "default": false }, "modelDiscoveryEnabled": { "type": "boolean", "title": "Model discovery" }, "inferenceModels": { "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" }, "organizationPluginsUrl": { "type": "string", "format": "uri", "title": "Organization plugins endpoint" }, "orgPluginSettings": { "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" }, "allowedPluginMarketplaces": { "type": "array", "items": { "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,127}$" }, "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,127}$" }, "installationPreference": { "type": "string", "enum": [ "available", "auto_install", "required" ] }, "credentialKind": { "type": "string", "enum": [ "anonymous", "userGit", "credentialHelper" ] }, "credentialHelper": { "type": "string", "minLength": 1 } }, "required": [ "source", "url" ] } ] }, "title": "Plugin marketplaces" }, "deploymentOrganizationUuid": { "type": "string", "title": "Organization UUID" }, "disableEssentialTelemetry": { "type": "boolean", "title": "Block essential telemetry", "default": false }, "disableNonessentialTelemetry": { "type": "boolean", "title": "Block nonessential telemetry", "default": false }, "disableNonessentialServices": { "type": "boolean", "title": "Block nonessential services", "default": false }, "managedMcpServers": { "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" ] } ] }, { "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" ] } ] }, "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" ] } ] }, "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" }, "mcpPersistentAlwaysAllowEnabled": { "type": "boolean", "title": "Allow persistent tool approvals", "default": true }, "isLocalDevMcpEnabled": { "type": "boolean", "title": "Allow user-added MCP servers", "default": true }, "disabledBuiltinTools": { "type": "array", "items": { "type": "string" }, "title": "Disabled built-in tools" }, "disableBundledSkills": { "type": "boolean", "title": "Disable bundled skills and workflows" }, "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 }, "allowedWorkspaceFolders": { "type": "array", "items": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "isDefaultSelected": { "type": "boolean" } }, "required": [ "path" ] } ] }, "title": "Allowed workspace folders" }, "coworkEgressAllowedHosts": { "type": "array", "items": { "type": "string", "minLength": 1 }, "title": "Allowed egress hosts" }, "disableDeploymentModeChooser": { "type": "boolean", "title": "Disable Claude.ai sign-in", "default": false }, "claudeAiImport": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "oauthIssuer": { "type": "string", "format": "uri" }, "oauthClientId": { "type": "string", "minLength": 1 } }, "required": [ "url", "oauthIssuer", "oauthClientId" ], "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" }, "deploymentDisplayName": { "type": "string", "maxLength": 60, "title": "Deployment display name" }, "deploymentDisplaySubtitle": { "type": "string", "maxLength": 60, "title": "Deployment display subtitle" }, "enduserAttribution": { "type": "boolean", "title": "End-user attribution" }, "inferenceProvider": { "type": "string", "enum": [ "gateway", "anthropic", "bedrock", "mantle", "vertex", "foundry" ], "title": "Inference provider" }, "inferenceCredentialKind": { "type": "string", "enum": [ "static", "helper-script", "interactive", "vendor-profile", "oauth", "workforce" ], "title": "Credential kind" } }, "description": "Per-user bootstrap configuration response. 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." } } }