claude code MCP 安装范围

MCP 服务器可以在三个不同的范围级别进行配置，每个级别都用于管理服务器可访问性和共享的不同目的。

• 本地范围：个人服务器、实验配置或特定于一个项目的敏感凭据
• 项目范围：团队共享的服务器、项目特定的工具或协作所需的服务
• 用户范围：跨多个项目需要的个人实用程序、开发工具或经常使用的服务

本地范围（默认 --scope=local）

会在~/.claude.json 当前目录节点添加mcpserver，仅在当前目录中工作时可访问

claude mcp add playwright npx @playwright/mcp@latest 

或显示指定

claude mcp add --scope local playwright npx @playwright/mcp@latest

项目范围(--scope=project)

配置存储在项目根目录的 .mcp.json 文件中，设计为检入版本控制，确保所有团队成员都可以访问相同的 MCP 工具和服务

claude mcp add --scope project playwright  npx @playwright/mcp@latest  

用户范围(--scope=user)

会在~/.claude.json 根节点添加mcpserver，计算机上的所有项目中可用

claude mcp add --scope user playwright  npx @playwright/mcp@latest

范围层次结构和优先级

MCP 服务器配置遵循清晰的优先级层次结构。当具有相同名称的服务器存在于多个范围时，系统通过优先考虑本地范围的服务器来解决冲突，然后是项目范围的服务器，最后是用户范围的服务器

配置的存储位置总结

使用 --scope 标志指定配置的存储位置：
local（默认）：存储在~/claude.json的工作目录mcpServers节点，仅在当前工作目录中对您可用（在较旧版本中称为 project）
project：单独存储在项目根目录的.mcp.json 文件中，与项目中的每个人共享
user：存储在~/claude.json的根节点mcpServers节点，在所有项目中对您可用（在较旧版本中称为 global)

---

附，常用命令

查询

# 列出所有配置的服务器
claude mcp list

# 获取特定服务器的详细信息
claude mcp get github

# （在 Claude Code 中）检查服务器状态
/mcp

添加远程 HTTP 服务器

# 命令格式
claude mcp add --transport http <name> <url>
# 真实示例：连接到 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

添加本地 stdio 服务器

# 命令格式
claude mcp add [options] <name> -- <command> [args...]
# 真实示例：添加 Airtable 服务器
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

注意：所有选项（--transport、--env、--scope、--header）必须位于服务器名称之前

移除命令

存在多个可用的重复mcp时，需要指定范围参数:

  claude mcp remove "playwright" -s local
  claude mcp remove "playwright" -s project
  claude mcp remove "playwright" -s user

参考链接: https://code.claude.com/docs/zh-CN/mcp