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.
Pré-requisitos
- 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 e, em seguida, execute
devin auth login. -
O caminho absoluto para o binário
devin. Você pode encontrá-lo com:Normalmente, isso retorna algo como/Users/you/.local/bin/devin.
Configuração
1
Abra as configurações do Intelligence
Selecione Xcode > Settings e, em seguida, Intelligence na barra lateral.
2
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.
3
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(dewhich 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).
4
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).Dê ao Devin CLI acesso ao seu projeto no Xcode (MCP)
xcrun mcpbridge, que expõe
essas ferramentas do Xcode a qualquer agente externo (o mesmo mecanismo
que o Cursor usa). Adicione-o ao Devin como
qualquer outro servidor MCP.
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
caso não esteja). Veja a documentação da Apple sobre
como conceder a agentes externos acesso ao Xcode.1
Permitir agentes externos no Xcode
Escolha Xcode > Settings, selecione Intelligence e, em Model
Context Protocol, ative Allow external agents to use Xcode tools.
2
Adicionar o servidor MCP do Xcode ao Devin
Registre Verifique se ele foi adicionado com
xcrun mcpbridge como um servidor MCP via stdio:devin mcp list. Consulte
devin mcp para ver as opções de escopo e configuração.3
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.
Solução de problemas
-
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:Em seguida, confirme comxcrun --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.
Notas e limitações
- 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.
- 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 acpfoi 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. Consultedevin acpna referência de comandos.

