《Cursor文档》-插件

插件将规则、技能、agents、命令、MCP 服务器和钩子打包为可分发的组件包。

Cursor 支持 Agent Plugins 开放标准，也支持自有的插件格式。你可以在自定义页面安装和管理插件，或在插件市场浏览官方插件。社区插件和 MCP 服务器请前往 cursor.directory 浏览。你也可以自行构建，与其他开发者分享。

插件包含的内容¶

一个插件可以包含以下组件的任意组合：

Agent Plugins 标准¶

插件将智能体可使用的可复用组件打包在一起。Agent Plugins
是一种用于打包可移植技能和 MCP 服务器的开放标准，正如
Agent Skills 为单个技能定义了标准。Cursor
同时支持 Agent Plugins 和 Cursor 插件。

• Agent Plugins：符合规范的插件，在插件根目录包含 plugin.json 清单，用于打包技能和 MCP 服务器
• Cursor 插件：包含 .cursor-plugin/plugin.json 清单的插件，可添加规则、agents、命令、钩子和变量

遵循 Agent Plugins 规范的插件无需修改即可在 Cursor 中加载。Cursor 插件会继续与该标准并行发展，因此 Cursor 专属组件和 marketplace 功能仍可照常使用。

前往 agent-plugins.org 了解更多，或阅读 GitHub 上的规范。

Cursor 插件 Canvas¶

插件现已提供预构建的 Canvas：供团队打开和复用的共享设置模板。

• Hex Canvas — 构建数据可视化。在 Cursor，我们使用 Hex Canvas 探索和分享使用分析数据。
• Atlassian Canvas — 实时查看 Jira 和 Confluence 中的问题、项目和文档。

在 Customize 中打开已安装插件中的 Canvas，即可获得引导式起点，无需从头配置所有内容。

插件市场¶

插件市场 用于发现和安装官方 Cursor 插件。插件以 Git 仓库的形式发布，并通过 Cursor 团队提交。

每个插件在上架前均会经过人工审核。可在 cursor.com/marketplace 浏览官方插件，或在 自定义 中按关键字搜索。社区插件和 MCP 服务器请浏览 cursor.directory。

团队插件市场¶

团队版和企业版方案均可使用团队插件市场。
通过同一插件市场，可以分发 Agent Plugin 和 Cursor 插件。

• 团队版：最多 1 个团队插件市场
• 企业版方案：团队插件市场数量不限

如需使用不限数量的团队插件市场及企业版管理员控制功能，请联系销售。

打开 仪表盘 -> 插件，管理团队插件市场。

在企业版方案中，只有管理员可以通过 仪表盘
-> 插件 添加团队插件市场。

默认团队插件市场¶

默认团队插件市场可在 Cursor 中共享插件和 MCP 服务器。管理员可以添加已可供云端代理使用的团队 MCP 服务器，并让团队成员在代理窗口、IDE 和 CLI 中安装和配置这些服务器。

将团队 MCP 服务器添加到默认插件市场，并不会为每位开发者安装或启用它。管理员仍可控制插件市场访问权限和插件安装模式。每位开发者可能还需要通过 MCP 提供商进行认证。

迁移现有 Team MCP¶

管理员可以将独立的 Team MCP 服务器关联到默认插件市场：

1. 打开 仪表盘 -> 集成和 MCP。
2. 找到 Team MCP 服务器。
3. 在迁移提示中选择 添加到团队插件市场。
4. 打开 仪表盘 -> 插件，查看默认插件市场、其访问权限和插件安装模式。

如有需要，Cursor 会创建默认插件市场，并将现有 MCP 服务器关联到该市场。这些服务器仍可供云端代理使用，团队成员也可以选择在本地安装和配置它们。

从插件市场移除已关联的 MCP 插件，或删除该插件市场，
都可能导致 Team MCP 服务器被删除。这会使本地用户和云端
代理无法再使用该服务器。继续前请查看确认提示。

