Safari MCP

🦁 Safari MCP

O navegador para o seu agente de codificação.

Seu Safari real, com login feito — sem Chrome, sem aquecimento, sem headless.

Instalar no VS Code · VS Code Insiders · Instalar no Cursor

98 ferramentas · Sem necessidade de Chrome/Puppeteer/Playwright · ~5ms por comando · 60% menos CPU que o Chrome

Início Rápido · Todas as 98 Ferramentas · Exemplos · Por que Safari MCP? · Arquitetura · Changelog

❌ Sem Safari MCP

Seu agente de IA precisa navegar. Então ele:

• Inicia Chromium via Playwright — sem logins, sem cookies, sem sessões
• Usa Chrome DevTools MCP — e derrete o ventilador do seu computador rodando um segundo navegador
• Depende de scrapers headless — bloqueados por Cloudflare, reCAPTCHA e detecção de bots

✅ Com Safari MCP

Sua IA controla o Safari no qual você já está logado — Gmail, GitHub, Ahrefs, Slack, banco.

WebKit nativo. ~60% menos CPU. Operação em segundo plano. 98 ferramentas. Um único comando npx. Apenas macOS.

📰 Destaque no freeCodeCamp: Como Conectar Seu Agente de Codificação de IA a um Navegador no macOS · HackerNoon: Reverse-Engineering React, Shadow DOM e CSP

🍎 A Apple lança um Safari MCP oficial — safaridriver --mcp, primeiro no Safari Technology Preview 247 (julho de 2026) e no Safari estável desde a versão 27.0. Ele controla uma sessão de automação isolada para depuração. O safari-mcp controla o Safari real no qual você já está logado — seus cookies e sessões, em segundo plano, com 98 ferramentas. Veja a comparação completa abaixo.

Destaques

• 98 ferramentas — navegação, cliques, formulários, capturas de tela, rede, armazenamento, acessibilidade e muito mais
• Zero aquecimento — WebKit nativo em Apple Silicon, ~60% menos CPU que o Chrome
• Seu navegador real — mantém todos os logins, cookies e sessões (Gmail, GitHub, Ahrefs, etc.)
• Operação em segundo plano — o Safari permanece em segundo plano, sem roubar a janela
• Sem dependências de navegador — sem Puppeteer, sem Playwright, sem WebDriver, sem Chrome
• Processo persistente — reutiliza um único processo osascript (~5ms por comando vs ~80ms)
• Compatível com frameworks — preenchimento de formulários em React, Vue, Angular, Svelte via setters nativos

Nas palavras dos usuários

Depoimentos não solicitados — citações retiradas do rastreador de issues público, cada uma com link para o tópico de origem.

"Eu executo múltiplas sessões de Pi/subagentes contra meu perfil normal do Safari em paralelo. Compartilhar seus cookies e logins é intencional." — @maxim, sobre executar agentes concorrentes contra um navegador real

"O servidor tem um modelo deliberado de propriedade de abas … o código é cuidadoso com isso, e para o caso padrão essa é a postura de segurança correta." — @turner-moore, sobre por que as proteções se recusam a tocar nas suas abas

"Validação local direta do pacote: Safari MCP doctor 6/6." — @jrepp, que encontrou e corrigiu um bug de alinhamento de fila no helper de foco

Início Rápido

Pré-requisitos

• macOS (qualquer versão com Safari)
• Node.js 20+
• Safari → Ajustes → Avançado → Mostrar recursos para desenvolvedores web ✓
• Safari → Ajustes → Desenvolvedor → Permitir JavaScript de Apple Events ✓

Instalar (um comando)

npx safari-mcp

É isso — sem necessidade de instalação global. Ou instale permanentemente:

npm install -g safari-mcp

Configurar seu cliente MCP

Todos os clientes executam o Safari MCP da mesma forma — npx safari-mcp. Escolha seu editor:

