Cursor에 SkillGild 설정하기: 에이전트 스킬 연결 가이드
요약
본 가이드는 SkillGild를 Cursor에 연결하여 에이전트가 외부 스킬을 사용할 수 있도록 설정하는 방법을 안내합니다. CLI 설치 후 절대 실행 경로를 찾아 `mcp.json` 파일에 등록하고, 선택적 스킬 래퍼를 설치하면 됩니다.
핵심 포인트
- SkillGild CLI를 설치하고 로그인한 후, 절대 실행 경로를 확인해야 합니다.
- 프로젝트 또는 개인 설정의 `mcp.json` 파일에 SkillGild 서버 정보를 추가합니다.
- 선택적 스킬 래퍼는 에이전트가 호스팅되는 워크플로우를 인식하는 데 도움을 줍니다.
- 설정 후에는 MCP 제어판에서 연결 상태를 확인하고, 에이전트를 통해 스킬 사용을 요청할 수 있습니다.
SkillGild를 Cursor에 연결하려면, SkillGild CLI를 설치하고 로그인한 다음, 해당의 절대 실행 경로를 Cursor의 mcp.json 파일에 로컬 stdio 서버로 등록해야 합니다. ~/.cursor/skills/에 있는 선택적 스킬 래퍼(skill wrapper)는 에이전트가 언제 호스팅되는 워크플로우를 사용할지 인식하는 데 도움을 줍니다.
프로젝트 또는 개인 연결 선택하기
Cursor는 프로젝트 내의 .cursor/mcp.json과 개인 설정을 위한 ~/.cursor/mcp.json을 모두 지원합니다. 동일한 서버 이름이 두 곳에 나타날 경우, 프로젝트 설정이 우선권을 가집니다. 공식 Cursor MCP 가이드에서 구성 방법, 도구 승인 및 로그를 설명합니다.
연결을 모든 프로젝트에서 사용하고 싶다면 개인 설정을 사용하세요. 팀이 동일한 서버 정의가 필요할 때는 프로젝트 구성을 사용하세요. 각 팀원은 여전히 자신의 기기에서 로그인해야 하며, 아래의 설정에는 계정 자격 증명(account credential)이 포함되어 있지 않습니다.
SkillGild를 Cursor에 연결하기
1. CLI 설치 및 장치 승인
CLI 설치를 따르세요. 현재 방법은 Go 1.26 이상과 SkillGild 소스 체크아웃을 사용합니다. 그런 다음 다음 명령어를 실행하세요:
skillgild login
skillgild status
브라우저의 장치 코드를 확인하십시오. CLI는 자신의 자격 증명을 운영 체제의 자격 증명 저장소에 저장하며, MCP 프로세스가 이를 사용합니다.
2. 실행 파일 경로 찾기
macOS 또는 Linux의 경우:
command -v skillgild
Windows의 경우, where.exe skillgild를 사용하세요. 터미널 외부에서 실행된 애플리케이션은 다른 PATH를 가질 수 있으므로, 결과로 나온 절대 경로를 사용해야 합니다.
3. MCP 구성 추가하기
선택한 mcp.json 파일을 여세요. 기존의 mcpServers 객체에 skillgild 항목을 병합하여 다른 연결이 손상되지 않도록 하세요. 자리 표시자 명령어(placeholder command)를 실행 파일의 절대 경로로 대체하세요:
{
Windows 환경에서는 JSON 경로에 슬래시(`/`) 또는 이스케이프된 백슬래시(`\`)를 사용하세요. 파일을 저장하고 Cursor를 재시작합니다. MCP 제어판에서 연결을 확인하세요. 현재 인터페이스는 Customize를 통해 MCP를 노출합니다. 워크플로우를 시작할 때는 설정한 도구 승인 정책을 따르세요.
### 4. 선택적 Cursor 스킬 래퍼 설치하기
skillgild install logo-design --agent cursor
CLI는 `~/.cursor/skills/logo-design/SKILL.md` 파일을 작성합니다. Cursor의 [스킬 문서](https://prod.cursor.com/docs/skills)에서는 로컬 스킬 발견에 대해 설명하고 있습니다. 이 래퍼는 워크플로우를 식별하고 호출하는 방법을 알아내며, 호스팅되는 도구에는 MCP 연결이 필요합니다.
### 5. 에이전트에게 스킬 사용 요청하기
Use the SkillGild Logo Design skill for a fictional cycling club called North Loop. Start with three geometric concepts. Check one-color use and small sizes, and show the proposed files before finalizing them.
하이브리드 스킬의 경우, 에이전트는 세션을 시작하고 지침을 받은 다음, 필요한 곳에서 선언된 호스팅 도구를 호출하고 세션을 종료합니다. 프롬프트 스킬의 경우, `skillgild_run_skill`을 호출합니다. 현재 입력 및 접근 권한은 [Logo Design 목록](https://skillgild.dev/skills/logo-design)을 확인하세요.
## Cursor가 MCP 서버에 연결할 수 없는 경우
| 증상 | 확인 사항 |
| :--- | :--- |
| 서버 실행 파일을 찾을 수 없음 | 실제 절대 경로를 사용하고 터미널에서 `skillgild status`를 테스트하세요 |
| ... |
서버 로그의 경우, Cursor의 Output 패널을 열고 MCP Logs를 선택하세요. 스킬 목록에 나타나는 로컬 래퍼가 서버 연결을 확인해 주지는 않습니다. 접근 및 할당량 실패는 [SkillGild의 에이전트 오류 처리](https://skillgild.dev/docs/quickstart-agents#handle-errors)를 참조하세요.
이러한 설정 세부 정보는 Cursor 문서 및 SkillGild CLI를 기반으로 확인되었습니다. 인증된 작업은 여전히 계정 승인과 로컬 환경에 의존합니다.
## 워크플로우 또는 다른 클라이언트 선택하기
[호스팅 에이전트 스킬](https://skillgild.dev/skills)을 탐색하고, [스킬과 MCP](https://skillgild.dev/learn/agent-skills-vs-mcp)를 비교하거나, [Claude Code](https://skillgild.dev/learn/install-claude-code-skills) 및 [Codex CLI](https://skillgild.dev/learn/install-codex-skills) 가이드를 따르세요. [Claude Code 설치 가이드](https://skillgild.dev/learn/install-claude-code-skills)는 이러한 설정 경로들을 연결합니다.
_원래 게시됨: [skillgild.dev](https://skillgild.dev/learn/cursor-mcp-setup)._
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기