《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 專屬組件。

相關內容¶

• 插件幫助信息