AI 程式設計教學中文版
官方教學中文版整合與 SDK

Xcode 整合

基於 Cursor 官方 Xcode integration 文件解釋 Xcode 26.3+ MCP bridge、xcrun mcpbridge、20 個 tools、CLI 和排障。

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
Xcode 整合integration在 Xcode 裡用 Cursor 協助。
工作流配合workflow和 Xcode 開發流程的配合。
限制limits整合的能力邊界。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你在 Xcode 開發裡配好 Cursor 整合。

你是 Cursor Xcode 整合顧問。

【角色】
Cursor Xcode 整合顧問，按最小夠用和安全優先的原則給可落地的方案。

【輸入】
- 我的 Xcode 專案型別：___
- 想讓 Cursor 協助什麼：___
- 現有開發流程：___
- 遇到的問題：___

【工作流程】
1. 給 Xcode 整合方式
2. 說明能配合和不能配合的部分
3. 設定常用協助
4. 給驗證和排障

【輸出規範】
▌一、整合方式
▌二、能 / 不能配合的部分
▌三、常用協助設定
▌四、驗證 + 排障

【硬約束】
- 如實說明整合的能力邊界，不誇大
- Apple 平臺特定操作在真機 / 模擬器驗證
- 改動可回復
- 不要替我臆測情況或編造不存在的能力，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例，不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述

Xcode 26.3+ 提供內建 MCP server，Cursor 可以透過它直接訪問 Xcode projects。

閱讀目標：讀完本章，你應該能把 Xcode 的 MCP bridge 接入 Cursor，並知道 agent 能做哪些 iOS/macOS 開發動作、哪些錯誤該怎麼排。

1. 工作方式

Apple 在 Xcode 中提供 xcrun mcpbridge。它把 MCP protocol messages 轉換到 Xcode 的內部 XPC layer，讓 Cursor 像使用其他 MCP server 一樣呼叫 Xcode tools。

flowchart LR
  Cursor["Cursor / Cursor CLI"] --> MCP["MCP stdio server"]
  MCP --> Bridge["xcrun mcpbridge"]
  Bridge --> Xcode["Running Xcode project"]
  Xcode --> Build["Build / tests / previews / docs"]

前提是 Xcode 正在執行並開啟了專案。空視窗或沒開啟 workspace 時，很多工具沒有上下文。

2. 前置條件

條件要求
macOS安裝 Xcode 26.3 或更高
Cursorpaid Cursor plan
Xcode project專案必須在 Xcode 中開啟，Xcode 必須執行
MCP bridgeXcode Settings -> Intelligence 中開啟 Xcode Tools

如果 Xcode 設定裡沒有 MCP 選項，先檢查版本。官方目前要求 Xcode 26.3+。

3. 開啟 Xcode MCP

在 Xcode 中：

  1. 開啟 Xcode -> Settings -> Intelligence。
  2. 在 Model Context Protocol 下啟用 Xcode Tools。

在 Cursor 中有三種設定方式：

方式操作
MCP settings UICursor Settings -> Features -> MCP -> Add New MCP Server
mcp.json新增 xcode-tools，command 用 xcrun，args 用 mcpbridge
Cursor CLI執行 agent mcp add xcode-tools -- xcrun mcpbridge

CLI 和 editor 共享 MCP config，所以用 CLI 新增後，editor 裡也能看到。

4. 20 個內建 tools

Xcode 暴露 20 個 MCP tools，分五類。

類別Tools
File operationsXcodeRead、XcodeWrite、XcodeUpdate、XcodeGrep、XcodeGlob、XcodeLS、XcodeMakeDir、XcodeRM、XcodeMV
Build and testBuildProject、GetBuildLog、RunAllTests、RunSomeTests、GetTestList
DiagnosticsXcodeListNavigatorIssues、XcodeRefreshCodeIssuesInFile
IntelligenceRenderPreview、DocumentationSearch、ExecuteSnippet
WorkspaceXcodeListWindows

其中 XcodeRead 單次最多讀取 600 行，較大檔案要用 offset / limit 分段。

5. 典型工作流

一次穩定的 Cursor + Xcode 工作流：

  1. 同時在 Cursor 和 Xcode 中開啟專案。
  2. 讓 agent 新增功能或修 bug。
  3. agent 用 XcodeRead / XcodeGrep 理解程式碼。
  4. agent 用 XcodeWrite / XcodeUpdate 修改檔案。
  5. agent 執行 BuildProject。
  6. agent 用 GetBuildLog 檢視錯誤。
  7. agent 用 RunSomeTests 驗證目標測試。
  8. UI 改動時，用 RenderPreview 抓 SwiftUI preview。

Xcode 負責編譯、測試和預覽，Cursor 負責 agent 推理、編輯和任務編排。

6. Cursor CLI with Xcode

Cursor CLI 也可以使用同一個 xcode-tools MCP server。

適合：

  • terminal-first 開發者。
  • headless workflows。
  • CI 前的本地自動驗證。
  • 讓 agent 針對某個類或測試執行一次小任務。

注意：Xcode MCP 仍依賴正在執行的 Xcode session。完全無 GUI 的 CI 不一定滿足這個前提。

7. 常見排障

問題處理
Cursor 找不到 xcode-tools確認 Xcode 正在執行並開啟專案
missing tabIdentifier確認開啟的是 project / workspace，不是空視窗
build / test timeout到 Xcode 看底層構建是否仍在執行，大專案可能只是耗時
Xcode settings 沒有 MCP toggle檢查 Xcode 版本是否為 26.3+
xcrun 找不到 mcpbridge用 xcode-select 指向完整 Xcode，而不是 Command Line Tools

如果系統指向 Command Line Tools，需要切到完整 Xcode Developer 目錄，再執行 first launch，並確認 xcrun --find mcpbridge 返回路徑。

8. 商業級驗收

上線前至少確認：

  • Xcode 版本和 MCP toggle 可見。
  • Cursor MCP settings 中 xcode-tools 連線正常。
  • agent 能讀取目前專案檔案。
  • agent 能執行一次 build 並讀取 build log。
  • agent 能執行目標測試或列出測試。
  • SwiftUI 專案能抓 preview。
  • 大專案 timeout 和記錄路徑寫進 SOP。
  • 破壞性工具如 XcodeRM、XcodeMV 的使用邊界明確。

官方來源

接下來去哪

TypeScript SDK

繼續學習用 SDK 把 Cursor 能力接入自己的工具。

MCP

回看 MCP server 設定和許可權邊界。

JetBrains 整合

基於 Cursor 官方 JetBrains integration 文件解釋 ACP、AI Assistant、安裝、認證、能力、定價和遷移邊界。

TypeScript SDK

基於 Cursor 官方 TypeScript SDK 文件解釋 local/cloud runtimes、Agent/Run、streaming、MCP、subagents、hooks、artifacts 和 errors。

本頁目錄

1. 工作方式2. 前置條件3. 開啟 Xcode MCP4. 20 個內建 tools5. 典型工作流6. Cursor CLI with Xcode7. 常見排障8. 商業級驗收官方來源接下來去哪