> ## 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

> Esegui Devin nell'assistente di coding di Xcode tramite l'Agent Client Protocol (ACP), oppure consenti a Devin CLI di accedere al tuo progetto Xcode tramite il bridge MCP di Xcode.

L'[intelligenza per la programmazione](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence)
di Xcode 26.6 può eseguire Devin come agente nell'**assistente di coding** tramite
l'[Agent Client Protocol (ACP)](https://agentclientprotocol.com/). Devin non è uno
degli agenti elencati nelle impostazioni Intelligence di Xcode, quindi va aggiunto manualmente come
agente ACP personalizzato eseguito dalla tua installazione locale di Devin CLI.

<Note>
  Questa integrazione usa il supporto ACP integrato di Xcode nell'assistente di coding. Per
  il riferimento upstream, consulta la documentazione Apple su
  [come configurare l'intelligenza per la programmazione](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence).
</Note>

<div id="prerequisites">
  ## Prerequisiti
</div>

* **Xcode 26.6 o versioni successive** con l'assistente di coding disponibile.
* Devin CLI installato e autenticato. Se non l'hai ancora installato, segui
  la [Guida rapida](/it/cli/index), quindi esegui `devin auth login`.
* Il percorso **assoluto** del file binario `devin`. Puoi trovarlo con:

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

  In genere restituisce qualcosa di simile a `/Users/you/.local/bin/devin`.

<Warning>
  Xcode richiede un percorso **assoluto** per il comando dell'agente: non espande
  `~` né usa il `PATH` della shell. Se `which devin` restituisce un percorso con prefisso `~`,
  espandilo prima (ad esempio, esegui `echo "$(cd ~ && pwd)/.local/bin/devin"`) e
  usa il risultato completo `/Users/...`.
</Warning>

<div id="setup">
  ## Configurazione
</div>

Aggiungi Devin come agente personalizzato dalle impostazioni di Intelligence.

<Steps>
  <Step title="Apri le impostazioni di Intelligence">
    Scegli **Xcode > Settings**, quindi seleziona **Intelligence** nella barra laterale.
  </Step>

  <Step title="Aggiungi un agente">
    In **Agents**, fai clic su **Add an Agent**. Il supporto ACP integrato di Xcode ti consente
    di registrare qualsiasi agente che utilizzi l'Agent Client Protocol.
  </Step>

  <Step title="Configura l'agente Devin">
    Nella finestra visualizzata, inserisci i dettagli dell'agente:

    * **Name** — `Devin` (o qualsiasi etichetta tu preferisca).
    * **Command** — il percorso **assoluto** del binario `devin` (ottenuto con
      `which devin`), ad esempio `/Users/you/.local/bin/devin`. Un percorso relativo
      o un percorso con prefisso `~` non funzionerà.
    * **Arguments** — `acp` (l'unico argomento richiesto da Devin).

    Fai clic su **Add**. Devin ora appare come agente selezionabile in **Agents**.
  </Step>

  <Step title="Inizia a chattare con Devin">
    Seleziona **Devin** nell'assistente di coding e invia un messaggio per avviare una
    sessione. La prima volta che ti connetti, potrebbe esserti richiesto di autenticarti;
    Devin usa le credenziali di `devin auth login` (o `WINDSURF_API_KEY` se
    impostata).
  </Step>
</Steps>

<div id="give-devin-cli-access-to-your-xcode-project-mcp">
  ## Consenti a Devin CLI di accedere al tuo progetto Xcode (MCP)
</div>

Oltre a eseguire Devin *all'interno* di Xcode, puoi puntare Devin CLI
standalone al tuo progetto Xcode in modo che possa compilare, eseguire test, leggere e modificare file, mostrare
anteprime SwiftUI e cercare nella documentazione di Apple. Xcode include un
server [MCP](/it/cli/extensibility/mcp/overview), `xcrun mcpbridge`, che espone
questi strumenti di Xcode a qualsiasi agente esterno (lo stesso meccanismo
[usato da Cursor](https://cursor.com/docs/integrations/xcode)). Aggiungilo a Devin come
qualsiasi altro server MCP.

<Note>
  Il bridge MCP di Xcode richiede **Xcode 26.3 o versioni successive**. Verifica che il binario sia
  disponibile con `xcrun --find mcpbridge` (vedi [Risoluzione dei problemi](#troubleshooting)
  se non lo è). Consulta la documentazione di Apple su come
  [consentire agli agenti esterni di accedere a Xcode](https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode).
</Note>

<Steps>
  <Step title="Consenti agli agenti esterni in Xcode">
    Scegli **Xcode > Settings**, seleziona **Intelligence** e, in **Model
    Context Protocol**, attiva **Allow external agents to use Xcode tools**.
  </Step>

  <Step title="Aggiungi il server MCP di Xcode a Devin">
    Registra `xcrun mcpbridge` come server MCP stdio:

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

    Verifica che sia stato aggiunto con `devin mcp list`. Consulta
    [`devin mcp`](/it/cli/reference/commands#devin-mcp) per le opzioni di ambito e configurazione.
  </Step>

  <Step title="Apri il tuo progetto e invia un prompt a Devin">
    Apri il tuo progetto o workspace in Xcode (il bridge richiede una
    sessione Xcode attiva con un progetto aperto), quindi invia un prompt a Devin dalla CLI. Xcode ti avvisa
    quando l'agente esterno si connette e finché rimane attivo.
  </Step>
</Steps>

<div id="troubleshooting">
  ## Risoluzione dei problemi
</div>

* **`xcrun: error: unable to find utility "mcpbridge"`** — il sistema è configurato
  per usare i Command Line Tools invece dell'installazione completa di Xcode. Risolvi con:

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

  Poi verifica con `xcrun --find mcpbridge`, che dovrebbe restituire un percorso.
* **Devin non riesce ad accedere agli strumenti di Xcode** — assicurati che Xcode sia in esecuzione con un
  progetto aperto (non una finestra vuota) e che **Allow external agents to use
  Xcode tools** sia abilitato nelle impostazioni di Intelligence.

<div id="notes-and-limitations">
  ## Note e limitazioni
</div>

* Il modello non può essere selezionato in Xcode: Devin usa sempre il modello predefinito del tuo team.
* Quando selezioni un agente nell'assistente di coding di Xcode, questo ottiene automaticamente accesso alle funzionalità di Xcode, come la compilazione e il testing della tua app. Puoi controllare e limitare quali comandi e strumenti gli agenti possono usare in **Agents > Permissions** nelle impostazioni di Intelligence; consulta anche la documentazione Apple su [come estendere e personalizzare gli agenti](https://developer.apple.com/documentation/xcode/extending-and-customizing-agents).
* L'output del terminale/shell di Devin CLI viene mostrato tramite il rendering ACP di Xcode, che è diverso dall'interfaccia del terminale nativa di Devin CLI. Alcune interazioni più avanzate sono disponibili solo nella CLI standalone.
* Il sottocomando `devin acp` è pensato per essere avviato come sottoprocesso da un client compatibile con ACP (come l'assistente di coding di Xcode): comunica tramite JSON-RPC su stdio e non è pensato per un uso interattivo. Consulta [`devin acp`](/it/cli/reference/commands#devin-acp) nel riferimento dei comandi.