MCP使用常见问题

服务添加或安装异常

1.缺少npx命令所需环境

异常信息：‘npx.cmd’不是内部或外部命令，也不是可运行的程序或批量处理文件。

解决方案：下载并安装node.js。您可以在node.js官网(https://nodejs.org/zh-cn)中下载版本大于v19及以上的，且npm 版本须在 v8 及以上，版本过低可能导致工具调用失败。安装后并配置好环境变量。在cmd命令中输入node -v 验证是否已安装配置好。

2.缺少uvx命令所需环境

异常信息：‘uvx.cmd’不是内部或外部命令，也不是可运行的程序或批量处理文件。

解决方案：下载安装 uv， uvx 是 uv 提供的命令行工具，用于快速运行 Python 脚本。您可以前往 Python 官网，下载并安装 Python 3.8 或更高版本。安装完成后通过命令uv --version验证是否已安装配置好。

3.安装失败

异常信息：安装失败，提示错误

解决方案：安装失败后，展开详情，然后单击“一键修复”，跳转到智能会话中，然后选择“智能问答”模式，发送问题，然后根据回答的方案修改配置尝试解决。

4.无法初始化 MCP Client

异常信息：异常原因存在以下关键字：failed to initialize MCP client for XX: context deadline exceeded

异常原因，包括但不限于以下原因：

服务参数配置错误：MCP 服务的参数设置可能存在错误或其他情况，影响服务初始化。

网络安全限制：由于公司内部安全组件的拦截，导致 MCP 服务初始化异常。

排查解决方向：首先，将异常信息复制，然后打开终端，运行该命令，根据命令返回的详细异常信息进行分析和修复。如果是配置参数等原因，则打开应服务编辑配置后再试。如果是Node.js 运行被安全组件拦截，则请根据安全组件的拦截提示，对Node.js进程或相关执行文件进行授权或加白操作。

工具使用的问题

1. 环境变量或参数填写错误，导致工具执行失败

说明：如果 MCP 工具调用出现异常或返回结果不符合预期，建议您首先展开工具调用详情，查看具体的错误信息，并据此进行分析与排查。部分 MCP 服务（如 Mastergo 和 Figma）的 API_KEY 或 TOKEN 等关键认证信息包含在“参数（args）”中。因此，在通过 MCP 广场安装后，仍需手动配置这些参数。请根据错误信息调整后再试。

解决方案：找到对应 MCP 服务，单击编辑。在服务配置中，查看参数（args）部分。替换其中需要更新或填写的变量内容，确保其准确无误，重新连接服务后再尝试调用。

2. 模型无法正常调用 MCP 工具

解决方案：首先在我的服务中确认 MCP 服务处于已连接或者已开启状态，如果服务连接中断可以单击刷新按钮重新连接，或者开启服务。其次确认智能会话中处于智能体模式，如果是在智能问答或者Java chat模式，无法调用 MCP 工具。