Cursor AI 세팅 가이드 — Rules, MCP, Agent 모드까지 (2026)

Cursor AI 설치/설정 완벽 가이드 (2026)

AI 코딩 에디터, 제대로 세팅하고 시작하기

IDE Cursor 가이드

Cursor AI란?

Cursor는 VS Code를 기반으로 만들어진 AI 네이티브 코드 에디터입니다. VS Code의 익숙한 UI 위에 AI 기능이 깊게 통합되어, 코드 작성부터 리팩토링, 디버깅까지 AI와 함께 작업할 수 있습니다.

• Tab 자동완성 — 단순 완성이 아닌 다음 편집까지 예측
• Cmd+K 인라인 편집 — 코드 블록을 선택하고 자연어로 수정 지시
• Agent 모드 — 여러 파일을 동시에 생성/수정하고 터미널 명령까지 실행
• Rules 시스템 — 프로젝트별 AI 행동 규칙을 정의
• MCP 연동 — 외부 도구(DB, GitHub, Figma 등) 통합

설치 방법

cursor.com에서 OS에 맞는 설치 파일을 다운로드합니다.

OS	파일 형식	최소 요구사항
Windows 10/11	.exe	64-bit, RAM 4GB+
macOS 10.15+	.dmg	Intel / Apple Silicon
Linux	.AppImage	Ubuntu 20.04+

설치 후 실행하면 계정 생성/로그인 화면이 나타납니다. VS Code 확장을 가져올지 묻는 화면에서 기존 VS Code 설정을 그대로 임포트할 수 있습니다.

핵심 설정: Rules 시스템

Cursor의 AI 행동을 제어하는 가장 중요한 설정입니다. CLAUDE.md와 비슷한 역할을 합니다.

주의: 예전의 .cursorrules 파일은 deprecated 상태입니다. 현재 권장 방식은 .cursor/rules/ 디렉토리에 .mdc 파일로 관리하는 것입니다.

Rules의 두 가지 범위

구분	위치	용도
User Rules	Settings > General > Rules for AI	모든 프로젝트에 적용할 개인 스타일
Project Rules	.cursor/rules/*.mdc	프로젝트별 팀 공유 규칙 (Git 커밋)

.mdc 파일 작성법

---
description: 프론트엔드 코드 작성 규칙
globs: "**/*.tsx"
alwaysApply: false
---

# 프론트엔드 규칙

- TypeScript strict 모드 사용
- 컴포넌트는 함수형으로 작성
- Tailwind CSS 클래스 사용, 인라인 스타일 금지
- 공통 컴포넌트는 components/ui/ 폴더에서 재사용

Rule 활성화 타입 (4가지)

타입	설명	권장 비중
Always	항상 활성화. 컨텍스트를 소모하므로 최소한으로	~10%
Auto Attached	globs 패턴에 매칭되면 자동 활성화	~80%
Agent Requested	AI가 필요하다고 판단하면 자동 활성화	~5%
Manual	사용자가 명시적으로 호출해야 활성화	~5%

추천 디렉토리 구조

.cursor/rules/
├── core.mdc          # 프로젝트 전반 규칙 (Always)
├── frontend.mdc      # 프론트엔드 (Auto Attached: **/*.tsx)
├── backend.mdc       # 백엔드 (Auto Attached: **/*.java)
├── testing.mdc       # 테스트 규칙 (Auto Attached: **/*.test.*)
└── api-design.mdc    # API 설계 규칙 (Agent Requested)

핵심 포인트: 규칙을 주제별 .mdc 파일로 분리하면 필요한 상황에서만 활성화되어 컨텍스트를 효율적으로 사용할 수 있습니다. 단일 파일에 모든 규칙을 넣는 것보다 훨씬 효과적입니다.

모델 설정

Cursor는 다양한 AI 모델을 지원하며 대화별로 모델을 전환할 수 있습니다.

모델	특징	추천 용도
Claude Sonnet 4.5	빠르고 안정적	일상 코딩 (기본값 추천)
Claude Opus 4	깊은 추론 능력	아키텍처 설계, 대규모 리팩토링
GPT-4o	범용 올라운더	로직 집약적 작업
Gemini 2.5 Pro	긴 컨텍스트 윈도우	대규모 코드베이스 분석
Auto	작업 복잡도에 따라 자동 선택	모델 고민하기 싫을 때

MCP 서버 연동

MCP(Model Context Protocol)를 통해 외부 도구를 Cursor에 연결할 수 있습니다.

설정 방법

UI: Cursor Settings > Tools & Integrations > New MCP Server

파일: 아래 위치에 JSON 파일로 직접 설정할 수도 있습니다.

범위	파일 경로
전역 (모든 프로젝트)	~/.cursor/mcp.json
프로젝트 전용	프로젝트/.cursor/mcp.json

설정 파일 예시

// .cursor/mcp.json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    }
  }
}

주요 기능 & 단축키

기능	단축키 (Mac / Win)	설명
Tab 자동완성	Tab	다음 편집을 예측하여 코드 제안. 부분 수락은 Cmd+→
인라인 편집	Cmd+K / Ctrl+K	선택한 코드를 자연어로 수정 지시
AI 채팅	Cmd+L / Ctrl+L	사이드 패널에서 코드 질문, 디버깅 상담
Agent (Composer)	Cmd+I / Ctrl+I	여러 파일 동시 수정 + 터미널 명령 실행
Agent 전체화면	Cmd+Shift+I / Ctrl+Shift+I	Agent를 전체 화면으로 사용
변경 적용/거절	Cmd+Enter / Cmd+Backspace	AI가 제안한 코드 변경을 수락 또는 되돌리기

@ 멘션으로 컨텍스트 지정하기

채팅이나 Agent에서 @를 입력하면 AI에게 참조할 컨텍스트를 지정할 수 있습니다.

@filename	특정 파일 참조
@folder	폴더 전체 참조
@codebase	전체 코드베이스 검색
@web	인터넷 실시간 검색
@docs	외부 문서 URL 참조
@git	최근 Git 변경사항 참조

요금제

플랜	월 요금	주요 내용
Hobby	무료	제한된 Agent 요청, 제한된 Tab 완성
Pro	$20	무제한 Tab 완성, 확장된 Agent 한도
Pro+	$60	Pro + 3배 모델 크레딧
Ultra	$200	Pro + 20배 크레딧, 신기능 우선 접근

추천: 개인 개발자라면 Pro($20)로 시작하는 것을 추천합니다. 무제한 Tab 완성만으로도 체감이 큽니다.

흔한 문제 해결

VS Code 확장이 작동하지 않음

Cursor는 VS Code 기반이지만 별도 앱입니다. 일부 확장은 Cursor 마켓플레이스에서 별도로 설치해야 합니다. VS Code에서 임포트 기능을 사용하면 대부분 자동으로 가져옵니다.

.cursorrules가 무시됨

.cursorrules는 deprecated 상태입니다. .cursor/rules/ 디렉토리에 .mdc 파일로 마이그레이션하세요.

Agent가 터미널 명령을 실행하지 않음

기본적으로 Agent는 터미널 명령 실행 전 확인을 요청합니다. 자동 실행을 원하면 Settings > Features에서 YOLO 모드를 활성화하세요. (주의: 검증 없이 실행되므로 신중하게 사용)

AI 응답이 부정확하거나 컨텍스트를 못 읽음

@filename이나 @codebase로 참조할 파일을 명시적으로 지정해주면 정확도가 크게 올라갑니다.