{"name":"initialize","slug":"initialize","family":"setting","title":"Settings keys","noun":"settings key","description":"Some MCP server discovery calls are answered from cache, avoiding an extra round trip.","description_source":"entry","described_by":{"version":"2.1.221","anchor":"mcp-server-discover-answered-from-the-cached-projection-on-t"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.305","anchor":"windows-sandbox-loopback-mode-must-match-what-was-verified","heading":"Windows sandbox reports an error when the local network setting doesn't match","line":"On Windows, Claude Code has a new sandbox error for when `network.allowLocalBinding` disagrees with the loopback mode set up at the start","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text"},{"version":"2.1.301","anchor":"sdk-mcp-servers-can-carry-per-tool-permission-policy-via-mcp","heading":"Programs embedding Claude Code can set ask or deny rules for individual MCP tools","line":"Hosts using the SDK can now mark individual tools on their own MCP servers as always ask or always deny","released_at":"2026-10-15 14:34:23","reason":"found in this entry's text, named in this entry"},{"version":"2.1.296","anchor":"sdk-mcp-tool-reference-results-accepted-conditionally-initi","heading":"SDK tool results can carry tool references, and startup reports the version","line":"SDK tool results may now include references to tools, and the SDK's startup reply now reports the Claude Code version","released_at":"2026-10-09 16:58:10","reason":"found in this entry's text"},{"version":"2.1.295","anchor":"mcp-protocol-negotiation-for-claudeai-proxy-servers-now-def","heading":"claude.ai connectors now use automatic MCP protocol negotiation by default","line":"MCP servers reached through claude.ai connectors now agree a protocol version automatically unless the server explicitly turns this off","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"sdk-can-hand-in-process-mcp-server-manifests-to-the-cli-at-i","heading":"SDK can hand in-process MCP server manifests to the CLI at initialize","line":"The Agent SDK can now read tool lists from in-process MCP servers itself and pass them to the CLI when it starts","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"model-level-tool-use-name-cap-and-mcp-stdio-restart-on-32","heading":"Model-level tool_use name cap and MCP stdio restart on -32022 protocol-version rejection","line":"A local MCP server that rejects the protocol version after a timed-out version check is now restarted once without that check","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"sdk-client-now-holds-control-requests-and-mcp-messages-until","heading":"SDK client now holds control requests and MCP messages until initialize has been written","line":"The SDK client now waits for `initialize` to be sent before sending any other request or MCP message","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"legacy-url-elicitation-capability-advertised-to-mcp-servers","heading":"Legacy URL-elicitation capability advertised to MCP servers, with a per-server denylist (gated off)","line":"Claude Code can tell MCP servers it supports URL and form requests for input, behind a flag whose fallback is false and a per-server denylist","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"sdk-initialize-handles-parked-spare-sessions-await-claim","heading":"SDK initialize handles parked spare sessions (--await-claim)","line":"SDK initialize on a parked spare session (`--await-claim`) now ignores workspace trust and can defer the first prompt","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.280","anchor":"generic-shared-control-request-answering-path-added-to-the","heading":"Generic 'shared control request' answering path added to the control bridge","line":"Control bridge gains a generic 'shared control request' handling path","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"}],"entries_total":32,"docs":[{"source":"api","path":"about-claude\/use-case-guides\/customer-support-chat","title":"customer-support-chat","documented":false},{"source":"api","path":"about-claude\/use-case-guides\/legal-summarization","title":"legal-summarization","documented":false},{"source":"api","path":"agents-and-tools\/mcp-connector","title":"mcp-connector","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/bash-tool","title":"bash-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/fine-grained-tool-streaming","title":"fine-grained-tool-streaming","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/memory-tool","title":"memory-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/text-editor-tool","title":"text-editor-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/tool-runner","title":"Log at info level","documented":false},{"source":"api","path":"api\/beta\/vaults","title":"Vaults","documented":false},{"source":"api","path":"api\/beta\/vaults\/credentials","title":"Credentials","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/initialize","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}