AI 코딩 도구에 쌓아둔 설정(스킬, 훅, MCP, 권…

Claude Code → Cursor 마이그레이션 가이드

1. 사전 이해: 구조 차이

• Claude Code는 스킬(파일 단위), 훅(이벤트 콜백), MCP, 권한을 .claude/ 설정으로 관리
• Cursor는 규칙(.cursor/rules/), MCP(mcp.json), 권한(설정 UI) 중심이며 훅 개념이 없어 수동 대체 필요

2. 스킬 12개 이전

• 각 스킬의 마크다운 내용을 .cursor/rules/*.mdc 파일로 변환
• 스킬 발동 조건(description)은 globs 또는 alwaysApply, description 필드로 대체
• 자주 쓰는 스킬은 규칙, 나머지는 프로젝트 문서화 후 참조 방식 권장

3. 훅 5개 대체

• Cursor에는 네이티브 훅이 없음. 대안:
• 포맷/린트 훅 → Cursor의 "Format on Save" + 저장 시 규칙 지시
• 사전/사후 검증 훅 → CI 스크립트 or 별도 CLI 래퍼로 이관
• 나머지는 기능별로 규칙 텍스트에 "반드시 ~ 실행" 지시문으로 흡수

4. MCP 설정 이관 (Notion·GitHub 포함)

• Claude Code의 mcp 설정(JSON)을 Cursor의 ~/.cursor/mcp.json으로 복사
• stdio 방식은 대부분 호환되며, 서버별 환경변수(API 키) 재설정 필요
• 이후 Cursor 설정 → MCP에서 서버 활성화 및 상태 확인

5. 권한 규칙 이전

• Claude Code의 allow/deny 목록은 Cursor에서 직접 매핑 불가
• 대안: 설정에서 자동 실행 허용 도구 범위 조정 + 프로젝트 규칙에 "금지 작업" 명시

6. 검증 체크리스트

• [ ] MCP 서버 연결 상태 정상 여부
• [ ] 규칙 12개가 실제 응답에 반영되는지 테스트 질의
• [ ] 훅 대체 동작(포맷·검증) 수동 확인
• [ ] 민감 정보(.env 등) 접근 차단 동작 확인

핵심 요약: 스킬·MCP는 파일 변환으로 대부분 이전 가능하나, 훅과 세밀한 권한은 Cursor의 구조에 맞게 재설계가 필요합니다.