插件市场访问权限¶

默认情况下，团队插件市场对团队内所有成员开放。在 插件市场设置 -> 插件市场访问权限 中，管理员可以将插件市场的访问权限限制为选定的组织群组。只有同时属于插件市场所属团队和选定群组的成员才能访问。团队管理员仍可访问。

SCIM 如何运作？¶

组织群组可通过 SCIM 从您的身份提供商同步成员关系。您可在身份提供商中管理成员关系，Cursor 会将更新同步至组织群组。

现有的团队市场若使用团队级 SCIM 目录组，将保留该配置。Cursor 不会自动迁移这些分配关系。未使用组织群组的组织将继续使用 SCIM 目录组。

插件安装模式¶

设置插件市场访问权限后，选择向该受众提供各插件的方式：

• 默认关闭：开发者可以找到该插件，并选择是否安装。
• 默认开启：该插件会默认安装，但开发者可以选择不安装。
• 必需：该插件始终会自动安装，且无法卸载。

添加团队插件市场¶

按以下步骤将 GitHub 代码仓库导入为团队插件市场：

1. 前往 仪表盘 -> 插件。
2. 在 团队插件市场 中，点击 添加插件市场。
3. 按照说明从头创建插件市场；如需从 GitHub 导入，请使用“从仓库导入”。
4. 使用“添加到插件市场”添加并评审插件。
5. 在 插件市场设置 中，设置 插件市场访问权限，可选择启用自动刷新，然后保存。

可试用的示例代码仓库：

• fieldsphere/cursor-team-marketplace-template

让插件保持最新¶

从 GitHub 导入时，首次导入代码仓库会为插件建立索引。你可以通过以下两种方式刷新插件：

• 自动：开启 启用自动刷新，当向市场跟踪的分支推送更改时，插件会自动更新。这需要在代码仓库中安装 Cursor GitHub App。Cursor 最多每 10 分钟重新索引一次市场，并将短时间内的多次推送合并处理到最新提交。
• 手动：点击“刷新”手动更新。

对于通过“从代码仓库导入”创建的市场，自动刷新会在每次推送时重新读取完整清单，因此会自动识别代码仓库中新添加的插件。

对于单独添加插件的市场，自动刷新仅更新现有插件。请重新导入代码仓库 URL，以识别新添加的插件。

开发者如何找到团队插件市场¶

开发者可以在“自定义”中找到团队插件市场。

• 在侧边栏中打开 自定义
• 查找团队插件市场中的插件。
• 可直接在该面板安装“默认关闭”插件。
• “默认开启”插件会自动安装，但开发者可以选择不安装。
• 必需插件会自动安装，且无法卸载。
• 安装并配置插件市场 MCP 服务器，以便在代理窗口、IDE 和命令行界面中使用。

安装插件¶

可从插件市场安装 Agent Plugins 和 Cursor 插件。Cursor 会根据插件清单识别
格式，因此两者的安装流程相同：

1. 在侧边栏中打开 自定义。
2. 找到要使用的插件。
3. 选择 安装，然后选择项目或用户范围。

Agent Plugin 的根目录中包含 plugin.json 清单。Cursor 插件使用
.cursor-plugin/plugin.json 清单。团队插件市场可通过上述相同的访问和安装模式分发任一
格式。

开发插件时，也可以直接从 ~/.cursor/plugins/local 加载任一格式。请参阅本地测试插件。

MCP 应用深度链接¶

通过安装链接共享 MCP 服务器配置：

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIG

有关如何生成这些链接，请参阅 MCP 安装链接。

管理已安装的插件¶

在侧边栏中打开 自定义，即可在同一页面管理已安装的 Agent Plugins、Cursor
插件、MCP 服务器、规则和技能。可按用户、工作区或团队范围筛选，查看已安装的内容。

MCP 服务器¶

