[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

Integraciones

Xcode

Xcode 26.3+ incluye un servidor MCP integrado que ofrece a Cursor acceso directo a tus proyectos de Xcode. El agente de Cursor puede leer y editar archivos, iniciar compilaciones, ejecutar pruebas, capturar vistas previas de SwiftUI y buscar en la documentación de Apple sin salir del Editor.

Esto funciona mediante xcrun mcpbridge, un binario que Apple incluye con Xcode y que traduce mensajes del protocolo MCP a la capa XPC interna de Xcode. Lo configuras una vez y Cursor trata las 20 herramientas integradas de Xcode como las de cualquier otro servidor MCP.

Requisitos previos

  • macOS con Xcode 26.3 o una versión posterior instalado
  • Un plan de pago de Cursor
  • Un proyecto de Xcode abierto (Xcode debe estar en ejecución)

Activa MCP en Xcode

Antes de que Cursor pueda conectarse, activa el puente MCP de Xcode:

1

Abre los ajustes de Xcode

Ve a Xcode > Settings > Intelligence.

2

Activa MCP

En Model Context Protocol, activa Xcode Tools.

Configura Cursor

Elige el método que mejor se adapte a tu flujo de trabajo.

Opción 1: IU de configuración de MCP

1

Abrir la configuración de MCP

Ve a Personalizar > MCPs.

2

Añadir el servidor

Haz clic en Añadir nuevo servidor MCP. Establece el transporte en stdio, asígnale el nombre xcode-tools e introduce xcrun mcpbridge como comando.

Opción 2: mcp.json

Añade una entrada a tu archivo de configuración de MCP:

~/.cursor/mcp.json
{  "mcpServers": {    "xcode-tools": {      "command": "xcrun",      "args": ["mcpbridge"]    }  }}

Opción 3: CLI de Cursor

Si usas la CLI de Cursor, registra el servidor desde la terminal:

agent mcp add xcode-tools -- xcrun mcpbridge

La CLI usa la misma configuración de MCP que el Editor, por lo que el servidor aparece en ambos.

Herramientas disponibles

Xcode ofrece 20 herramientas MCP distribuidas en cinco categorías:

Operaciones con archivos

  • XcodeRead - Leer el contenido de archivos (hasta 600 líneas por llamada, con offset/limit para archivos más grandes)
  • XcodeWrite - Crear o sobrescribir archivos
  • XcodeUpdate - Aplicar cambios específicos a archivos existentes
  • XcodeGrep - Buscar con regex en el contenido de archivos
  • XcodeGlob - Buscar archivos por patrón
  • XcodeLS - Mostrar el contenido de directorios
  • XcodeMakeDir - Crear directorios
  • XcodeRM - Eliminar archivos o directorios
  • XcodeMV - Mover o cambiar el nombre de archivos

Compilar y ejecutar pruebas

  • BuildProject - Compilar el esquema activo
  • GetBuildLog - Obtener registros de compilación, filtrables por gravedad, regex o glob de archivos
  • RunAllTests - Ejecutar la suite completa de pruebas
  • RunSomeTests - Ejecutar clases o métodos de prueba específicos
  • GetTestList - Mostrar las pruebas disponibles

Diagnósticos

  • XcodeListNavigatorIssues - Muestra advertencias y errores del navegador de problemas
  • XcodeRefreshCodeIssuesInFile - Vuelve a comprobar si hay problemas de código en un archivo

Inteligencia

  • RenderPreview - Captura una captura de pantalla de una vista previa de SwiftUI
  • DocumentationSearch - Búsqueda semántica en la documentación de Apple y las transcripciones de la WWDC
  • ExecuteSnippet - Ejecuta un fragmento de código Swift

Espacio de trabajo

  • XcodeListWindows - Enumera las ventanas y pestañas abiertas en Xcode

Flujo de trabajo de ejemplo

Un flujo de trabajo típico con Cursor y Xcode es el siguiente:

  1. Abre tu proyecto en Cursor y Xcode
  2. Pide al agente de Cursor que añada una función o corrija un error
  3. El agente usa XcodeRead y XcodeGrep para entender tu código
  4. Edita archivos con XcodeWrite o XcodeUpdate
  5. Ejecuta BuildProject para comprobar si hay errores y consulta los resultados con GetBuildLog
  6. Ejecuta pruebas con RunSomeTests para verificar el cambio
  7. Captura una vista previa de SwiftUI con RenderPreview para confirmar la interfaz de usuario

Trabajas en Cursor en todo momento. Xcode se encarga de la compilación, las pruebas y las vistas previas en segundo plano.

CLI de Cursor con Xcode

La CLI de Cursor también funciona con las herramientas MCP de Xcode. Resulta útil para flujos de trabajo sin interfaz gráfica, canalizaciones de CI o desarrolladores que trabajan principalmente desde la terminal.

# Ejecutar el agente con las herramientas de Xcode disponiblesagent "Add unit tests for the NetworkManager class"

El agente detecta el servidor MCP xcode-tools en tu configuración y usa las mismas herramientas disponibles en el Editor.

Solución de problemas

Asegúrate de que Xcode esté en ejecución y tenga un proyecto abierto. El proceso xcrun mcpbridge necesita una sesión activa de Xcode con la que comunicarse.

Algunas herramientas MCP de Xcode necesitan un contexto de espacio de trabajo. Comprueba que tienes un proyecto o espacio de trabajo abierto en Xcode, no una ventana vacía.

Los proyectos grandes tardan más en compilarse. Consulta directamente el progreso de compilación en Xcode. El puente MCP espera la respuesta de Xcode, por lo que los tiempos de espera suelen indicar que la operación subyacente sigue en ejecución.

Necesitas Xcode 26.3 o una versión posterior. Consulta la versión en Xcode > Acerca de Xcode y actualiza desde la Mac App Store o las descargas de Apple Developer.

Tu sistema apunta a las Command Line Tools en lugar de a la instalación completa de Xcode. Corrígelo ejecutando:

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

A continuación, confirma que el puente esté disponible:

xcrun --find mcpbridge

Debería devolver una ruta de archivo, no un error. Cuando lo haga, abre Xcode con tu proyecto, ve a Ajustes > Inteligencia > Model Context Protocol y activa Permitir agentes externos. Después, vuelve a activar el servidor MCP de Xcode en los ajustes de Cursor. Debería aparecer un cuadro de diálogo de permisos en Xcode para confirmar la conexión.

Relacionado

Descripción general de MCP

Guía completa de MCP con configuración y autenticación

iOS y macOS (Swift)

Flujo de trabajo para el desarrollo con Swift, Cursor, Sweetpad y Xcode Build Server

CLI de Cursor

Usa el agente de Cursor desde la terminal

Comandos MCP de la CLI

Gestiona servidores MCP desde la línea de comandos