Xcode

Xcode 26.3+ включает встроенный сервер MCP, который предоставляет Cursor прямой доступ к вашим проектам Xcode. Agent Cursor может читать и редактировать файлы, запускать сборки и тесты, создавать предпросмотры SwiftUI и искать документацию Apple — и всё это не выходя из редактора.

Это работает через xcrun mcpbridge — исполняемый файл, поставляемый Apple вместе с Xcode, который преобразует сообщения протокола MCP во внутренний слой XPC Xcode. Его достаточно настроить один раз, после чего Cursor использует 20 встроенных инструментов Xcode как любой другой сервер MCP.

Необходимые условия

• macOS с установленной Xcode 26.3 или более поздней версии
• Платный тариф Cursor
• Открытый в Xcode проект Xcode (Xcode должна быть запущена)

Включите MCP в Xcode

Чтобы Cursor мог подключиться, включите MCP-мост в Xcode:

Настройте Cursor

Выберите способ, который лучше всего подходит для вашего рабочего процесса.

Вариант 1: интерфейс настроек MCP

Вариант 2: mcp.json

Добавьте запись в файл конфигурации MCP:

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

Вариант 3: CLI Cursor

Если вы используете CLI Cursor, зарегистрируйте сервер в Терминале:

agent mcp add xcode-tools -- xcrun mcpbridge

CLI использует ту же конфигурацию MCP, что и редактор, поэтому сервер отображается в обоих местах.

Доступные инструменты

Xcode предоставляет 20 инструментов MCP, разделённых на пять категорий:

Файловые операции

• XcodeRead — Чтение содержимого файлов (до 600 строк за вызов; для больших файлов доступны смещение и лимит)
• 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. Попросите Agent Cursor добавить функцию или исправить баг
3. Agent использует XcodeRead и XcodeGrep, чтобы разобраться в вашем коде
4. Он редактирует файлы с помощью XcodeWrite или XcodeUpdate
5. Он запускает BuildProject для проверки на ошибки и читает результаты через GetBuildLog
6. Он запускает тесты с помощью RunSomeTests, чтобы проверить изменения
7. Он создаёт предпросмотр SwiftUI с помощью RenderPreview, чтобы проверить UI

При этом вы всё время работаете в Cursor. Xcode выполняет компиляцию, тестирование и создание предпросмотров в фоновом режиме.

CLI Cursor с Xcode

CLI Cursor также поддерживает MCP-инструменты Xcode. Это полезно для сценариев работы без графического интерфейса, CI-конвейеров и разработчиков, предпочитающих терминал.

# Запустите Agent с доступом к инструментам Xcodeagent "Add unit tests for the NetworkManager class"

Agent получает сервер MCP xcode-tools из вашей конфигурации и использует те же инструменты, что доступны в Редакторе.

Устранение неполадок

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

xcrun --find mcpbridge

Связанные материалы