Claude Code项目中全局MCP服务器配置的注意事项

在Claude Code项目中，开发者经常需要配置MCP(Model Context Protocol)服务器来扩展功能。近期发现一个常见的配置误区值得开发者注意。

正确的全局MCP服务器配置方式

Claude Code提供了两种方式来配置MCP服务器：

1. 项目级配置：仅对当前项目生效
2. 全局配置：对所有项目生效

要实现全局配置，正确的做法是使用--scope global参数：

claude mcp add --scope global [服务器名称] [配置参数]

或者使用JSON格式配置：

claude mcp add-json --scope global [服务器名称] [JSON配置]

常见的配置误区

部分开发者误以为可以直接在~/.claude-code/mcp/global.json文件中定义MCP服务器配置。实际上，这个文件路径并不是Claude Code官方支持的全局配置方式，因此在此文件中定义的服务器不会被自动加载。

解决方案

如果已经错误地在上述路径中配置了MCP服务器，可以通过以下方式迁移到正确的配置：

1. 使用命令行工具重新添加全局服务器
2. 或者将现有配置转换为正确的全局配置命令

例如，对于已配置的brave-search服务器：

claude mcp add-json --scope global brave-search "$(cat ~/.claude-code/mcp/global.json | jq '.mcpServers."brave-search"')"

最佳实践建议

1. 始终使用官方推荐的--scope参数来区分配置范围
2. 避免手动编辑配置文件，优先使用命令行工具
3. 定期检查配置是否生效，使用claude mcp list命令验证

通过遵循这些实践，可以确保MCP服务器配置在Claude Code项目中正确加载和应用。