플러그인

플러그인은 규칙, 스킬, 에이전트, 명령어, MCP 서버, 훅을 배포 가능한 번들로 패키징합니다.

Cursor는 자체 플러그인 형식과 함께 Agent Plugins 오픈 표준을 지원합니다. 사용자 지정 페이지에서 플러그인을 설치하고 관리하거나 Cursor 마켓플레이스에서 공식 플러그인을 둘러보세요. 커뮤니티 플러그인과 MCP 서버는 cursor.directory에서 찾아볼 수 있습니다. 다른 개발자와 공유할 수 있도록 직접 만들 수도 있습니다.

플러그인에 포함할 수 있는 항목

플러그인에는 다음 구성 요소를 원하는 대로 조합하여 묶을 수 있습니다.

Agent Plugins 표준

플러그인은 에이전트가 사용할 수 있는 재사용 가능한 구성 요소를 제공합니다. Agent Plugins는 개별 스킬의 표준을 정의하는 Agent Skills와 마찬가지로, 이식 가능한 스킬과 MCP 서버를 패키징하기 위한 오픈 표준입니다. Cursor는 Cursor 플러그인과 함께 Agent Plugins를 지원합니다.

• Agent Plugins: 플러그인 루트에 plugin.json 매니페스트가 있는 명세 준수 플러그인으로, 스킬과 MCP 서버를 패키징합니다
• Cursor Plugins: .cursor-plugin/plugin.json 매니페스트가 있는 플러그인으로, 규칙, 에이전트, 명령, 훅 및 변수를 추가합니다

Agent Plugins 명세를 따르는 플러그인은 변경 없이 Cursor에서 로드됩니다. Cursor 플러그인은 표준과 병행해 계속 발전하므로 Cursor 전용 구성 요소와 마켓플레이스 기능은 지금처럼 계속 작동합니다.

자세한 내용은 agent-plugins.org에서 확인하거나 GitHub의 명세를 읽어보세요.

Cursor 플러그인 캔버스

이제 플러그인에서 팀이 열어 재사용할 수 있는 공유 설정 템플릿인 미리 만들어진 캔버스를 제공합니다.

• Hex Canvas — 데이터 시각화를 만듭니다. Cursor에서는 Hex Canvas로 분석 결과를 살펴보고 공유합니다.
• Atlassian Canvas — Jira 및 Confluence의 이슈, 프로젝트, 문서를 실시간으로 확인합니다.

처음부터 모든 것을 구성하는 대신 Customize에서 설치된 플러그인의 캔버스를 열어 안내에 따라 시작하세요.

마켓플레이스

Cursor 마켓플레이스에서는 공식 Cursor 플러그인을 찾아 설치할 수 있습니다. 플러그인은 Git 리포지토리 형태로 배포되며 Cursor 팀을 통해 제출됩니다.

모든 플러그인은 등록되기 전에 수동 검토를 거칩니다. 공식 플러그인은 cursor.com/marketplace에서 둘러보거나 사용자 지정에서 키워드로 검색하세요. 커뮤니티 플러그인과 MCP 서버는 cursor.directory에서 찾아보세요.

팀 마켓플레이스

팀 마켓플레이스는 팀 및 엔터프라이즈 요금제에서 사용할 수 있습니다. 하나의 마켓플레이스를 통해 Agent 플러그인과 Cursor 플러그인을 모두 배포할 수 있습니다.

• 팀 요금제: 팀 마켓플레이스 최대 1개
• 엔터프라이즈 요금제: 팀 마켓플레이스 무제한

팀 마켓플레이스를 무제한으로 이용하고 엔터프라이즈 관리 기능을 사용하려면 영업팀에 문의하세요.

팀 마켓플레이스를 관리하려면 대시보드 -> 플러그인을 여세요.

기본 팀 마켓플레이스

기본 팀 마켓플레이스는 Cursor 전반에서 공유 플러그인과 MCP 서버를 연결합니다. 관리자는 이미 클라우드 에이전트에서 사용할 수 있는 팀 MCP 서버를 추가한 후, 팀원이 Agent Window, IDE, CLI에서 같은 서버를 설치하고 구성할 수 있도록 제공할 수 있습니다.

