Плагины
Плагины объединяют правила, навыки, агентов, команды, MCP‑серверы и хуки в распространяемые пакеты.
Cursor поддерживает открытый стандарт Agent Plugins наряду с собственным форматом плагинов. Устанавливайте плагины и управляйте ими на странице Настройка или просматривайте официальные плагины в Cursor Marketplace. Плагины сообщества и MCP‑серверы можно найти на cursor.directory. Вы также можете создать собственный плагин и поделиться им с другими разработчиками.
Состав плагинов
Плагин может включать любую комбинацию следующих компонентов:
| Компонент | Доступно в | Описание |
|---|---|---|
| Правила | Плагины Cursor | Постоянные рекомендации для ИИ и стандарты кодирования (файлы .mdc) |
| Навыки | Оба формата | Специализированные возможности агентов для сложных задач |
| Агенты | Плагины Cursor | Конфигурации и промпты пользовательских агентов |
| Команды | Плагины Cursor | Файлы команд, выполняемых агентами |
| Серверы MCP | Оба формата | Интеграции Model Context Protocol |
| Хуки | Плагины Cursor | Скрипты автоматизации, запускаемые событиями |
Стандарт Agent Plugins
Плагины объединяют повторно используемые компоненты, доступные агенту. Agent Plugins — открытый стандарт упаковки переносимых навыков и MCP‑серверов, подобно тому как Agent Skills определяет стандарт для отдельных навыков. Cursor поддерживает Agent Plugins наряду с плагинами Cursor.
- Agent Plugins: плагины, соответствующие спецификации, с манифестом
plugin.jsonв корне плагина, включающие навыки и MCP‑серверы - Cursor Plugins: плагины с манифестом
.cursor-plugin/plugin.json, которые добавляют правила, агентов, команды, хуки и переменные
Плагин, соответствующий спецификации Agent Plugins, загружается в Cursor без изменений. Плагины Cursor продолжают развиваться параллельно со стандартом, поэтому специфичные для Cursor компоненты и функции маркетплейса работают как и прежде.
Подробнее — на agent-plugins.org или в спецификации на GitHub.
Canvas в плагинах Cursor
Теперь плагины включают готовые Canvas: общие шаблоны настройки, которые ваша команда может открывать и повторно использовать.
- Hex Canvas — создавайте визуализации данных. В Cursor мы используем Hex Canvas для анализа и обмена аналитикой.
- Atlassian Canvas — просматривайте в реальном времени задачи, проекты и документы из Jira и Confluence.
Откройте Canvas из установленного плагина в разделе Customize, чтобы получить готовую отправную точку вместо настройки всего с нуля.
Маркетплейс
Cursor Marketplace — здесь можно находить и устанавливать официальные плагины Cursor. Плагины распространяются в виде Git-репозиториев и публикуются через команду Cursor.
Каждый плагин проходит ручное ревью перед публикацией. Просматривайте официальные плагины на cursor.com/marketplace или ищите по ключевым словам в Customize. Плагины сообщества и MCP‑серверы доступны на cursor.directory.
Маркетплейсы команд
Маркетплейсы команд доступны на тарифах Teams и Enterprise. Через один маркетплейс в них можно распространять плагины Agent и плагины Cursor.
- Тариф Teams: до 1 маркетплейса команды
- Тариф Enterprise: неограниченное количество маркетплейсов команд
Свяжитесь с отделом продаж, чтобы получить неограниченное количество маркетплейсов команд и доступ к административным настройкам Enterprise.
Откройте Dashboard -> Plugins, чтобы управлять маркетплейсами команд.
На тарифах Enterprise добавлять маркетплейсы команд в Dashboard -> Plugins могут только администраторы.
Стандартный командный маркетплейс
Стандартный командный маркетплейс объединяет общие плагины и MCP‑серверы в Cursor. Администраторы могут добавлять командные MCP‑серверы, уже доступные Cloud Agents, а затем предоставлять участникам команды возможность устанавливать и настраивать эти серверы в окне Agent, IDE и CLI.
Добавление командного MCP‑сервера в стандартный маркетплейс не означает, что он будет установлен или включён для всех разработчиков. Администраторы по-прежнему управляют доступом к маркетплейсу и режимами установки плагинов. Каждому разработчику также может потребоваться пройти аутентификацию у поставщика MCP.
Перенос существующих командных MCP
Администраторы могут привязать автономные командные MCP‑серверы к маркетплейсу по умолчанию:
- Откройте Dashboard -> Integrations & MCP.
- Найдите Team MCP Servers.
- В окне переноса выберите Add to Team Marketplace.
- Откройте Dashboard -> Plugins, чтобы проверить маркетплейс по умолчанию, доступ к нему и режимы установки плагинов.
При необходимости Cursor создаст маркетплейс по умолчанию и привяжет к нему существующие MCP‑серверы. Серверы останутся доступны облачным агентам, а участники команды смогут устанавливать и настраивать их локально.
Удаление связанного MCP‑плагина из маркетплейса или самого маркетплейса может привести к удалению командного MCP‑сервера. Он станет недоступен локальным пользователям и облачным агентам. Перед продолжением проверьте сообщение с подтверждением.
Доступ к маркетплейсу
По умолчанию маркетплейсы команд доступны всем участникам команды. В разделе Настройки маркетплейса -> Доступ к маркетплейсу администраторы могут ограничить доступ к маркетплейсу выбранными группами организации. Доступ получат только участники команды маркетплейса, входящие в одну из выбранных групп. Администраторы команды сохраняют доступ.
Как работает SCIM?
Группы организации могут синхронизировать участников с вашим провайдером идентификации через SCIM. Управляйте составом участников в провайдере идентификации, а Cursor синхронизирует изменения с группой организации.
Существующие маркетплейсы, использующие группы SCIM-каталога на уровне команды, сохраняют эту конфигурацию. Cursor не переносит эти назначения автоматически. Организации без групп организации продолжают использовать группы SCIM-каталога.
Режимы установки плагинов
После настройки доступа к маркетплейсу выберите способ распространения каждого плагина среди этой аудитории:
- По умолчанию отключено: Разработчики могут найти плагин и сами решить, устанавливать ли его.
- По умолчанию включено: Плагин устанавливается по умолчанию, но разработчики могут отказаться от его установки.
- Обязательно: Плагин устанавливается всегда, и его нельзя удалить.
Добавление маркетплейса команды
Чтобы импортировать репозиторий GitHub в качестве маркетплейса команды, выполните следующие действия:
- Перейдите в Dashboard -> Plugins.
- В разделе Team Marketplaces нажмите Add Marketplace.
- Следуйте инструкциям, чтобы создать маркетплейс с нуля, или выберите «Import from Repo» для импорта из GitHub.
- Добавляйте плагины и проверяйте их с помощью «Add to Marketplace».
- В разделе Marketplace Settings задайте Marketplace Access, при необходимости включите Auto Refresh и сохраните изменения.
Пример репозитория:
Поддерживайте плагины в актуальном состоянии
При импорте из GitHub плагины индексируются при первом импорте репозитория. Обновить плагины можно двумя способами:
- Автоматически: Включите Enable Auto Refresh, чтобы плагины автоматически обновлялись при каждом push изменений в ветку, которую отслеживает маркетплейс. Для этого в репозитории должно быть установлено приложение Cursor для GitHub. Cursor переиндексирует маркетплейс не чаще одного раза в 10 минут, объединяя несколько быстрых push в один с последним коммитом.
- Вручную: Нажмите «Refresh», чтобы обновить плагины вручную.
Для маркетплейсов, созданных с помощью «Import from Repo», Auto Refresh при каждом push повторно считывает весь манифест, поэтому новые плагины, добавленные в репозиторий, подхватываются автоматически.
Для маркетплейсов, в которых плагины добавлялись по отдельности, Auto Refresh обновляет только существующие плагины. Повторно импортируйте URL репозитория, чтобы добавить новые плагины.
Где разработчики могут найти маркетплейсы команды
Разработчики могут найти маркетплейсы команды в разделе Customize.
- Откройте Customize на боковой панели.
- Найдите плагины из маркетплейса вашей команды.
- Устанавливайте плагины Default Off прямо с этой панели.
- Плагины Default On устанавливаются автоматически, но разработчики могут отказаться от них.
- Обязательные плагины устанавливаются автоматически, и их нельзя удалить.
- Установите и настройте MCP‑серверы маркетплейса для использования в окне Agent, IDE и CLI.
Установка плагинов
Устанавливайте плагины Agent и Cursor из маркетплейса. Cursor определяет формат по манифесту плагина, поэтому процесс установки одинаков для обоих форматов:
- Откройте Настроить на боковой панели.
- Найдите нужный плагин.
- Выберите Установить и укажите область действия: проект или пользователь.
Плагин Agent содержит манифест plugin.json в корневом каталоге. Плагин Cursor содержит
манифест .cursor-plugin/plugin.json. Маркетплейсы команд могут распространять оба
формата, используя те же режимы доступа и установки, описанные выше.
Во время разработки плагина также можно загрузить любой формат напрямую из ~/.cursor/plugins/local.
См. Тестирование плагинов локально.
Диплинки для MCP Apps
Делитесь конфигурациями серверов MCP через ссылки для установки:
cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_ENCODED_CONFIGПодробнее о создании этих ссылок см. в разделе Ссылки для установки MCP.
Управление установленными плагинами
Откройте Настройка на боковой панели, чтобы управлять на одной странице установленными плагинами Agent и Cursor, MCP‑серверами, правилами и навыками. Отфильтруйте по области действия пользователя, рабочего пространства или команды, чтобы увидеть, что установлено.
MCP‑серверы
В разделе «Настроить» можно включать и отключать личные MCP‑серверы и MCP‑серверы, предоставленные команде:
- Откройте Настроить на боковой панели
- Найдите MCP‑сервер, который хотите изменить
- С помощью переключателя включите или отключите его
Отключённые серверы не загружаются и не отображаются в чате.
Правила и навыки
Управляйте правилами и навыками в разделе Customize. Для каждого правила можно выбрать режим: Всегда, Agent решает или Вручную. Навыки отображаются в разделе Agent решает; их можно вручную вызвать в чате с помощью /skill-name.
Использование хука workspaceOpen
Хук workspaceOpen может возвращать пути к плагинам, которые нужно загрузить при открытии рабочего пространства. Это полезно, если набор плагинов зависит от самого рабочего пространства.
Справочник по хукам
Регистрация путей к плагинам из скрипта хука workspaceOpen
Создание плагинов
Плагин — это каталог с манифестом и компонентами. Выбирайте Agent Plugins, если хотите объединить в пакет переносимые навыки и MCP‑серверы. Выбирайте Cursor Plugins, если вам также нужны специфичные для Cursor компоненты: правила, агенты, команды, хуки или переменные.
my-plugin/├── plugin.json├── skills/│ └── code-reviewer/│ └── SKILL.md└── mcp.jsonДля Agent Plugins требуется корневой файл 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 или прочитайте руководство по созданию Agent Plugins, чтобы создать плагин Agent.
Локальное тестирование плагинов
Перед публикацией загрузите плагин любого формата из ~/.cursor/plugins/local:
- Создайте папку для плагина:
~/.cursor/plugins/local/my-plugin - Скопируйте файлы плагина в эту папку. Добавьте корневой
plugin.jsonдля плагина Agent или.cursor-plugin/plugin.jsonдля плагина Cursor. - Перезапустите Cursor или выполните Developer: Reload Window.
- Убедитесь, что компоненты плагина — например, правила, навыки или MCP‑серверы — загружаются в Cursor.
Чтобы быстрее вносить изменения, создайте символическую ссылку на репозиторий плагина:
ln -s /path/to/my-plugin ~/.cursor/plugins/local/my-pluginКогда плагин будет готов, отправьте его на ревью через cursor.com/marketplace/publish.
Плагины Cursor могут использовать .cursor-plugin/marketplace.json в репозиториях с несколькими плагинами.
Полную схему манифеста, форматы компонентов и чек-лист для отправки см. в справочнике по плагинам.
Маркетплейсы для команд и Enterprise
Обновите тарифный план, чтобы получить приватные маркетплейсы для команд и распространять плагины по всей организации.
Часто задаваемые вопросы
Да. Каждый плагин проходит ручную проверку перед публикацией. Все плагины должны иметь открытый исходный код, и мы проверяем каждое обновление перед публикацией. Подробнее о проверке, ревью обновлений и отправке сообщений о проблемах см. в разделе Безопасность маркетплейса.
Для переносимого плагина Agent добавьте корневой манифест plugin.json и включите
навыки или MCP‑серверы. Для плагина Cursor добавьте
манифест .cursor-plugin/plugin.json и нужные компоненты Cursor.
Примеры обоих форматов см. в справочнике по плагинам.
Agent Plugins — открытая, независимая от поставщиков спецификация для упаковки навыков и MCP‑серверов в переносимые плагины. Cursor поддерживает этот стандарт, поэтому плагины, соответствующие спецификации, загружаются в Cursor без изменений. Плагины Cursor разрабатываются параллельно и добавляют компоненты, специфичные для Cursor, например правила, агенты, команды, хуки и переменные.