CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE
Updated by Alex Sorokoletov
CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE is a Claude Code environment variable: When true, adds the header X-MCP-Features set to mcp_apps_disable_form_deferral on MCP server requests that do not already send that header. Added in v2.1.324 and still present in v2.1.324. It is not in the official reference.
| Status | Present in v2.1.324 |
|---|---|
| Added | Added in v2.1.324 |
| Category | MCP |
| Official docs | Not listed |
How to set it
For one session, export it in the shell that starts Claude Code:
export CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE=<value>
claudeTo apply it to every session, add it to the env object of a settings file:
// ~/.claude/settings.json
{
"env": {
"CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE": "<value>"
}
}Related variables
CLAUDE_CODE_MCP_APPS_HOST: Set to true to declare support for MCP app UI extensions, advertising HTML (text/html;profile=mcp-app) surfaces in the client capabilities.CLAUDE_CODE_MCP_SERVE_TOOL_OUTPUT: When true, enables the experimental MCP serve tool-output path, which validates and attaches tool deny rules; off otherwise.CLAUDE_CODE_ARTIFACT_MCP: Enables MCP runtime-capability support for artifacts; on by default.CLAUDE_CODE_CHROME_LATE_MCP_SERVER: When true, loads the alternate late Claude-in-Chrome MCP server module and skips installing the Chrome native host early.CLAUDE_CODE_CHROME_MCP_ORG_DENIED: When set, forces Claude-in-Chrome to be treated as denied by organization policy, with the cause reported as parent_org_policy.CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND: Turns off automatic backgrounding of MCP tool tasks.CLAUDE_CODE_DISABLE_MCP_TASKS: When set to any value, disables the MCP tasks feature; when unset, availability is decided by a server-side setting together with other session conditions.CLAUDE_CODE_ENABLE_REFRESH_MCP_TOOLS: Enables an on-demand MCP-tool refresh capability, grouped with CLAUDE_CODE_ENABLE_TASKS and CLAUDE_CODE_ENABLE_REMOTE_RECAP.
Frequently asked questions
What does CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE do?
When true, adds the header X-MCP-Features set to mcp_apps_disable_form_deferral on MCP server requests that do not already send that header.
Which Claude Code version has CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE?
Added in v2.1.324 and still present in v2.1.324.
How do I set CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE?
Export it before starting Claude Code (export CLAUDE_CODE_MCP_APPS_NO_TOOL_ROUTE=value), or add it to the "env" object in ~/.claude/settings.json to apply it to every session.
All variables, searchable: Claude Code environment variables.