기본 마켓플레이스에 팀 MCP 서버를 추가해도 모든 개발자에게 자동으로 설치되거나 활성화되지는 않습니다. 관리자는 계속해서 마켓플레이스 접근 권한과 플러그인 설치 모드를 제어합니다. 각 개발자는 MCP 제공업체에서 인증해야 할 수도 있습니다.

기존 팀 MCP 마이그레이션

관리자는 독립형 팀 MCP 서버를 기본 마켓플레이스에 연결할 수 있습니다.

1. 대시보드 -> 통합 및 MCP를 엽니다.
2. 팀 MCP 서버를 찾습니다.
3. 마이그레이션 안내에서 팀 마켓플레이스에 추가를 선택합니다.
4. 대시보드 -> 플러그인을 열어 기본 마켓플레이스와 해당 접근 권한, 플러그인 설치 모드를 검토합니다.

필요한 경우 Cursor가 기본 마켓플레이스를 생성하고 기존 MCP 서버를 연결합니다. 서버는 클라우드 에이전트에서 계속 사용할 수 있으며, 팀원은 로컬에서 이를 설치하고 설정할 수 있습니다.

마켓플레이스 접근

팀 마켓플레이스는 기본적으로 팀의 모든 멤버가 이용할 수 있습니다. Marketplace Settings -> Marketplace Access에서 관리자는 마켓플레이스 접근을 선택한 Organization Groups로 제한할 수 있습니다. 선택한 그룹에 속한 해당 팀의 멤버만 마켓플레이스에 접근할 수 있습니다. 팀 관리자는 계속 접근할 수 있습니다.

SCIM은 어떻게 작동하나요?

Organization Group은 SCIM을 통해 ID 공급자의 멤버십을 동기화할 수 있습니다. ID 공급자에서 멤버십을 관리하면 Cursor가 변경 사항을 Organization Group에 동기화합니다.

팀 단위 SCIM 디렉터리 그룹을 사용하는 기존 마켓플레이스는 해당 구성을 유지합니다. Cursor는 이러한 배정을 자동으로 마이그레이션하지 않습니다. Organization Group이 없는 조직은 계속해서 SCIM 디렉터리 그룹을 사용합니다.

플러그인 설치 모드

마켓플레이스 접근을 설정한 후, 대상별 플러그인 배포 방식을 선택합니다.

• 기본값: 사용 안 함: 개발자는 플러그인을 찾아 설치할지 선택할 수 있습니다.
• 기본값: 사용: 플러그인은 기본적으로 설치되지만, 개발자가 설치를 해제할 수 있습니다.
• 필수: 플러그인은 항상 설치되며 제거할 수 없습니다.

팀 마켓플레이스 추가

다음 절차에 따라 GitHub 리포지토리를 팀 마켓플레이스로 가져옵니다.

1. 대시보드 -> 플러그인으로 이동합니다.
2. Team Marketplaces에서 Add Marketplace를 클릭합니다.
3. 안내에 따라 새 마켓플레이스를 만들거나, GitHub에서 가져오는 경우 "리포지토리에서 가져오기"를 사용합니다.
4. "Add to Marketplace"를 사용하여 플러그인을 추가하고 리뷰합니다.
5. Marketplace Settings에서 Marketplace Access를 설정하고, 필요에 따라 Auto Refresh를 활성화한 후 저장합니다.

사용해 볼 수 있는 예시 리포지토리:

• fieldsphere/cursor-team-marketplace-template

플러그인을 최신 상태로 유지

GitHub에서 가져온 플러그인은 리포지토리를 처음 가져올 때 인덱싱됩니다. 플러그인을 새로 고치는 방법은 두 가지입니다.

• 자동: 마켓플레이스에서 추적하는 브랜치에 변경 사항이 푸시될 때마다 플러그인을 자동으로 업데이트하려면 자동 새로 고침 사용을 켭니다. 이 기능을 사용하려면 리포지토리에 Cursor GitHub App이 설치되어 있어야 합니다. Cursor는 마켓플레이스를 최대 10분에 한 번만 다시 인덱싱하며, 짧은 시간 내에 이루어진 여러 푸시는 최신 커밋으로 일괄 처리합니다.
• 수동: 수동으로 업데이트하려면 "새로 고침"을 클릭합니다.

