# Instrucciones para el agente: Safari MCP: conecta tu agente con Safari en macOS

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: principiante
- Proyecto: https://github.com/achiya-automation/safari-mcp (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/safari-mcp-server

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

En tu Mac, comprueba Safari, Node.js ≥20, npm/npx y Claude Code accesible como claude. Después activa los permisos de Safari descritos en el paso 1 y usa una pestaña de prueba.

### Paso 1: prepara Safari

En Settings activa Show features for web developers y después Allow JavaScript from Apple Events, como explica el README.

### Paso 2: registra el servidor

Para Claude Code:

```bash
claude mcp add safari -- npx safari-mcp
```

### Paso 3: prueba una pestaña

Pide abrir una página pública de ensayo. Solicita `safari_snapshot`, una interacción simple y una nueva observación. Evita tomar una pestaña del usuario sin elegirla expresamente.

## Comprobación

Comprueba que el agente observa la pestaña correcta y que el segundo snapshot refleja la acción. Revisa los avisos de propiedad de pestañas antes de continuar.

## Si algo falla

Si Safari rechaza JavaScript, revisa la opción de Apple Events y los permisos de macOS. Si se pierde el seguimiento de la pestaña, sigue la indicación del servidor y abre una nueva para la sesión.

Consulta el [README oficial](https://github.com/achiya-automation/safari-mcp#readme) para el procedimiento completo y los cambios de versión.