跳到主要内容

使用 MCP 服务器

MCP（Model Context Protocol）用于为编码工具提供文件、数据库、浏览器或第三方服务等工具能力。MCP 服务器本身不替代模型 API；请先完成对应编码工具的模型接入，再按该工具的方式添加 MCP 服务器。

使用步骤​

  1. 选择支持 MCP 的编码工具，例如 Codex CLI、Claude Code 或 Claude Desktop。
  2. 安装或启动需要使用的 MCP 服务器。
  3. 在编码工具的 MCP 配置中添加服务器命令、参数和环境变量。
  4. 重启编码工具并确认工具列表中出现该 MCP 服务器。

配置示例​

以下是一个本地 MCP 服务器的通用配置结构。实际字段以工具自身的 MCP 配置格式为准：

{
  "mcpServers": {
    "example-server": {
      "command": "npx",
      "args": ["-y", "YOUR_MCP_SERVER_PACKAGE"],
      "env": {
        "YOUR_OPTIONAL_SERVER_KEY": "YOUR_VALUE"
      }
    }
  }
}
注意

MCP 服务器的环境变量与模型 API Key 不一定相同。不要因为配置 MCP 而把 YOUR_API_KEY 写入不受信任的服务器配置。

截图位置 1：插入 MCP 配置文件或配置界面截图。

截图位置 2：插入编码工具识别到 MCP 服务器和工具列表的截图。

常见问题​

工具中没有出现 MCP 服务器​

检查服务器命令能否在终端单独运行，并重启编码工具。

MCP 服务器启动失败​

检查 Node.js、Python 或其他运行时是否已安装；同时确认配置中的命令和参数正确。

MCP 工具无法访问网络或文件​

检查工具或系统的沙箱、权限和网络策略；仅授予 MCP 服务器完成任务所需的最小权限。

相关链接​