Zeptap — real iPhone MCP server
O Zeptap é um app para Mac que permite que agentes de IA como Claude Code, Codex e Cursor vejam, toquem, deslizem e digitem no seu iPhone real — sem Xcode, sem Modo Desenvolvedor, sem instalar nada no telefone.
Documentação
Espelhe um iPhone real no seu Mac e deixe agentes de IA tocarem, digitarem e lerem a tela dele por meio de um servidor MCP local.
Zeptap é um aplicativo macOS que transforma um iPhone real em algo que um agente de IA pode usar. O Mac vê a tela do iPhone via USB e toca e digita nele como um teclado e ponteiro Bluetooth. Converse com ele pelo painel de chat do próprio Zeptap, usando sua assinatura do Claude ou ChatGPT ou uma chave de API do OpenRouter, ou deixe agentes como Claude Code, Claude Desktop, Codex e Cursor controlarem-no por meio de um servidor MCP local:
http://127.0.0.1:47801/mcp
O servidor fala Streamable HTTP, escuta apenas em loopback e não precisa de chave de API. Ele existe enquanto o aplicativo Zeptap estiver em execução no mesmo Mac. Nada é instalado no iPhone e nada sai do Mac.
Escolha o caminho mais curto
| Objetivo | Comece aqui |
|---|---|
| Instalar o Zeptap e verificar seu hardware | Instalar |
| Parear um iPhone pela primeira vez | Configurar um iPhone |
| Deixe o Claude usar seu iPhone, do início ao fim | Como deixar o Claude controlar seu iPhone |
| Converse usando sua assinatura do Claude ou ChatGPT, ou uma chave OpenRouter | Usar sua própria conta de IA |
| Adicionar o Zeptap a um agente | Conectar um agente |
| Consultar os argumentos de uma ferramenta | Referência de ferramentas |
| Tornar um agente confiável em um telefone real | Dirigindo o iPhone |
| Aquecer uma nova conta do Instagram, TikTok ou Reddit | Playbooks |
| Deixe agentes desbloquearem um telefone bloqueado | Bloquear e desbloquear |
| Corrigir uma ferramenta que dá erro ou uma tela em branco | Solução de problemas |
Como funciona
| Canal | Transporte | O que ele carrega |
|---|---|---|
| Tela | USB (CoreMediaIO / AVFoundation) | Vídeo ao vivo da tela do iPhone, usado para o espelhamento, capturas de tela e OCR no dispositivo |
| Toque e teclado | HID Bluetooth (o Mac atua como teclado e ponteiro) | Toques, arrastos, deslizes, digitação e pressionamentos de tecla, via AssistiveTouch no iPhone |
| Controle do dispositivo | USB (lockdown) | Confiança, nome e modelo do dispositivo, ativação do AssistiveTouch e bloqueio da tela |
| Agentes | MCP local via HTTP | 18 ferramentas; cada ação retorna uma captura de tela tirada após a tela parar de se mover |
Para agentes lendo isto
- Cada página está disponível como markdown: acrescente
.mdao URL dela, ou solicite a página comAccept: text/markdown. /docs/llms.txtindexa todas as páginas;/docs/llms-full.txté o manual completo em um único arquivo.- O servidor MCP também envia um pequeno conjunto de regras operacionais na resposta
initialize. Dirigindo o iPhone expande essas regras.
[
Baixe o Zeptap, verifique os requisitos do Mac e do iPhone e mantenha o aplicativo atualizado.