Xcode

O Xcode 26.3+ inclui um servidor MCP integrado que dá ao Cursor acesso direto aos seus projetos do Xcode. O agente do Cursor pode ler e editar arquivos, acionar builds, executar testes, capturar prévias do SwiftUI e pesquisar a documentação da Apple, tudo sem sair do Editor.

Isso funciona por meio do xcrun mcpbridge, um binário distribuído pela Apple com o Xcode que traduz mensagens do protocolo MCP para a camada XPC interna do Xcode. Você o configura uma vez, e o Cursor trata as 20 ferramentas integradas do Xcode como qualquer outro servidor MCP.

Pré-requisitos

• macOS com o Xcode 26.3 ou posterior instalado
• Um plano pago do Cursor
• Um projeto do Xcode aberto no Xcode (o Xcode deve estar em execução)

Ativar o MCP no Xcode

Antes de conectar o Cursor, ative a ponte MCP do Xcode:

Configure o Cursor

Escolha o método mais adequado ao seu fluxo de trabalho.

Opção 1: interface de configuração do MCP

Opção 2: mcp.json

Adicione uma entrada ao seu arquivo de configuração do MCP:

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

Opção 3: CLI do Cursor

Se você usa a CLI do Cursor, registre o servidor pelo terminal:

agent mcp add xcode-tools -- xcrun mcpbridge

A CLI usa a mesma config de MCP do Editor, então o servidor aparece nos dois.

Ferramentas disponíveis

O Xcode oferece 20 ferramentas MCP em cinco categorias:

Operações de arquivo

• XcodeRead - Ler o conteúdo de arquivos (até 600 linhas por chamada, com deslocamento/limite para arquivos maiores)
• XcodeWrite - Criar ou sobrescrever arquivos
• XcodeUpdate - Aplicar edições específicas a arquivos existentes
• XcodeGrep - Pesquisar o conteúdo de arquivos com regex
• XcodeGlob - Encontrar arquivos por padrão
• XcodeLS - Listar o conteúdo de diretórios
• XcodeMakeDir - Criar diretórios
• XcodeRM - Remover arquivos ou diretórios
• XcodeMV - Mover ou renomear arquivos

Compilar e testar

• BuildProject - Compile o esquema ativo
• GetBuildLog - Recupere os logs de compilação, filtráveis por severidade, regex ou glob de arquivo
• RunAllTests - Execute toda a suíte de testes
• RunSomeTests - Execute classes ou métodos de teste específicos
• GetTestList - Liste os testes disponíveis

Diagnósticos

• XcodeListNavigatorIssues - Mostra avisos e erros no Navegador de Issues
• XcodeRefreshCodeIssuesInFile - Verifica novamente se há issues de código em um arquivo

Inteligência

• RenderPreview - Captura uma captura de tela de uma prévia do SwiftUI
• DocumentationSearch - Busca semântica na documentação da Apple e nas transcrições da WWDC
• ExecuteSnippet - Executa um trecho de código Swift

Espaço de trabalho

• XcodeListWindows - Lista as janelas e abas abertas do Xcode

Exemplo de fluxo de trabalho

Um fluxo de trabalho típico com Cursor + Xcode é o seguinte:

1. Abra seu projeto no Cursor e no Xcode
2. Peça ao agente do Cursor para adicionar uma funcionalidade ou corrigir um bug
3. O agente usa XcodeRead e XcodeGrep para entender seu código
4. Ele edita arquivos com XcodeWrite ou XcodeUpdate
5. Ele executa BuildProject para verificar erros e lê os resultados com GetBuildLog
6. Ele executa testes com RunSomeTests para verificar a alteração
7. Ele gera uma prévia do SwiftUI com RenderPreview para confirmar a UI

Você permanece no Cursor o tempo todo. O Xcode cuida da compilação, dos testes e das prévias em segundo plano.

CLI do Cursor com o Xcode

A CLI do Cursor também funciona com as ferramentas MCP do Xcode. Isso é útil para fluxos de trabalho sem interface gráfica, pipelines de CI ou desenvolvedores que priorizam o terminal.

# Execute o agente com as ferramentas do Xcode disponíveisagent "Add unit tests for the NetworkManager class"

O agente usa o servidor MCP xcode-tools da sua configuração e as mesmas ferramentas disponíveis no Editor.

Solução de problemas

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

xcrun --find mcpbridge

Relacionados