MCP

让 Cursor 通过 Model Context Protocol 连接外部工具和数据源：传输方式、支持的协议能力、MCP Apps、从 Customize 或 mcp.json 安装与静态 OAuth 配置。

Model Context Protocol（MCP）让 Cursor 连接到外部工具和数据源。可以从 Customize 页面安装和管理 MCP 服务器，或在 mcp.json 里配置它们。MCP 把 Cursor 连接到外部系统和数据：与其反复解释你的项目结构，不如直接与你的工具集成。MCP 服务器可以用任何能向 stdout 打印或提供 HTTP 端点的语言编写（Python、JavaScript、Go 等）。可在 Cursor Marketplace 浏览官方插件，社区插件和 MCP 服务器见 cursor.directory。

传输方式

Cursor 支持三种 MCP 传输方式：

传输	执行环境	部署	用户	输入	认证
`stdio`	本地	Cursor 管理	单用户	shell 命令	手动
`SSE`	本地/远程	部署为服务器	多用户	SSE 端点 URL	OAuth
`Streamable HTTP`	本地/远程	部署为服务器	多用户	HTTP 端点 URL	OAuth

协议和扩展支持

特性	支持	说明
Tools	支持	AI 模型执行的函数
Prompts	支持	面向用户的模板化消息和工作流
Resources	支持	可读取和引用的结构化数据源
Roots	支持	服务器发起的对 URI 或文件系统边界的询问
Elicitation	支持	服务器发起的向用户索取额外信息的请求
Apps（扩展）	支持	MCP 工具返回的交互式 UI 视图

MCP Apps：Cursor 支持 MCP Apps 扩展，MCP 工具可以在标准工具输出之外返回交互式 UI。MCP Apps 遵循渐进增强：宿主无法渲染应用 UI 时，同一工具仍通过普通 MCP 响应工作。

安装 MCP 服务器

一键安装：在 Cursor Marketplace 浏览官方插件，从 Customize 一键安装，或用 mcp.json 配置自定义服务器。点市场条目上的「Add to Cursor」安装并认证。团队管理员也可以通过团队市场分发 MCP 服务器，团队分发的服务器与个人和工作区 MCP 服务器一起显示在 Customize 里。

使用 mcp.json：用 JSON 文件配置自定义 MCP 服务器。命令行服务器（Node.js 示例）：

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

远程服务器（用 HTTP 或 SSE，运行在服务器上）：

{
  "mcpServers": {
    "server-name": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

远程服务器的静态 OAuth：对使用 OAuth 的 MCP 服务器，可以在 mcp.json 里提供静态 OAuth 客户端凭据，而不是动态客户端注册。适用于：MCP 提供商给了你固定的 Client ID（可能还有 Client Secret）；提供商要求把重定向 URL 加入白名单（如 Figma、Linear）；提供商不支持 OAuth 2.0 动态客户端注册。给使用 url 的远程服务器条目添加 auth 对象：

{
  "mcpServers": {
    "oauth-server": {
      "url": "https://api.example.com/mcp",
      "auth": {
        "CLIENT_ID": "your-oauth-client-id",
        "CLIENT_SECRET": "your-client-secret",
        "scopes": ["read", "write"]
      }
    }
  }
}

所有 MCP 连接都需要你的批准，批准后每次工具调用仍需单独批准（可用 MCP 允许列表预批准）；MCP 的安全行为见「安全与运行模式」。CLI 会自动检测并遵循你的 mcp.json，使用与编辑器相同的 MCP 服务器和工具。