# Clicar Tela

> Controla mouse e teclado na tela do Mac como um humano via Touchpoint MCP (e fallback cliclick). Use when the user asks to clicar, digitar, mover mouse, controlar Cursor/Finder/apps, screencast sozinho, computer use, ou desktop automation.

- Skill: `naubergois/clicar-tela` (Agent Skill)
- Install (CLI): `npx skillmds@latest add naubergois/clicar-tela`
- Raw SKILL.md: https://api.skillmd.com/api/skills/naubergois/clicar-tela/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: naubergois (https://skillmd.com/u/naubergois)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/naubergois/clicar-tela

---


# Clicar na tela (humano)

## Quando usar

- Clicar botões/menus do **Cursor** ou outros apps macOS
- Digitar texto, atalhos, scroll
- Screencast automático enquanto o agente opera a UI
- **Não** use para sites no Chrome → prefira `browser-harness`

## Pré-requisitos

1. MCP `touchpoint` ativo (veja `/mcp` ou Settings → MCP)
2. **Acessibilidade** liberada para o **Cursor** (obrigatório)  
   Ajustes → Privacidade e Segurança → Acessibilidade → marcar **Cursor**
3. Opcional: marcar também **Terminal** se for rodar `cliclick` / scripts no shell
4. Teste:

```bash
./scripts/test_touchpoint_cursor.sh
```

## Ferramentas (MCP `user-touchpoint`)

Ordem típica:

1. `diagnostics` — confere AX / input (`dependencies.application_services`, `input_provider`)
2. `windows` ou `apps` — achar o Cursor
3. `activate_window` — trazer à frente
4. `snapshot` ou `screenshot` + `find` — localizar o controle
5. `click` (por `element_id` ou `x,y`)
6. `type_text` / `press_key` / `scroll` conforme a tarefa

### Clique confiável

- Preferir `click` com **`element_id`** (ação nativa de acessibilidade)
- Se falhar: `mouse_move` + `click` com coordenadas
- Fallback shell (precisa Acessibilidade no app do terminal):

```bash
cliclick c:500,400          # click
cliclick m:500,400          # move
cliclick kd:cmd t:v ku:cmd  # exemplo de atalho
```

## Fluxo screencast + clique

```bash
# Terminal A — grava tela
AUTO=0 MIX_VO=1 ./scripts/gravar_screencast_cursor.sh

# No chat — use esta skill / Touchpoint para clicar e digitar durante a gravação
```

## Stack instalada

| Peça | Onde |
|------|------|
| `touchpoint-py` 0.3.0 | `/Users/naubergois/qclawmonitor/.venv` |
| MCP bin | `.../.venv/bin/touchpoint-mcp` |
| MCP config | `~/.cursor/mcp.json` + `.cursor/mcp.json` |
| `cliclick` | `/opt/homebrew/bin/cliclick` |
| Teste | `scripts/test_touchpoint_cursor.sh` |
| Skill pessoal | `~/.cursor/skills/clicar-tela/` |

## Anti-padrões

- Não invente coordenadas sem `snapshot`/`screenshot`/`find`
- Não use Touchpoint para páginas web se o Chrome estiver acessível via harness
- Não grave `.env`, tokens ou chats pessoais no screencast