# MCP

Conecte Claude Code, Codex, Cursor ou qualquer cliente MCP ao Device MCP para seu agente de IA ver, tocar, digitar e testar no iPhone e iPad.

O Device MCP conecta seu agente de programação com IA ao seu iPhone e iPad reais. Seu agente pode olhar a tela, tocar e digitar, abrir apps, compilar seu projeto e testá-lo no dispositivo, tudo a partir de uma conversa normal.

## 1. O que é o servidor MCP do Device MCP?
O **MCP** (Model Context Protocol) é o padrão aberto que os agentes de IA usam para se comunicar com ferramentas. O Device MCP tem um servidor MCP integrado, então o Claude Code, o Codex, o Cursor e outros agentes compatíveis com MCP podem controlar seu dispositivo do mesmo jeito que você.

O servidor roda apenas no seu Mac. Sua tela e seus apps nunca saem do Mac, exceto o que você pedir para o agente olhar. Veja [Privacidade e segurança](../help/privacy-and-security.md).

### ✅ Exemplos de prompts
* Faça uma captura de tela do meu iPhone e me diga o que aparece na tela.
* Abra os Ajustes e ative o Modo Escuro.
* Compile meu app, execute no iPad e verifique se a tela de login funciona.
* Faça login com a conta de teste, adicione um item ao carrinho e confira o total.
* Meu app fechou inesperadamente no dispositivo. Encontre o relatório de falhas e corrija o bug.
* Abra `myapp://profile` e faça uma captura de tela.
* Grave um vídeo do fluxo de onboarding.

## 2. Benefícios
| Benefício | Descrição |
| --- | --- |
| **Teste em hardware real** | Seu agente testa em um iPhone ou iPad real, com desempenho, sensores e alertas do sistema reais. |
| **Desenvolvimento em ciclo fechado** | Editar, compilar, executar, tocar, capturar a tela, corrigir: seu agente confere o próprio trabalho sem você. |
| **Ele vê o que você vê** | Seu agente lê as palavras e os botões na tela, então consegue tocar em **Sign In** pelo nome. |
| **Você no comando** | Ações arriscadas pedem sua aprovação antes, toda ação fica registrada e você pode assumir o controle a qualquer momento. |
| **Funciona com o seu agente** | Claude Code, Codex, Cursor e qualquer outro cliente MCP. |

## 3. Como adicionar o Device MCP ao seu agente
1. **Ative o servidor MCP**
   * Abra **Device MCP → Settings → MCP**.
   * Ative **Enable MCP Server**.
2. **Copie a configuração do seu agente**: em **Settings → MCP → MCP Configuration**, escolha **Claude Code**, **Codex** ou **Manual** e clique em **Copy**. A mesma configuração está na aba **Agent** do Inspector.
3. **Adicione ao seu agente** seguindo os passos abaixo.

### Claude Code
Execute isto no Terminal:

```bash
claude mcp add --scope user device-mcp -- "/Applications/Device MCP.app/Contents/MacOS/device-mcp"
```

`--scope user` deixa o Device MCP disponível em todos os seus projetos.

### Codex
Adicione isto ao `~/.codex/config.toml`:

```toml
[mcp_servers.device-mcp]
command = "/Applications/Device MCP.app/Contents/MacOS/device-mcp"
startup_timeout_sec = 30
tool_timeout_sec = 900
```

{% hint style="info" %}
Compilar seu app e esperar sua aprovação pode levar alguns minutos. `tool_timeout_sec` dá ao Codex tempo suficiente para esperar.
{% endhint %}

### Cursor e outros clientes MCP
Adicione isto às configurações de MCP do seu cliente:

```json
{
  "mcpServers": {
    "device-mcp": {
      "command": "/Applications/Device MCP.app/Contents/MacOS/device-mcp",
      "args": []
    }
  }
}
```

4. **Comece a usar o Device MCP**
   * Mantenha o Device MCP aberto com seu dispositivo conectado.
   * Peça ao seu agente, por exemplo: *"Liste meus dispositivos e faça uma captura de tela."*

{% hint style="warning" %}
Se o agente disser que o servidor MCP está desativado, abra **Device MCP → Settings → MCP** e ative **Enable MCP Server**. Os agentes exigem o [Device MCP Pro](../license.md).
{% endhint %}

## 4. O que seu agente pode fazer
| Área | O que seu agente pode fazer |
| --- | --- |
| **Dispositivos** | Listar os dispositivos conectados, escolher um e ler os detalhes dele. |
| **Ver a tela** | Fazer capturas de tela e ler o texto e os botões na tela. |
| **Toque** | Tocar, tocar em um texto, tocar duas vezes, tocar e manter pressionado, deslizar, rolar e pinçar. |
| **Digitação** | Digitar texto, pressionar teclas e ocultar o teclado. |
| **Sistema** | Pressionar os botões de Início, bloqueio, volume e Siri, abrir a Central de Controle ou o Seletor de Apps e girar a tela. |
| **Apps** | Listar, abrir, encerrar, instalar e desinstalar apps, e abrir links. |
| **Build & Run** | Compilar seu projeto Xcode e executá-lo no dispositivo. Veja [Build & Run](build-and-run.md). |
| **Depuração** | Ler relatórios de falhas e baixar os dados de um app. |
| **Gravação** | Iniciar e parar uma gravação de tela. |
| **Chamar você** | Pedir que você intervenha, por exemplo, para Face ID ou código. Veja [Human Handoff](human-handoff.md). |

Seu cliente MCP mostra a lista completa de ferramentas da sua versão do Device MCP.

## 5. Mantenha o controle
* **Aprovações**: instalar ou remover apps, compilar, abrir links e baixar dados de apps pedem sua aprovação antes. Veja [Aprovações](approvals.md).
* **Atividade**: toda ação do seu agente aparece na aba **Agent**. Veja [Atividade do agente](agent-activity.md).
* **Agent is driving**: o status na parte inferior da tela espelhada e um ✨ ao lado do dispositivo na barra lateral mostram quando um agente está usando o dispositivo.
* **Assuma a qualquer momento**: seus cliques e o que você digita sempre chegam ao dispositivo, mesmo enquanto um agente trabalha.