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

# Xcode

> Execute o Devin no assistente de programação do Xcode por meio do Agent Client Protocol (ACP) ou dê ao Devin CLI acesso ao seu projeto do Xcode pela ponte MCP do Xcode.

A [inteligência de programação](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence) do Xcode 26.6
pode executar o Devin como agente no **assistente de programação** usando o
[Agent Client Protocol (ACP)](https://agentclientprotocol.com/). O Devin não é um
dos agentes listados nas configurações de Intelligence do Xcode, então você precisa adicioná-lo manualmente como
um agente ACP personalizado executado a partir da sua instalação local do Devin CLI.

<Note>
  Esta integração usa o suporte ACP nativo do Xcode no assistente de programação. Para
  mais informações, consulte a documentação da Apple sobre
  [a configuração da inteligência de programação](https://developer.apple.com/documentation/xcode/setting-up-coding-intelligence).
</Note>

<div id="prerequisites">
  ## Pré-requisitos
</div>

* **Xcode 26.6 ou superior** com o assistente de programação disponível.
* Devin CLI instalado e autenticado. Se você ainda não o instalou, siga o
  [Quickstart](/pt-BR/cli/index) e, em seguida, execute `devin auth login`.
* O caminho **absoluto** para o binário `devin`. Você pode encontrá-lo com:

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

  Normalmente, isso retorna algo como `/Users/you/.local/bin/devin`.

<Warning>
  O Xcode exige um caminho **absoluto** para o comando do agente — ele não expande
  `~` nem usa o `PATH` do seu shell. Se `which devin` retornar um caminho com o prefixo `~`,
  expanda-o primeiro (por exemplo, execute `echo "$(cd ~ && pwd)/.local/bin/devin"`) e
  use o resultado completo em `/Users/...`.
</Warning>

<div id="setup">
  ## Configuração
</div>

Adicione Devin como um agente personalizado nas configurações do Intelligence.

<Steps>
  <Step title="Abra as configurações do Intelligence">
    Selecione **Xcode > Settings** e, em seguida, **Intelligence** na barra lateral.
  </Step>

  <Step title="Adicione um agente">
    Em **Agents**, clique em **Add an Agent**. O suporte nativo a ACP do Xcode permite
    registrar qualquer agente compatível com o Agent Client Protocol.
  </Step>

  <Step title="Configure o agente Devin">
    Na janela exibida, insira os detalhes do agente:

    * **Name** — `Devin` (ou qualquer rótulo de sua preferência).
    * **Command** — o caminho **absoluto** para o binário `devin` (de
      `which devin`), por exemplo `/Users/you/.local/bin/devin`. Um caminho relativo
      ou um caminho com prefixo `~` não funcionará.
    * **Arguments** — `acp` (o único argumento necessário para Devin).

    Clique em **Add**. Devin passará a aparecer como um agente selecionável em **Agents**.
  </Step>

  <Step title="Comece a conversar com Devin">
    Selecione **Devin** no assistente de programação e envie uma mensagem para iniciar uma
    sessão. Na primeira conexão, pode ser solicitado que você se autentique;
    Devin usa as credenciais de `devin auth login` (ou `WINDSURF_API_KEY`, se
    estiver definida).
  </Step>
</Steps>

<div id="give-devin-cli-access-to-your-xcode-project-mcp">
  ## Dê ao Devin CLI acesso ao seu projeto no Xcode (MCP)
</div>

Além de executar o Devin *dentro* do Xcode, você pode apontar o Devin
CLI independente para o seu projeto no Xcode para que ele possa fazer build, executar testes, ler e editar arquivos, renderizar
prévias do SwiftUI e pesquisar na documentação da Apple. O Xcode inclui um
servidor [MCP](/pt-BR/cli/extensibility/mcp/overview), `xcrun mcpbridge`, que expõe
essas ferramentas do Xcode a qualquer agente externo (o mesmo mecanismo
[que o Cursor usa](https://cursor.com/docs/integrations/xcode)). Adicione-o ao Devin como
qualquer outro servidor MCP.

<Note>
  A ponte MCP do Xcode requer **Xcode 26.3 ou posterior**. Confirme se o binário
  está disponível com `xcrun --find mcpbridge` (consulte [Solução de problemas](#troubleshooting)
  caso não esteja). Veja a documentação da Apple sobre
  [como conceder a agentes externos acesso ao Xcode](https://developer.apple.com/documentation/xcode/giving-external-agents-access-to-xcode).
</Note>

<Steps>
  <Step title="Permitir agentes externos no Xcode">
    Escolha **Xcode > Settings**, selecione **Intelligence** e, em **Model
    Context Protocol**, ative **Allow external agents to use Xcode tools**.
  </Step>

  <Step title="Adicionar o servidor MCP do Xcode ao Devin">
    Registre `xcrun mcpbridge` como um servidor MCP via stdio:

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

    Verifique se ele foi adicionado com `devin mcp list`. Consulte
    [`devin mcp`](/pt-BR/cli/reference/commands#devin-mcp) para ver as opções de escopo e configuração.
  </Step>

  <Step title="Abrir seu projeto e enviar um prompt ao Devin">
    Abra seu projeto ou workspace no Xcode (a ponte precisa de uma
    sessão do Xcode em execução com um projeto aberto) e, em seguida, envie um prompt ao Devin pela CLI. O Xcode alerta
    você quando o agente externo se conecta e enquanto ele está ativo.
  </Step>
</Steps>

<div id="troubleshooting">
  ## Solução de problemas
</div>

* **`xcrun: error: unable to find utility "mcpbridge"`** — seu sistema está apontado
  para as Ferramentas de Linha de Comando em vez da instalação completa do Xcode. Corrija com:

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

  Em seguida, confirme com `xcrun --find mcpbridge`, que deve exibir um caminho.
* **Devin não consegue acessar as ferramentas do Xcode** — verifique se o Xcode está em execução com um
  projeto (não uma janela vazia) aberto e se **Allow external agents to use
  Xcode tools** está ativado nas configurações de Intelligence.

<div id="notes-and-limitations">
  ## Notas e limitações
</div>

* Não é possível selecionar o modelo no Xcode — o Devin sempre é executado com o
  modelo padrão da sua equipe.
* Quando você seleciona um agente no assistente de programação do Xcode, ele
  recebe automaticamente acesso a recursos do Xcode, como fazer build e testar
  seu app. Você pode revisar e restringir quais comandos e ferramentas os agentes
  podem usar em **Agents > Permissions** nas configurações do Intelligence —
  consulte a documentação da Apple sobre
  [como estender e personalizar agentes](https://developer.apple.com/documentation/xcode/extending-and-customizing-agents).
* A saída do terminal/shell do Devin CLI é exibida por meio da renderização ACP
  do Xcode, que é diferente da UI nativa do terminal do Devin CLI. Algumas interações
  mais avançadas estão disponíveis apenas na CLI independente.
* O subcomando `devin acp` foi projetado para ser iniciado por um cliente compatível com ACP
  (como o assistente de programação do Xcode) como um subprocesso — ele usa JSON-RPC por stdio
  e não deve ser executado de forma interativa. Consulte
  [`devin acp`](/pt-BR/cli/reference/commands#devin-acp) na referência de comandos.