项目级MCP服务需显式指定--scope local注册，支持stdio本地服务器、远程HTTP服务及JSON配置文件三种添加方式，验证需通过claude mcp list确认scope为local并在当前项目内完成授权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让某个MCP服务只在当前项目里生效，不污染其他项目，也不需要全局安装——这正是项目级MCP服务的核心用途。
确认项目根目录和作用域前提
打开终端，cd 进入你的项目文件夹顶层，确保当前路径下没有 .mcp.json 文件。如果已有，先备份再删除，否则后续添加会受旧配置干扰。
项目级MCP服务必须通过 local 作用域注册，这是Claude Code默认行为，但你不能依赖隐式默认——必须显式指定 --scope local，否则可能误落到 user 级别，导致服务在所有项目中意外出现。
添加项目级MCP服务的三种方式
方法一：添加本地 stdio 类型服务器（推荐用于调试）
执行命令：claude mcp add --scope local my-tool -- /path/to/tool-server --port 3001。注意末尾两个短横线 -- 是分隔符，缺了会导致参数被当成服务器名解析。
方法二：添加远程 HTTP 服务并携带认证头
运行：claude mcp add --scope local notion-api --transport http https://mcp.notion.com/mcp --header "Authorization: Bearer sk-xxx"。这里 header 值必须用双引号包裹，否则空格或特殊字符会截断。
方法三：从本地 JSON 配置文件加载（适合团队协作）
先在项目根目录创建 .mcp.json，内容为：{"servers": [{"name": "db-query", "transport": "http", "url": "http://localhost:8080/mcp"}]}；
然后执行：claude mcp add-from-file .mcp.json。该命令会自动识别 scope 为 local，无需额外加 --scope 参数。
验证与启用
第一步：运行 claude mcp list，检查输出中是否出现你的服务名，并确认 Scope 列显示为 local。
第二步：在 Claude Code 中新建会话，输入 /mcp 命令，看到服务状态为 “Connected” 或 “Pending auth” 即表示已就位。
第三步：若服务需授权（如 Notion、GitHub），在 /mcp 界面中点击对应服务名称，浏览器将弹出 OAuth 页面完成登录。这一步必须在当前项目文件夹内触发，否则授权记录不会绑定到 local 作用域。