可在“自定义”中开启或关闭个人及团队分发的 MCP 服务器：

1. 在侧边栏中打开 自定义
2. 找到要更改的 MCP 服务器
3. 使用开关启用或禁用它

禁用的服务器不会加载，也不会在聊天中显示。

规则和技能¶

在“自定义”中管理规则和技能。可将单个规则切换为 始终、由智能体决定 或 手动 模式。技能显示在 由智能体决定 部分，也可在聊天中通过 /skill-name 手动调用。

使用 workspaceOpen 钩子¶

workspaceOpen 钩子可在打开工作区时返回要加载的插件路径。当插件集取决于工作区本身时，此功能非常有用。

钩子参考¶

通过 workspaceOpen 钩子脚本注册插件路径

创建插件¶

插件是包含清单及其组件的目录。若要打包可移植的技能和 MCP 服务器，请选择 Agent Plugins。
若还需要规则、agents、命令、钩子或变量等 Cursor 专属组件，请选择 Cursor 插件。

Agent Plugin¶

my-plugin/
├── plugin.json
├── skills/
│   └── code-reviewer/
│       └── SKILL.md
└── mcp.json

Agent Plugins 要求在根目录中提供包含该标准 schema 标识符的 plugin.json：

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "my-plugin",
  "description": "Portable code review tools",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

Cursor Plugin¶

my-plugin/
├── .cursor-plugin/
│   └── plugin.json
├── rules/
│   └── coding-standards.mdc
├── skills/
│   └── code-reviewer/
│       └── SKILL.md
└── mcp.json

Cursor 插件清单仅需 name。系统会从默认目录中发现组件；你也可以在清单中指定自定义路径。

{
  "name": "my-plugin",
  "description": "Custom development tools",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

可从 Cursor 插件模板仓库 开始，或阅读 Agent Plugins 编写指南
以创建 Agent Plugin。

在本地测试插件¶

发布前，从 ~/.cursor/plugins/local 加载任一种插件格式：

1. 为插件创建文件夹：
   ~/.cursor/plugins/local/my-plugin
2. 将插件文件复制到该文件夹中。Agent Plugin 应在根目录包含 plugin.json，Cursor 插件应包含 .cursor-plugin/plugin.json。
3. 重新启动 Cursor，或运行 Developer: Reload Window。
4. 验证插件组件是否已在 Cursor 中加载，例如规则、技能或 MCP 服务器。

为加快迭代速度，可为插件代码仓库创建符号链接：

ln -s /path/to/my-plugin ~/.cursor/plugins/local/my-plugin

插件准备就绪后，请前往 cursor.com/marketplace/publish 提交审核。
Cursor 插件可通过 .cursor-plugin/marketplace.json 支持多插件仓库。

有关完整的清单 schema、组件格式和提交检查清单，请参阅插件参考。

团队和企业版插件市场¶

升级以使用私有团队插件市场和全组织范围的插件分发。

常见问题¶

市场插件是否经过安全审核？¶

是。每个插件上架前都会经过人工审核。所有插件必须开源，我们也会在每次更新发布前进行审核。有关审查流程、更新评审及如何报告问题的详细信息，请参阅市场安全。

如何创建插件？¶

要创建可移植的 Agent Plugin，请在根目录添加 plugin.json 清单，并打包
技能或 MCP 服务器。要创建 Cursor 插件，请添加
.cursor-plugin/plugin.json 清单及所需的 Cursor 组件。
有关这两种格式的示例，请参阅插件参考。

Cursor 插件与 Agent Plugins 标准有什么关系？¶

Agent Plugins 是一项开放、厂商中立的规范，用于将技能和 MCP 服务器打包成可移植插件。Cursor 支持该标准，因此符合规范的插件无需修改即可在 Cursor 中加载。Cursor 插件则与之并行开发，并增加了规则、agents、命令、钩子和变量等 Cursor 专属组件。

相关内容¶

• 插件帮助信息