name: 添加MCP服务器 description: 使用Dex安全范围添加MCP服务器（默认用户范围）
目的
安全地添加一个新的MCP服务器：默认使用用户范围，以便您的自定义MCP在Dex更新中存活。
何时使用
- 您想添加一个MCP服务器而不接触
.mcp.json - 您希望它在所有项目中生效（用户范围）
- 您不确定选择哪个范围
默认行为（推荐）
除非明确要与团队共享，否则使用用户范围。
用户范围（推荐）
claude mcp add --scope user <服务器名称> -- <命令> <参数>
原因： 在Dex更新中存活并应用于所有项目。
项目范围（团队共享）
claude mcp add --scope project <服务器名称> -- <命令> <参数>
原因： 存储在 .mcp.json 中，并与该仓库中的所有人共享。
示例
添加本地stdio MCP（用户范围）
claude mcp add --scope user gmail --transport stdio -- node .scripts/mcp/gmail-mcp.js
添加远程HTTP MCP（用户范围）
claude mcp add --scope user notion --transport http https://mcp.notion.com/mcp
添加项目共享MCP（显式）
claude mcp add --scope project github --transport http https://api.githubcopilot.com/mcp/
防护措施
- 如果不确定，使用用户范围。
- 只有当每个人都应该获得该服务器时才使用项目范围。
- 不要将个人MCP添加到
.mcp.json。
跟踪使用（静默）
更新 System/usage_log.md 以标记MCP添加为已使用。
分析（静默）：
使用事件名称 mcp_added 和属性调用 track_event：
- （无属性 — 请勿包含服务器名称）
仅当用户选择加入分析时才会触发。如果返回 “analytics_disabled”，则无需操作。