项目级和全局配置有什么区别？

项目级配置只在该项目中生效，适合项目特定的工具（如数据库连接）。全局配置对所有项目生效，适合通用工具（如文件搜索、网页抓取）。两者同时存在时会合并。

Cursor 中 MCP 工具不响应怎么办？

确认你在使用 Agent 模式（不是普通 Chat）。检查 MCP 设置页面中 Server 状态是否为绿色。尝试点击 "Restart" 按钮重启 Server。

能否在 Cursor 中使用 Claude Desktop 的 MCP 配置？

不能直接共用。两者的配置文件路径和格式略有不同，Required分别配置。但 MCP Server 本身是通用的，同一个 Server 可以同时被两个Clients使用。

Cursor MCP 配置Guides - AI Agent & MCP Server Tools Directory

前置条件

已安装 Cursor 编辑器（0.45 或更高版本）
已安装 Node.js 18+（用于 npx 类 Server）或 Python 3.10+（用于 uvx 类 Server）

配置步骤

第一步：打开 MCP 设置

在 Cursor 中，通过以下路径进入 MCP 配置：

打开 Settings（快捷键 Cmd+, 或 Ctrl+,）
在左侧菜单找到 "MCP" 选项
点击 "Add new MCP server" 按钮

也可以直接编辑项目根目录下的 .cursor/mcp.json 文件。

第二步：编辑配置文件

Cursor 的 MCP 配置文件位置：

项目级别：.cursor/mcp.json（项目根目录下）
全局级别：~/.cursor/mcp.json（用户目录下）

配置文件格式示例：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/project"
      ]
    }
  }
}

第三步：验证连接

配置保存后，Cursor 会自动尝试连接 MCP Server。在 MCP 设置页面中，已连接的 Server 旁边会显示绿色状态指示器。

如果显示红色或黄色，点击 Server 名称View错误详情。

在 Agent 模式中使用

MCP 工具在 Cursor 的 Agent 模式（Composer Agent）中可用：

打开 Composer（Cmd+I 或 Ctrl+I）
切换到 Agent 模式
AI 会根据Required自动调用已连接的 MCP 工具

注意：普通的 Chat 模式和 Edit 模式不支持 MCP 工具调用。

Important Notes

项目级配置（.cursor/mcp.json）会被提交到版本控制，不要在其中写入 API Key。
Required API Key 的 Server，建议使用环境变量方式配置，Key 存放在 .env 文件中并加入 .gitignore。
Cursor 的 MCP 支持仍在快速迭代中，配置格式可能随版本更新变化。
如果 Server 启动失败，尝试在终端手动运行 command + args 确认命令本身是否正常。

FAQ

项目级和全局配置有什么区别？: 项目级配置只在该项目中生效，适合项目特定的工具（如数据库连接）。全局配置对所有项目生效，适合通用工具（如文件搜索、网页抓取）。两者同时存在时会合并。
Cursor 中 MCP 工具不响应怎么办？: 确认你在使用 Agent 模式（不是普通 Chat）。检查 MCP 设置页面中 Server 状态是否为绿色。尝试点击 "Restart" 按钮重启 Server。
能否在 Cursor 中使用 Claude Desktop 的 MCP 配置？: 不能直接共用。两者的配置文件路径和格式略有不同，Required分别配置。但 MCP Server 本身是通用的，同一个 Server 可以同时被两个Clients使用。

Cursor MCP 配置Guides