lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración principiante mcpclaude-codesafari

Safari MCP: conecta tu agente con Safari en macOS

Consulta páginas e interactúa con Safari desde un cliente MCP. Utiliza el navegador de tu Mac y verifica cada acción con el estado de la página.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

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.

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:

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 para el procedimiento completo y los cambios de versión.

ver en .md ¿Prefieres el recurso entero?

Qué es

Safari MCP es un servidor que conecta herramientas de agentes con el navegador Safari de macOS. Utiliza integración nativa y puede trabajar con el contexto de navegación del usuario.

Para qué te sirve

  • Cuando un flujo necesita una sesión ya iniciada en Safari.
  • Cuando quieres inspeccionar una página y comprobar después el resultado de una interacción.

Cómo funciona

El cliente MCP solicita observaciones y acciones al proceso Node.js. La integración con Safari usa AppleScript y componentes nativos; el proyecto también documenta una extensión. Su patrón recomendado alterna snapshot, interacción y una nueva observación para verificar el efecto.

Antes de empezar

Necesitas un Mac, Safari y Node.js 20 o posterior. Activa las funciones para desarrolladores de Safari y Allow JavaScript from Apple Events siguiendo el README. El servidor puede utilizar las sesiones existentes: elige con cuidado el perfil de prueba.

Límites y alternativas

La conexión local no evita que las páginas reciban acciones o que el modelo vea información del navegador. Prueba con una pestaña sin datos privados y evita operaciones irreversibles al aprender. Para pruebas repetibles en varios navegadores puedes considerar Playwright en un perfil de ensayo separado.

Recursos