claude mcp add safari -- npx safari-mcp

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "servers": {
    "safari": {
      "type": "stdio",
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

{
  "mcpServers": {
    "safari": {
      "command": "npx",
      "args": ["safari-mcp"]
    }
  }
}

mcpServers:
  - name: safari
    command: npx
    args:
      - safari-mcp

extensions:
  safari:
    name: safari
    type: stdio
    cmd: npx
    args:
      - safari-mcp
    enabled: true

{
  "context_servers": {
    "safari": {
      "command": {
        "path": "npx",
        "args": ["safari-mcp"]
      }
    }
  }
}

brew install achiya-automation/tap/safari-mcp

git clone https://github.com/achiya-automation/safari-mcp.git
cd safari-mcp && npm install

Fluxo de Trabalho de Uso

O padrão recomendado para agentes de IA usando Safari MCP:

1. safari_snapshot        → Get page state (accessibility tree)
2. safari_click/fill/...  → Interact with elements by ref
3. safari_snapshot        → Verify the result

Segmentação de elementos — as ferramentas aceitam múltiplas estratégias de segmentação:

Dica: Comece com safari_snapshot para obter refs de elementos e depois use refs para segmentação precisa. Isso é mais rápido e confiável do que seletores CSS.

Executando vários agentes ao mesmo tempo

Vários agentes ou subagentes controlando um único Safari ao mesmo tempo vão disputar a aba ativa — a menos que você os execute contra um daemon HTTP compartilhado em vez de um processo por cliente:

SAFARI_MCP_HTTP=1 SAFARI_MCP_HTTP_PORT=9225 npx safari-mcp

Depois aponte cada cliente para ele:

{ "mcpServers": { "safari-mcp": { "type": "http", "url": "http://127.0.0.1:9225/mcp" } } }

Um daemon, muitas sessões — e cada sessão tem seu próprio estado de aba. O servidor vincula activeTabIndex, o sinalizador de propriedade e um marcador de aba exclusivo ao ID da sessão MCP, então a sessão A fisicamente não consegue ler ou direcionar a aba da sessão B.

Duas propriedades tornam isso seguro em vez de apenas organizado:

• A identidade da aba é um marcador, não um índice. Cada sessão grava um ID exclusivo na página que abre, então a propriedade sobrevive à navegação e sobrevive ao usuário reordenar ou fechar outras abas. Um índice sozinho deslizaria silenciosamente para a aba errada.

• Falha de forma segura. Se a aba marcada de uma sessão não puder ser encontrada novamente, todas as ferramentas se recusam em vez de recorrer a qualquer aba que esteja na frente — porque essa aba geralmente é sua:

  Tab tracking lost — refusing to fall back to "current tab of window"
  (would target the user's active tab). Call safari_new_tab to reopen.
  

Isso também reduz drasticamente o número de processos: ~17 processos node para 17 sessões concorrentes vira 1.

SAFARI_PROFILE continua opcional — deixe sem definir e as sessões se vinculam às suas janelas normais do Safari, com cookies e logins intactos. Detalhes em docs/http-transport-design.md.

Prefere stdio (um processo por agente) em vez de um daemon persistente? Isso também funciona — o isolamento então vem do próprio limite do processo. Uma ressalva: se seu cliente multiplexa agentes via mcporter, o mcporter armazena em cache um único cliente MCP para todos eles — independentemente do transporte escolhido — então o servidor nunca vê sessões distintas e o isolamento por sessão não pode ser ativado. mcporter-lanes (uma extensão pi por @maxim, nascida da #76) corrige isso upstream: cada sessão de agente recebe seu próprio diretório de daemon — e, portanto, seu próprio safari-mcp — com um timeout de inatividade para que os processos não se acumulem.

Agindo em uma aba que você já tem aberta

Por padrão, o servidor toca apenas nas abas que ele mesmo abriu. Aponte-o para uma das suas e ele se recusa:

Tab safety: refusing "click" — current tab (https://mail.example.com/inbox) was not
opened by this MCP session. Use safari_new_tab or safari_switch_tab to target your own tab.

Esse padrão existe porque versões antigas realmente clicavam e fechavam as abas das pessoas. Mas "ler o artigo que estou vendo" e "preencher o formulário na minha tela" são casos reais, e reabrir a página perde o estado da sessão que tornou sua aba útil. Defina SAFARI_MCP_ALLOW_USER_TABS=1 e um safari_switch_tab explícito adota a aba em vez de recusá-la; a partir daí, a sessão trabalha nela como se fosse uma das suas, e informa isso:

{ "tabIndex": 3, "safeUrl": "https://mail.example.com/inbox", "note": "(user tab, opted-in)" }

O que o sinalizador deliberadamente não faz:

• Ele libera a adoção, não as proteções. Apenas safari_switch_tab adota, e apenas a aba que você nomeou. Um clique ou navegação comum nunca cai em qualquer aba que esteja na frente — o servidor age na aba para a qual você o apontou, não naquela para a qual você navegou.
• safari_close_tab ainda se recusa. Fechar é a única ação cujo custo você não pode desfazer, então uma aba adotada é gravável, nunca descartável. Feche-a você mesmo.
• A adoção é local à sessão. Nada é gravado no arquivo de propriedade compartilhado, então ela termina com a sessão em vez de vazar para o próximo processo na máquina.

safari_doctor imprime o estado do sinalizador, e toda operação em uma aba adotada registra (user tab, opted-in) — então "por que tocou na minha aba" tem uma resposta em vez de ser um mistério. Desativado por padrão; defina-o apenas para agentes com os quais você quer trabalhar dentro da sua própria sessão de navegação. Projetado em #92.

Variáveis de ambiente

SAFARI_MCP_RAISE_ON_NAVIGATE=1 é para agentes cujo objetivo principal é mostrar uma página — um assistente de voz respondendo "abrir YouTube", um driver de demonstração. Todo o resto deve deixá-lo desligado: por padrão, o Safari MCP trabalha em segundo plano e devolve o foco para o aplicativo que você estava usando, então um agente pode controlar uma página enquanto você continua digitando em outro lugar.

Ferramentas (98)

Segurança

O Safari MCP roda localmente no seu Mac com superfície de ataque mínima:

Safari MCP vs Alternativas

Dica: Use o Safari MCP para tarefas diárias de navegação (95% do trabalho) e o Chrome DevTools MCP apenas para auditorias de Lighthouse/Desempenho.

vs Safari MCP Oficial da Apple (safaridriver)

Em julho de 2026, a Apple lançou um servidor oficial Safari MCP construído sobre safaridriver — primeiro no Safari Technology Preview 247, e no Safari estável desde 27.0. Isso é uma ótima validação para a categoria — e ele é construído para um trabalho diferente. O servidor da Apple conduz uma sessão de automação WebDriver isolada para depuração; o safari-mcp conduz o Safari real no qual você já está logado.

No macOS 27.0 com Safari 27.0, safaridriver --help lista --mcp e seu tools/list responde com 17 entradas (verificado em 2026-09-15); o Safari 26.5.2 não tinha --mcp (verificado em 2026-07-23). Verifique sua própria máquina com safaridriver --help | grep mcp.

Executando ambos? O guia de configuração da Apple registra seu servidor sob o nome safari-mcp (claude mcp add safari-mcp -- /usr/bin/safaridriver --mcp) — o mesmo nome deste pacote. Dê a um deles um nome diferente, ex.: claude mcp add safari-webdriver -- /usr/bin/safaridriver --mcp, para que seu cliente não sobrescreva um com o outro ou deixe você adivinhando qual servidor respondeu.

Sobre a linha navigator.webdriver: o padrão WebDriver exige que toda sessão controlada remotamente relate true, então o servidor da Apple faz isso. O safari-mcp avalia JavaScript em uma aba comum, então ele lê false (verificado no Safari 27.0, 2026-09-17). Essa é a diferença se um site recusar tráfego WebDriver. Não é um recurso anti-detecção — nada mais sobre o navegador é disfarçado, e seus logins reais estão em uso, então trate cada página como se ela soubesse exatamente quem você é.

Quando o servidor da Apple é a escolha certa: você quer especificamente uma sessão limpa, padrão WebDriver, para depuração de compatibilidade no Safari 27 ou posterior. Para todo o resto — automação diária no navegador em que você já está conectado, em segundo plano — o safari-mcp foi construído exatamente para isso.

Por que Safari MCP e não os outros projetos Safari MCP?

Existem vários projetos "safari-mcp" por aí. Veja como eles se comparam:

TL;DR — se você quer o Safari MCP mais completo, com a instalação mais suave, mais ferramentas e manutenção ativa, este é o escolhido.

Arquitetura

O Safari MCP usa uma arquitetura de mecanismo duplo — a Extensão é preferida por velocidade e capacidades avançadas, com AppleScript como fallback sempre disponível:

Claude/Cursor/AI Agent
        ↓ MCP Protocol (stdio)
   Safari MCP Server (Node.js)
        ↓                    ↓
   Extension (HTTP)     AppleScript + Swift daemon
   (~5-20ms/cmd)        (~5ms/cmd, always available)
        ↓                    ↓
   Content Script       do JavaScript in tab N
        ↓                    ↓
   Page DOM ←←←←←←←←←← Page DOM

Principais decisões de design:

• Mecanismo duplo com fallback automático — a Extensão é preferida; se não estiver conectada, o AppleScript cuida de tudo perfeitamente
• Auxiliar Swift persistente — um processo de longa duração em vez de gerar por comando (16x mais rápido)
• Operações indexadas por aba — todo JS roda em uma aba específica por índice, nunca rouba o foco visual
• Abordagem JS-first — digitar, clicar, upload de arquivo usam eventos JavaScript (sem conflitos de teclado do System Events)
• Sem activate — o Safari nunca é trazido para o primeiro plano

Extensão do Safari (Opcional)

A Extensão do Safari MCP é opcional, mas recomendada. Sem ela, ~80% da funcionalidade funciona apenas com AppleScript. A extensão adiciona capacidades que o AppleScript não pode fornecer:

O que a Extensão Adiciona

Quando você precisa da extensão? Se você está automatizando SPAs modernos com shadow DOM fechado (ex.: Reddit), sites com Política de Segurança de Conteúdo estrita, ou editores com muitos frameworks (Draft.js, ProseMirror, Slate).

Instalando a Extensão

A extensão requer uma compilação única com Xcode (gratuito, incluído no macOS).

Nota para usuários npm: O diretório xcode/ não está incluído no pacote npm. Clone o repositório GitHub para compilar a partir do código-fonte.

Pré-requisitos: Xcode (instale pela App Store — gratuito)

# 1. Clone the repo (the npm package does not include the Xcode project)
git clone https://github.com/achiya-automation/safari-mcp.git
cd safari-mcp

# 2. Build a clean, Apple Development-signed app
# If needed, first choose your Team in Xcode → Signing & Capabilities.
xcodebuild -project "xcode/Safari MCP/Safari MCP.xcodeproj" \
  -scheme "Safari MCP (macOS)" -configuration Release \
  -allowProvisioningUpdates clean build

# 3. Locate the signed app
APP_PATH=$(find ~/Library/Developer/Xcode/DerivedData/Safari_MCP-*/Build/Products/Release -name "Safari MCP.app" -maxdepth 2 | head -1)

# 4. Re-sign safari-helper with the Apple Events entitlement
# (helps macOS surface the TCC Automation prompt reliably)
codesign --sign - --force --entitlements safari-helper.entitlements safari-helper

# 5. Open the app (needed once so Safari registers the extension)
open "$APP_PATH"

Não re-assine ad-hoc Safari MCP.app com codesign --deep --sign -. Isso substitui a identidade de Desenvolvimento Apple no wrapper e na extensão incorporada; o Safari atual pode silenciosamente desativar ou marcar a extensão como removida. Se uma compilação anterior foi assinada ad-hoc, execute o comando clean build acima novamente.

Alternativamente, abra xcode/Safari MCP/Safari MCP.xcodeproj diretamente no Xcode, selecione seu Apple ID em Assinatura e Capacidades, e clique em Executar. Uma conta pessoal gratuita de Desenvolvedor Apple é suficiente para uso local.

Depois, no Safari:

1. Safari → Ajustes → Avançado → ative Mostrar recursos para desenvolvedores web
2. Safari → Ajustes → Desenvolvedor → Permitir extensões não assinadas (necessário a cada reinício do Safari)
3. Safari → Ajustes → Extensões → ative Safari MCP Bridge

A extensão conecta automaticamente ao primeiro bridge local cujo perfil Safari declarado corresponde ao seu. As portas padrão do bridge são 9224, 9228, 9232 e 9236; uma configuração de perfil único normalmente usa 9224.

Nota: "Permitir extensões não assinadas" é redefinido toda vez que o Safari reinicia. Você precisará reativá-lo em Safari → Ajustes → Desenvolvedor após cada reinício. A extensão em si permanece instalada.

Status do ícone da barra de ferramentas:

• LIGADO — conectado ao servidor MCP
• DESLIGADO — desativado manualmente via popup
• (sem selo) — servidor não está rodando, reconectará automaticamente

Permissões do macOS

O Safari MCP precisa destas permissões únicas:

Concedendo Acessibilidade ao safari-helper (necessário para safari_native_*)

As ferramentas safari_native_click, safari_native_keyboard e safari_native_hover injetam eventos CGEvent no nível do SO no Safari sem roubar o foco. O macOS exige que o binário auxiliar subjacente seja aprovado em Acessibilidade antes que esses eventos possam alcançar uma janela não em primeiro plano.

1. Abra Ajustes do Sistema → Privacidade e Segurança → Acessibilidade (no macOS 27 o painel é chamado Controle de Dispositivos e Acesso a Dados).
2. Clique em + (desbloqueie com sua senha se necessário).
3. Navegue até o binário auxiliar e adicione-o:
   • Instalação global npm: $(npm root -g)/safari-mcp/safari-helper
   • Instalação npx / projeto: ./node_modules/safari-mcp/safari-helper
   • Clone do código-fonte: /path/to/safari-mcp/safari-helper
4. Certifique-se de que o interruptor ao lado dele está LIGADO.

O script pós-instalação re-assina o auxiliar com um identificador estável (com.achiya-automation.safari-mcp) para que esta permissão sobreviva a futuras atualizações — sem esse passo, cada npm update revogaria silenciosamente a aprovação porque o identificador assinado ad-hoc do binário muda a cada compilação.

Se safari_native_click relatar sucesso mas a página não reagir (nenhum evento de clique isTrusted: true dispara), o auxiliar provavelmente está sem esta aprovação. As ferramentas safari_* (não-native_) não precisam dela.

Concedendo Automação → Safari (importante para usuários de IDE)

O TCC do macOS concede a permissão de Automação ao processo pai que inicia o servidor MCP, não ao safari-mcp em si. Então você precisa conceder Automação → Safari ao aplicativo que executa Claude Code / Cursor / Windsurf — tipicamente Visual Studio Code ou Terminal.

Se o diálogo de permissão nunca aparecer automaticamente, execute este comando uma vez a partir de um Terminal que já tenha permissão de Automação:

osascript -e 'tell application "Safari" to get URL of current tab of window 1'

Essa chamada registra o aplicativo Terminal no banco de dados de Automação e então aciona o prompt para o Safari. Depois que você aprovar, chamadas MCP subsequentes de qualquer cadeia de processos filhos funcionarão.

Solução de Problemas

FAQ

Funciona Com

O Safari MCP funciona com qualquer cliente compatível com MCP:

Contribuindo

PRs são bem-vindos! Veja CONTRIBUTING.md para instruções de configuração.

O código-fonte tem dois arquivos:

• safari.js — camada de automação do Safari (AppleScript + JavaScript)
• index.js — servidor MCP com definições de ferramentas

Patrocinadores

O Safari MCP é gratuito e de código aberto. Se ele economiza seu tempo ou ciclos de CPU, considere apoiar seu desenvolvimento:

Seu apoio financia:

• 🧪 Testes em várias versões do macOS e lançamentos do Safari
• 🛠️ Novas ferramentas e recursos
• 📖 Documentação e exemplos

Seja o primeiro patrocinador!

Suporte Comercial

Precisa integrar o Safari MCP ao seu produto ou stack de agentes? A Achiya Automation oferece:

• Correções de bugs prioritárias e desenvolvimento de ferramentas personalizadas para seu caso de uso
• Consultoria de integração — conectando o Safari MCP a sistemas de agentes de produção (Claude, Cursor, n8n, personalizados)
• Suporte a implantação privada — Safari MCP multiusuário, ambientes macOS não padronizados, CI/CD
• Workshops de treinamento para equipes de engenharia que adotam automação baseada em MCP

Criado pelo autor do Safari MCP. Inicie uma conversa →

O que os agentes desbloqueiam com o Safari MCP

Quando um agente de IA controla o Safari MCP, ele obtém coisas que um navegador headless não consegue:

• Sessões autenticadas reais — Gmail, GitHub, Ahrefs, Slack, painéis bancários já estão todos logados
• Preenchimento de formulários ciente de frameworks — safari_fill_and_submit chama setters do React/Vue/Angular nativamente, sem adivinhar se os eventos input dispararam
• Operação em segundo plano — o agente trabalha em paralelo enquanto você continua usando seu Mac
• Uma chamada MCP por fluxo de trabalho — safari_run_script agrupa navegação + cliques + extração em uma única ida e volta

O padrão se mantém entre modelos: dirija o navegador em que o humano já confia — você herda logins, cookies, extensões e o ambiente exato do usuário em uma única etapa.

Comunidade

Mais de 6.000 downloads mensais de npm — desenvolvedores estão criando agentes de IA no macOS com o Safari MCP.

• Discussões no GitHub — faça perguntas, compartilhe casos de uso
• Issues — relatórios de bugs e solicitações de recursos
• — comece a contribuir

Ecossistema

Outros servidores MCP para macOS que complementam o Safari MCP:

Usando o Safari MCP junto com o Chrome DevTools MCP? O Safari lida com 95% da navegação diária (zero overhead), o Chrome lida com os 5% que precisam de Lighthouse ou rastreamentos específicos do Chrome.

Listado Em

Licença

MIT — use como quiser.

Criado pela Achiya Automation — automação e agentes de IA para negócios.