claude-code - 💡(How to fix) Fix [BUG] MCP tools from commented-out server entries still appear in context

TL;DR

The issue can likely be fixed by properly handling JSONC-style comments in the .mcp.json file or by using a different commenting method.

Guidance

• Verify that the .mcp.json file is being parsed correctly, considering that JSONC-style comments (//) might not be supported in all JSON parsers.
• Check if there's an alternative commenting method available for the .mcp.json file, such as using a different character or wrapping the entire server entry in a comment block.
• Investigate if the issue is specific to the Windows 11 Enterprise environment or if it occurs across different operating systems.
• Consider modifying the Claude Code session startup process to explicitly exclude commented-out servers from the deferred tools list.

Example

No code snippet is provided due to the lack of specific implementation details in the issue.

Notes

The solution may depend on the specific JSON parser being used by Claude Code, as well as the expected behavior of the .mcp.json file. Further investigation into the parser and file format may be necessary to determine the root cause.

Recommendation

Apply a workaround by using a different commenting method or modifying the startup process to exclude commented-out servers, as the root cause is likely related to the parsing of JSONC-style comments.