Xcode

Xcode 26.3+ menyediakan server MCP bawaan yang memberi Cursor akses langsung ke proyek Xcode Anda. Agent Cursor dapat membaca dan mengedit file, memicu build, menjalankan pengujian, menangkap pratinjau SwiftUI, dan mencari dokumentasi Apple—semuanya tanpa meninggalkan editor Anda.

Hal ini berfungsi melalui xcrun mcpbridge, biner yang disertakan Apple dengan Xcode untuk menerjemahkan pesan protokol MCP ke lapisan XPC internal Xcode. Anda cukup mengaturnya sekali, lalu Cursor memperlakukan 20 alat bawaan Xcode seperti server MCP lainnya.

Prasyarat

• macOS dengan Xcode 26.3 atau versi lebih baru yang telah diinstal
• Paket Cursor berbayar
• Proyek Xcode yang terbuka di Xcode (Xcode harus berjalan)

Aktifkan MCP di Xcode

Sebelum Cursor dapat terhubung, aktifkan bridge MCP di Xcode:

Siapkan Cursor

Pilih metode yang paling sesuai dengan alur kerja Anda.

Opsi 1: UI pengaturan MCP

Opsi 2: mcp.json

Tambahkan entri ke file konfigurasi MCP:

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

Opsi 3: Cursor CLI

Jika Anda menggunakan Cursor CLI, daftarkan server melalui terminal Anda:

agent mcp add xcode-tools -- xcrun mcpbridge

CLI menggunakan konfigurasi MCP yang sama dengan Editor, sehingga server tersedia di keduanya.

Alat yang tersedia

Xcode menyediakan 20 alat MCP yang terbagi dalam lima kategori:

Operasi file

• XcodeRead - Baca isi file (hingga 600 baris per panggilan, dengan offset/limit untuk file yang lebih besar)
• XcodeWrite - Buat atau timpa file
• XcodeUpdate - Terapkan edit terarah pada file yang sudah ada
• XcodeGrep - Cari isi file dengan regex
• XcodeGlob - Temukan file berdasarkan pola
• XcodeLS - Tampilkan isi direktori
• XcodeMakeDir - Buat direktori
• XcodeRM - Hapus file atau direktori
• XcodeMV - Pindahkan atau ubah nama file

Membangun dan menguji

• BuildProject - Bangun skema yang aktif
• GetBuildLog - Ambil log build, yang dapat difilter berdasarkan tingkat keparahan, regex, atau glob file
• RunAllTests - Jalankan seluruh suite pengujian
• RunSomeTests - Jalankan kelas atau metode pengujian tertentu
• GetTestList - Tampilkan daftar pengujian yang tersedia

Diagnostik

• XcodeListNavigatorIssues - Tampilkan peringatan dan error dari Issue Navigator
• XcodeRefreshCodeIssuesInFile - Periksa ulang issue kode dalam file

Intelligence

• RenderPreview - Ambil screenshot pratinjau SwiftUI
• DocumentationSearch - Pencarian semantik di dokumentasi Apple dan transkrip WWDC
• ExecuteSnippet - Jalankan cuplikan kode Swift

Workspace

• XcodeListWindows - Mencantumkan jendela dan tab Xcode yang terbuka

Contoh alur kerja

Alur kerja umum Cursor + Xcode adalah sebagai berikut:

1. Buka proyek Anda di Cursor dan Xcode
2. Minta agent Cursor untuk menambahkan fitur atau memperbaiki bug
3. Agent menggunakan XcodeRead dan XcodeGrep untuk memahami kode Anda
4. Agent mengedit file dengan XcodeWrite atau XcodeUpdate
5. Agent menjalankan BuildProject untuk memeriksa error, lalu membaca hasilnya dengan GetBuildLog
6. Agent menjalankan pengujian dengan RunSomeTests untuk memverifikasi perubahan
7. Agent membuat pratinjau SwiftUI dengan RenderPreview untuk mengonfirmasi UI

Anda tetap berada di Cursor sepanjang proses. Xcode menangani kompilasi, pengujian, dan pratinjau di latar belakang.

Cursor CLI dengan Xcode

Cursor CLI juga berfungsi dengan alat MCP Xcode. Ini berguna untuk alur kerja tanpa antarmuka grafis, pipeline CI, atau developer yang lebih sering menggunakan terminal.

# Jalankan agent dengan alat Xcode yang tersediaagent "Add unit tests for the NetworkManager class"

Agent mendeteksi server MCP xcode-tools dari config Anda dan menggunakan alat yang sama seperti yang tersedia di Editor.

Pemecahan masalah

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

xcrun --find mcpbridge

Terkait