> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Xcode

> Ejecuta Devin dentro del asistente de programación de Xcode mediante el Protocolo Cliente-Agente (ACP), o dale a Devin CLI acceso a tu proyecto de Xcode a través del puente MCP de Xcode.

La [inteligencia de programación](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence) de Xcode 26.6
puede ejecutar Devin como agente dentro del **asistente de programación** mediante el
[Protocolo Cliente-Agente (ACP)](https://agentclientprotocol.com/). Devin no es uno
de los agentes que aparecen en los Settings de Intelligence de Xcode, así que debes agregarlo manualmente como
un agente ACP personalizado que se ejecuta desde tu instalación local de Devin CLI.

<Note>
  Esta integración usa la compatibilidad integrada con ACP de Xcode en el asistente de programación. Si quieres consultar
  la referencia oficial, revisa la documentación de Apple sobre
  [configurar la inteligencia de programación](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence).
</Note>

<div id="prerequisites">
  ## Requisitos previos
</div>

* **Xcode 26.6 o posterior** con el asistente de programación disponible.
* Devin CLI instalado y autenticado. Si aún no lo has instalado, sigue
  la [Guía de inicio rápido](/es/cli/index) y luego ejecuta `devin auth login`.
* La ruta **absoluta** del binario `devin`. Puedes encontrarla con:

  ```bash theme={null}
  which devin
  ```

  Normalmente devuelve algo como `/Users/you/.local/bin/devin`.

<Warning>
  Xcode requiere una ruta **absoluta** para el comando del agente; no expande
  `~` ni usa el `PATH` de tu shell. Si `which devin` muestra una ruta con el prefijo `~`,
  expándela primero (por ejemplo, ejecuta `echo "$(cd ~ && pwd)/.local/bin/devin"`) y
  usa el resultado completo `/Users/...`.
</Warning>

<div id="setup">
  ## Configuración
</div>

Agrega Devin como agente personalizado desde Settings de Intelligence.

<Steps>
  <Step title="Abre Settings de Intelligence">
    Selecciona **Xcode > Settings** y, a continuación, **Intelligence** en la barra lateral.
  </Step>

  <Step title="Agrega un agente">
    En **Agents**, haz clic en **Add an Agent**. La compatibilidad integrada con ACP de Xcode te permite
    registrar cualquier agente compatible con el Protocolo Cliente-Agente.
  </Step>

  <Step title="Configura el agente Devin">
    En la ventana que aparece, introduce los datos del agente:

    * **Name** — `Devin` (o cualquier etiqueta que prefieras).
    * **Command** — la ruta **absoluta** a tu binario `devin` (obtenida con
      `which devin`), por ejemplo `/Users/you/.local/bin/devin`. Una ruta relativa
      o una ruta con el prefijo `~` no funcionará.
    * **Arguments** — `acp` (el único argumento que necesita Devin).

    Haz clic en **Add**. Devin aparecerá ahora como un agente seleccionable en **Agents**.
  </Step>

  <Step title="Empieza a chatear con Devin">
    Selecciona **Devin** en el asistente de programación y envía un mensaje para iniciar una
    sesión. La primera vez que te conectes, es posible que se te pida autenticarte;
    Devin usa las credenciales de `devin auth login` (o `WINDSURF_API_KEY` si está
    definida).
  </Step>
</Steps>

<div id="give-devin-cli-access-to-your-xcode-project-mcp">
  ## Da a Devin CLI acceso a tu proyecto de Xcode (MCP)
</div>

Además de ejecutar Devin *dentro* de Xcode, puedes hacer que Devin
CLI independiente apunte a tu proyecto de Xcode para que pueda compilar, ejecutar pruebas, leer y editar archivos, renderizar
previsualizaciones de SwiftUI y buscar en la documentación de Apple. Xcode incluye un
servidor [MCP](/es/cli/extensibility/mcp/overview), `xcrun mcpbridge`, que expone
estas herramientas de Xcode a cualquier agente externo (el mismo mecanismo
[que usa Cursor](https://cursor.com/docs/integrations/xcode)). Agrégalo a Devin como
cualquier otro servidor MCP.

<Note>
  El puente MCP de Xcode requiere **Xcode 26.3 o posterior**. Confirma que el binario
  está disponible con `xcrun --find mcpbridge` (consulta [Solución de problemas](#troubleshooting)
  si no lo está). Consulta la documentación de Apple sobre
  [cómo dar a los agentes externos acceso a Xcode](https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode).
</Note>

<Steps>
  <Step title="Permite agentes externos en Xcode">
    Elige **Xcode > Settings**, selecciona **Intelligence** y, en **Model
    Context Protocol**, activa **Allow external agents to use Xcode tools**.
  </Step>

  <Step title="Agrega el servidor MCP de Xcode a Devin">
    Registra `xcrun mcpbridge` como un servidor MCP stdio:

    ```bash theme={null}
    devin mcp add xcode -- xcrun mcpbridge
    ```

    Verifica que se haya agregado con `devin mcp list`. Consulta
    [`devin mcp`](/es/cli/reference/commands#devin-mcp) para ver las opciones de ámbito y configuración.
  </Step>

  <Step title="Abre tu proyecto y envía un prompt a Devin">
    Abre tu proyecto o workspace en Xcode (el puente necesita una
    sesión de Xcode en ejecución con un proyecto abierto) y luego envía un prompt a Devin desde la CLI. Xcode te avisa
    cuando el agente externo se conecta y mientras está activo.
  </Step>
</Steps>

<div id="troubleshooting">
  ## Solución de problemas
</div>

* **`xcrun: error: unable to find utility "mcpbridge"`** — tu sistema está apuntando
  a las Command Line Tools en lugar de a la instalación completa de Xcode. Corrígelo con:

  ```bash theme={null}
  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  sudo xcodebuild -runFirstLaunch
  ```

  Luego confírmalo con `xcrun --find mcpbridge`, que debería mostrar una ruta.
* **Devin no puede acceder a las herramientas de Xcode** — asegúrate de que Xcode se esté ejecutando con un
  proyecto abierto (no una ventana vacía) y de que **Allow external agents to use
  Xcode tools** esté habilitado en la configuración de Settings de Intelligence.

<div id="notes-and-limitations">
  ## Notas y limitaciones
</div>

* No se puede seleccionar el modelo desde Xcode: Devin siempre se ejecuta con el
  modelo predeterminado de tu equipo.
* Cuando seleccionas un agente en el asistente de programación de Xcode, este obtiene
  automáticamente acceso a capacidades de Xcode, como compilar y probar tu app. Puedes
  revisar y restringir qué comandos y herramientas pueden usar los agentes en
  **Agents > Permissions** de los Settings de Intelligence. Consulta la documentación de Apple sobre
  [cómo ampliar y personalizar agentes](https://developer.apple.com/documentation/xcode/extending-and-customizing-agents).
* La salida de la terminal/shell de Devin CLI se muestra mediante el renderizado ACP de Xcode,
  que difiere de la interfaz nativa de terminal de Devin CLI. Algunas interacciones más avanzadas
  solo están disponibles en la CLI independiente.
* El subcomando `devin acp` está pensado para iniciarse mediante un cliente compatible con ACP
  (como el asistente de programación de Xcode) como subproceso: se comunica mediante JSON-RPC sobre stdio
  y no está pensado para ejecutarse de forma interactiva. Consulta
  [`devin acp`](/es/cli/reference/commands#devin-acp) en la referencia de comandos.