개발자가 팀 마켓플레이스를 찾는 곳

개발자는 사용자 지정에서 팀 마켓플레이스를 찾을 수 있습니다.

• 사이드바에서 사용자 지정을 엽니다.
• 팀 마켓플레이스의 플러그인을 찾습니다.
• 해당 패널에서 기본값: 사용 안 함 플러그인을 직접 설치합니다.
• 기본값: 사용 플러그인은 자동으로 설치되지만, 개발자는 설치를 거부할 수 있습니다.
• 필수 플러그인은 자동으로 설치되며 제거할 수 없습니다.
• Agent Window, IDE, CLI에서 사용할 마켓플레이스 MCP 서버를 설치하고 구성합니다.

플러그인 설치

마켓플레이스에서 Agent 플러그인과 Cursor 플러그인을 설치할 수 있습니다. Cursor는 플러그인 매니페스트를 통해 형식을 감지하므로 두 형식의 설치 과정은 동일합니다.

1. 사이드바에서 사용자 지정을 엽니다.
2. 사용할 플러그인을 찾습니다.
3. 설치를 선택하고 프로젝트 또는 사용자 범위를 선택합니다.

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 서버를 켜거나 끌 수 있습니다.

1. 사이드바에서 사용자 정의를 엽니다
2. 변경하려는 MCP 서버를 찾습니다
3. 토글을 사용해 활성화하거나 비활성화합니다

비활성화된 서버는 로드되지 않으며 채팅에 표시되지 않습니다.

규칙 및 스킬

사용자 지정에서 규칙과 스킬을 관리하세요. 개별 규칙을 항상, Agent가 결정, 수동 모드로 전환할 수 있습니다. 스킬은 Agent가 결정 섹션에 표시되며, 채팅에서 /skill-name으로 수동 호출할 수 있습니다.

workspaceOpen 훅 사용

workspaceOpen 훅은 워크스페이스를 열 때 로드할 플러그인 경로를 반환할 수 있습니다. 플러그인 집합이 워크스페이스 자체에 따라 달라지는 경우에 유용합니다.

플러그인 생성

플러그인은 매니페스트와 구성 요소로 구성된 디렉터리입니다. 이식 가능한 스킬과 MCP 서버를 패키징하려면 Agent Plugins를 선택하세요. 규칙, 에이전트, 명령, 훅, 변수 등 Cursor 전용 구성 요소도 필요하다면 Cursor Plugins를 선택하세요.

my-plugin/├── plugin.json├── skills/│   └── code-reviewer/│       └── SKILL.md└── mcp.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 템플릿 리포지토리로 시작하거나, Agent Plugins 작성 가이드를 참고해 Agent 플러그인을 생성하세요.

로컬에서 플러그인 테스트

게시하기 전에 ~/.cursor/plugins/local에서 플러그인 형식 중 하나를 로드하세요:

1. 플러그인용 폴더를 만듭니다: ~/.cursor/plugins/local/my-plugin
2. 플러그인 파일을 해당 폴더에 복사합니다. Agent 플러그인의 경우 루트에 plugin.json을, Cursor 플러그인의 경우 .cursor-plugin/plugin.json을 포함하세요.
3. Cursor를 다시 시작하거나 Developer: Reload Window를 실행합니다.
4. 규칙, 스킬, MCP 서버 등 플러그인 구성 요소가 Cursor에서 로드되는지 확인합니다.

더 빠르게 반복하려면 플러그인 리포지토리에 심볼릭 링크를 만드세요:

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

플러그인이 준비되면 cursor.com/marketplace/publish에서 리뷰를 위해 제출하세요. Cursor 플러그인은 다중 플러그인 리포지토리에서 .cursor-plugin/marketplace.json을 사용할 수 있습니다.

전체 manifest 스키마, 구성 요소 형식, 제출 체크리스트는 플러그인 레퍼런스를 참고하세요.

FAQ