Xcode

Xcode 26.3+에는 Cursor가 Xcode 프로젝트에 직접 접근할 수 있는 기본 제공 MCP 서버가 포함되어 있습니다. Cursor의 Agent는 에디터를 벗어나지 않고도 파일을 읽고 편집하며, 빌드를 시작하고, 테스트를 실행하고, SwiftUI 미리보기를 캡처하고, Apple 문서를 검색할 수 있습니다.

이 기능은 MCP 프로토콜 메시지를 Xcode의 내부 XPC 계층으로 변환하는 Xcode 제공 바이너리 xcrun mcpbridge를 통해 작동합니다. 한 번 구성하면 Cursor는 Xcode의 기본 제공 도구 20개를 다른 MCP 서버와 마찬가지로 처리합니다.

사전 요구 사항

• Xcode 26.3 이상이 설치된 macOS
• 유료 Cursor 요금제
• Xcode에서 열린 Xcode 프로젝트(Xcode가 실행 중이어야 함)

Xcode에서 MCP 활성화

Cursor를 연결하려면 먼저 Xcode의 MCP 브리지를 활성화하세요.

Cursor 설정하기

워크플로에 맞는 방법을 선택하세요.

옵션 1: MCP 설정 UI

옵션 2: mcp.json

MCP 설정 파일에 항목을 추가합니다:

{  "mcpServers": {    "xcode-tools": {      "command": "xcrun",      "args": ["mcpbridge"]    }  }}

옵션 3: Cursor CLI

Cursor CLI를 사용하는 경우 터미널에서 서버를 등록하세요:

agent mcp add xcode-tools -- xcrun mcpbridge

CLI는 에디터와 동일한 MCP 설정를 사용하므로 서버가 ორივ에 표시됩니다.

사용 가능한 도구

Xcode는 다섯 가지 범주에 걸쳐 20개의 MCP 도구를 제공합니다:

파일 작업

• XcodeRead - 파일 내용 읽기(호출당 최대 600줄, 더 큰 파일은 offset/limit 사용)
• XcodeWrite - 파일 생성 또는 덮어쓰기
• XcodeUpdate - 기존 파일에 지정된 변경 사항 적용
• XcodeGrep - 정규식으로 파일 내용 검색
• XcodeGlob - 패턴으로 파일 찾기
• XcodeLS - 디렉터리 내용 나열
• XcodeMakeDir - 디렉터리 생성
• XcodeRM - 파일 또는 디렉터리 삭제
• XcodeMV - 파일 이동 또는 이름 변경

빌드 및 테스트

• BuildProject - 활성 스킴 빌드
• GetBuildLog - 심각도, 정규식 또는 파일 glob으로 필터링할 수 있는 빌드 로그 가져오기
• RunAllTests - 전체 테스트 모음 실행
• RunSomeTests - 특정 테스트 클래스 또는 메서드 실행
• GetTestList - 사용 가능한 테스트 목록 가져오기

진단

• XcodeListNavigatorIssues - 이슈 내비게이터의 경고 및 오류 표시
• XcodeRefreshCodeIssuesInFile - 파일의 코드 문제 다시 확인

지능

• RenderPreview - SwiftUI 미리보기의 스크린샷 캡처
• DocumentationSearch - Apple 문서 및 WWDC 대화 기록에서 시맨틱 검색
• ExecuteSnippet - Swift 코드 스니펫 실행

워크스페이스

• XcodeListWindows - 열려 있는 Xcode 창과 탭을 나열합니다

예시 워크플로

일반적인 Cursor + Xcode 워크플로는 다음과 같습니다.

1. Cursor와 Xcode에서 모두 프로젝트를 엽니다
2. Cursor의 Agent에게 기능을 추가하거나 버그를 수정해 달라고 요청합니다
3. Agent가 XcodeRead 및 XcodeGrep을 사용해 코드를 파악합니다
4. XcodeWrite 또는 XcodeUpdate로 파일을 편집합니다
5. BuildProject를 실행해 오류를 확인하고 GetBuildLog로 결과를 읽습니다
6. RunSomeTests로 테스트를 실행해 변경 사항을 검증합니다
7. RenderPreview로 SwiftUI 미리보기를 캡처해 UI를 확인합니다

전체 작업은 Cursor에서 진행됩니다. Xcode는 백그라운드에서 컴파일, 테스트, 미리보기를 처리합니다.

Xcode에서 사용하는 Cursor CLI

Cursor CLI는 Xcode의 MCP 도구와도 함께 사용할 수 있습니다. 그래픽 인터페이스 없이 작업하는 워크플로, CI 파이프라인, 터미널 중심 개발 환경에 유용합니다.

# Xcode 도구를 사용할 수 있도록 Agent 실행agent "Add unit tests for the NetworkManager class"

Agent는 구성에서 xcode-tools MCP 서버를 가져와 에디터에서 사용 가능한 동일한 도구를 사용합니다.

문제 해결

sudo xcode-select -s /Applications/Xcode.app/Contents/Developersudo xcodebuild -runFirstLaunch

xcrun --find mcpbridge

관련 문서