claude-code - 💡(How to fix) Fix [BUG] Design issue: confusing responsibilities of .mcp.json in claude plugin projects [1 participants]

Error Messages/Logs

TL;DR

Move the .mcp.json file for development MCP servers to the .claude directory under the project to avoid conflicts with bundled MCP servers.

Guidance

• Verify that moving the .mcp.json file to the .claude directory resolves the issue of MCP servers being incorrectly installed on the plugin consumer side.
• Check the documentation for Claude Code to see if there are any specific guidelines for configuring MCP servers for development and bundled plugins.
• Test the plugin installation process after moving the .mcp.json file to ensure that the correct MCP servers are being used.
• Consider adding a check in the plugin installation process to handle cases where the .mcp.json file is located in the root directory of the project.

Example

No code snippet is provided as the issue does not require a specific code change, but rather a configuration change.

Notes

The solution assumes that moving the .mcp.json file to the .claude directory is a valid configuration change for Claude Code. If this change does not resolve the issue, further investigation may be needed to determine the correct configuration.

Recommendation

Apply workaround: Move the .mcp.json file for development MCP servers to the .claude directory under the project. This change should help to avoid conflicts with bundled MCP servers and ensure that the correct MCP servers are being used.