展开知识库目录
Windows、macOS 和 Linux 安装 MCP,路径与环境变量哪里不同
同一 Server 包名可能相同,但 Windows、macOS 和 Linux 的可执行路径、引号、环境变量、权限与客户端启动环境不同。
跨平台差异主要在路径、Shell、权限和进程环境
同一 Server 包名可能相同,但 Windows、macOS 和 Linux 的可执行路径、引号、环境变量、权限与客户端启动环境不同。不要只替换斜杠。
Windows
确认 PowerShell/cmd、盘符、反斜杠、用户目录、执行策略和 GUI 应用继承的环境变量。
记录 Client、Server、配置位置、传输方式、认证范围、工具列表和一次真实调用结果。
macOS
区分 Intel/Apple Silicon、zsh、Homebrew 路径、钥匙串和应用从 Finder 启动时的环境。
确认“macOS”已经有可回查结果,再进入“Linux”;依据仍然来自猜测时,把缺口单列并停在当前步骤。
Linux
确认发行版、Shell、系统包、服务用户、显示环境和文件权限;服务器可能没有桌面客户端。
确认“Linux”已经有可回查结果,再进入“共同核验”;依据仍然来自猜测时,把缺口单列并停在当前步骤。
共同核验
在目标客户端同一用户下检查命令路径、运行时版本、配置位置、日志和只读测试。
先用只读、小范围请求验证连接;涉及写入、删除、付款或外发时必须重新确认对象与权限。 完成后把证据归入“平台差异核对表”。
把各项实际条件、来源和未知项写进“平台差异核对表”,不要用印象打总分。
每个平台保留独立记录
写实际路径和命令输出,不生成一份看似通用的配置。平台没有实测时标待验证,不能从另一个系统推断成功。
