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

> Exécutez Devin dans l'assistant de code de Xcode via l'Agent Client Protocol (ACP), ou donnez à Devin CLI accès à votre projet Xcode via la passerelle MCP de Xcode.

L'[intelligence de code](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence) de Xcode 26.6
permet d'exécuter Devin en tant qu'agent dans l'**assistant de code** à l'aide de
l'[Agent Client Protocol (ACP)](https://agentclientprotocol.com/). Devin ne figure pas
parmi les agents répertoriés dans les paramètres Settings Intelligence de Xcode ; vous devez donc l'ajouter manuellement comme
agent ACP personnalisé, exécuté depuis votre installation locale de Devin CLI.

<Note>
  Cette intégration utilise la prise en charge ACP intégrée de Xcode dans l'assistant de code. Pour
  la documentation de référence, consultez la documentation d'Apple sur
  [la configuration de l'intelligence de code](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence).
</Note>

<div id="prerequisites">
  ## Prérequis
</div>

* **Xcode 26.6 ou version ultérieure** avec l’assistant de code disponible.
* Devin CLI installé et authentifié. Si vous ne l’avez pas encore installé, suivez
  le [guide de démarrage rapide](/fr/cli/index), puis exécutez `devin auth login`.
* Le chemin **absolu** vers le binaire `devin`. Vous pouvez l’obtenir avec :

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

  Il s’agit généralement de quelque chose comme `/Users/you/.local/bin/devin`.

<Warning>
  Xcode exige un chemin **absolu** pour la commande de l’agent — il n’interprète
  pas `~` et n’utilise pas le `PATH` de votre shell. Si `which devin` affiche un chemin
  commençant par `~`, développez-le d’abord (par exemple, exécutez `echo "$(cd ~ && pwd)/.local/bin/devin"`), puis
  utilisez le résultat complet `/Users/...`.
</Warning>

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

Ajoutez Devin comme agent personnalisé depuis les Settings Intelligence.

<Steps>
  <Step title="Ouvrir les Settings Intelligence">
    Choisissez **Xcode > Settings**, puis sélectionnez **Intelligence** dans la barre latérale.
  </Step>

  <Step title="Ajouter un agent">
    Sous **Agents**, cliquez sur **Add an Agent**. La prise en charge intégrée d’ACP dans Xcode vous permet
    d’enregistrer n’importe quel agent compatible avec l’Agent Client Protocol.
  </Step>

  <Step title="Configurer l’agent Devin">
    Dans la fenêtre qui s’affiche, renseignez les détails de l’agent :

    * **Name** — `Devin` (ou tout autre libellé de votre choix).
    * **Command** — le chemin **absolu** vers votre binaire `devin` (obtenu avec
      `which devin`), par exemple `/Users/you/.local/bin/devin`. Un chemin relatif
      ou un chemin commençant par `~` ne fonctionnera pas.
    * **Arguments** — `acp` (le seul argument nécessaire à Devin).

    Cliquez sur **Add**. Devin apparaît désormais comme agent sélectionnable sous **Agents**.
  </Step>

  <Step title="Commencer à discuter avec Devin">
    Sélectionnez **Devin** dans l’assistant de code et envoyez un message pour démarrer une
    session. La première fois que vous vous connectez, vous devrez peut-être vous authentifier ;
    Devin utilise les identifiants de `devin auth login` (ou `WINDSURF_API_KEY` si
    défini).
  </Step>
</Steps>

<div id="give-devin-cli-access-to-your-xcode-project-mcp">
  ## Accordez à Devin CLI l’accès à votre projet Xcode (MCP)
</div>

Indépendamment de l’utilisation de Devin *dans* Xcode, vous pouvez faire pointer Devin
CLI autonome vers votre projet Xcode afin qu’il puisse lancer des builds, exécuter des tests, lire
et modifier des fichiers, afficher des aperçus SwiftUI et effectuer des recherches dans
la documentation d’Apple. Xcode inclut un serveur
[MCP](/fr/cli/extensibility/mcp/overview), `xcrun mcpbridge`, qui expose
ces outils Xcode à tout agent externe (le même mécanisme
[utilisé par Cursor](https://cursor.com/docs/integrations/xcode)). Ajoutez-le à Devin comme
n’importe quel autre serveur MCP.

<Note>
  La passerelle MCP de Xcode nécessite **Xcode 26.3 ou une version ultérieure**. Vérifiez que le binaire est
  disponible avec `xcrun --find mcpbridge` (voir [Résolution des problèmes](#troubleshooting)
  si ce n’est pas le cas). Consultez la documentation d’Apple sur
  [l’autorisation d’accès à Xcode pour les agents externes](https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode).
</Note>

<Steps>
  <Step title="Autoriser les agents externes dans Xcode">
    Dans **Xcode > Settings**, sélectionnez **Intelligence**, puis, sous **Model
    Context Protocol**, activez **Allow external agents to use Xcode tools**.
  </Step>

  <Step title="Ajouter le serveur MCP Xcode à Devin">
    Enregistrez `xcrun mcpbridge` comme serveur MCP stdio :

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

    Vérifiez qu’il a bien été ajouté avec `devin mcp list`. Consultez
    [`devin mcp`](/fr/cli/reference/commands#devin-mcp) pour les options de périmètre et de configuration.
  </Step>

  <Step title="Ouvrir votre projet et envoyer un prompt à Devin">
    Ouvrez votre projet ou espace de travail dans Xcode (la passerelle nécessite une
    session Xcode en cours d’exécution avec un projet ouvert), puis envoyez un prompt à Devin depuis la CLI. Xcode vous
    avertit lorsque l’agent externe se connecte et tant qu’il est actif.
  </Step>
</Steps>

<div id="troubleshooting">
  ## Dépannage
</div>

* **`xcrun: error: unable to find utility "mcpbridge"`** — votre système utilise
  les Command Line Tools au lieu de l’installation complète de Xcode. Corrigez cela avec :

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

  Vérifiez ensuite avec `xcrun --find mcpbridge`, qui devrait afficher un chemin.
* **Devin ne peut pas accéder aux outils Xcode** — assurez-vous que Xcode est ouvert avec un
  projet (et non une fenêtre vide), et que **Allow external agents to use
  Xcode tools** est activé dans les réglages Settings Intelligence.

<div id="notes-and-limitations">
  ## Notes et limites
</div>

* Il n'est pas possible de sélectionner le modèle depuis Xcode : Devin s'exécute toujours avec le modèle par défaut de votre Team.
* Lorsque vous sélectionnez un agent dans l'assistant de code de Xcode, il obtient automatiquement l'accès aux capacités de Xcode, comme le build et le test de votre application. Vous pouvez vérifier et restreindre les commandes et outils que les agents peuvent utiliser sous **Agents > Permissions** dans les Settings d'Intelligence ; consultez la documentation d'Apple sur [l'extension et la personnalisation des agents](https://developer.apple.com/documentation/xcode/extending-and-customizing-agents).
* La sortie du terminal/shell de Devin CLI est affichée via le rendu ACP de Xcode, qui diffère de l'UI de terminal native de Devin CLI. Certaines interactions plus riches ne sont disponibles que dans le CLI autonome.
* La sous-commande `devin acp` est conçue pour être lancée par un client compatible ACP (comme l'assistant de code de Xcode) en tant que sous-processus : elle communique en JSON-RPC via stdio et n'est pas destinée à être exécutée de manière interactive. Voir [`devin acp`](/fr/cli/reference/commands#devin-acp) dans la référence des commandes.