Safari MCP

Atualização: No Safari 27 e no Safari Technology Preview 247, estamos apresentando o servidor Safari MCP — um servidor de Model Context Protocol para desenvolvedores web que torna seu fluxo de trabalho de desenvolvimento e depuração mais rápido e poderoso. Sabemos que os agentes são cada vez mais essenciais no processo de codificação, e o servidor Safari MCP dá ao seu agente a capacidade de saber como seu código realmente renderiza no navegador, conectando-o a uma janela do navegador Safari.

Qualquer cliente compatível com MCP pode se conectar ao servidor Safari MCP. Ao conectar seu agente a uma janela do navegador Safari, seu agente pode simular o que seus usuários experimentam, dando a ele as informações necessárias para depurar de forma mais autônoma, como acesso ao DOM, requisições de rede, capturas de tela e saída do console.

Isso acelera seu processo de depuração e permite que você permaneça no conforto do seu terminal, o que significa menos idas e vindas entre janelas e menos digitação de prompts para depurar seu código.

Os casos de uso

Se você desenvolve para a web, conhece a dança da depuração. Geralmente funciona assim:

Você vê algo errado no seu site no navegador. Abre o console para investigar. Clica na aba de estilos. Vê o que está quebrado. Volta ao seu código para corrigir. Ou talvez tire uma captura de tela, detalhe o problema ao seu agente e deixe que ele faça a correção para você. Esperamos que ele acerte, o bug seja corrigido e você possa seguir em frente.

Mas quando não é corrigido, você passa pelo fluxo de trabalho novamente — Navegador. Prompt. Agente.

E de novo e de novo, até finalmente eliminar o bug.

Independentemente do navegador ou das ferramentas que você use, o fluxo de trabalho de depuração envolve muitos cliques, ferramentas e trocas de janelas para fazer uma única correção, mas não precisa ser assim. Se você já usa agentes no seu fluxo de desenvolvimento, o servidor Safari MCP torna sua depuração mais rápida e eficiente.

O servidor Safari MCP permite que seu agente faça mais depuração e solução de problemas por conta própria. Aqui estão apenas alguns exemplos do que ele pode ajudar:

Desenvolvimento web no Safari. Na próxima vez que você desenvolver no Safari, você se beneficiará de um fluxo de trabalho aprimorado. Seu agente já ajuda você com seu código; agora ele pode fazer ainda mais verificando como seu código realmente renderiza no Safari.

Melhore a compatibilidade com o Safari. Testar em apenas um navegador significa perder possíveis bugs em outro, proporcionando uma experiência inferior a esses usuários. Com o servidor Safari MCP, seu agente pode abrir seu site no Safari, inspecionar estilos computados, verificar o layout e compará-lo com o que você espera, sem trocar de janelas.

Analise o desempenho. Veja quais partes do seu site estão deixando tudo mais lento. O servidor Safari MCP permite que seu agente avalie JavaScript na página para revelar métricas de desempenho, como tempo de navegação e tempos de carregamento de recursos, para que ele possa identificar o que está deixando seu site lento e trabalhar na correção certa.

Verifique a acessibilidade. O servidor Safari MCP permite que seu agente verifique problemas comuns de acessibilidade, como rótulos ausentes, atributos ARIA inadequados e contraste ruim, para que você possa detectar problemas que afetam seus usuários.

Verifique qualquer estado do usuário. Saiba que a página está funcionando e aparecendo como deveria. Seu agente pode verificar o estado do formulário, consultar um elemento usando um seletor, confirmar interações específicas, mostrar diferentes estados de um fluxo de checkout e muito mais. Gaste menos tempo nessas verificações manuais e capacite o agente a fazer isso por você.

Estes são apenas alguns dos casos de uso. Independentemente de como você decidir implementá-lo, o servidor Safari MCP ajuda seu agente a fazer mais por você e reduz toda a ida e volta que o desenvolvimento web frequentemente exige. Um fluxo de trabalho mais fácil significa mais bugs eliminados, usuários mais satisfeitos e um produto melhor.

As ferramentas

Aqui estão as ferramentas disponíveis e o que elas fazem:

Ferramenta	Descrição
browser_console_messages	Retorna logs de console armazenados em buffer para a aba atual ou especificada
browser_dialogs	Lista e responde a diálogos do navegador (aceitar, dispensar ou inserir texto para prompts JS)
close_tab	Fecha uma aba do navegador pelo seu identificador
create_tab	Cria uma nova aba do navegador, opcionalmente carregando uma URL
evaluate_javascript	Executa código JavaScript dentro da página e retorna o resultado
get_network_request	Obtém detalhes completos de uma única requisição de rede registrada (cabeçalhos, corpo, tempo)
get_page_content	Extrai o conteúdo de texto de uma página em vários formatos (markdown, HTML, JSON, etc.)
list_network_requests	Lista resumos de requisições de rede (URL, método, status, tempo) para a aba atual
list_tabs	Lista todas as abas abertas do navegador com seus identificadores e URLs
navigate_to_url	Navega para uma URL e retorna o conteúdo da página carregada
page_info	Obtém informações sobre a página atual: URL, título e estado de carregamento
page_interactions	Executa interações DOM em sequência: clicar, digitar, rolar, passar o mouse, pressionar tecla, etc.
screenshot	Captura uma captura de tela da página atual como PNG
set_emulated_media	Emula um tipo de mídia CSS (por exemplo, "print") para testes de design responsivo
set_viewport_size	Define o tamanho da janela de visualização do navegador em pixels CSS
switch_tab	Alterna para uma aba diferente do navegador pelo seu identificador
wait_for_navigation	Aguarda a página atual terminar de carregar; retorna a URL final e o título

Com o servidor Safari MCP, você não precisa mais escrever o prompt perfeito, descrevendo cuidadosamente ao seu agente o que você está vivenciando no navegador. Você pode dar ao seu agente a capacidade de descobrir isso por conta própria.

Como começar

Safari 27

Primeiro, você precisará instalar o Safari 27. Após a instalação, certifique-se de habilitar os recursos de desenvolvedor web e a automação remota. Para habilitar os recursos para desenvolvedores web, escolha Safari > Ajustes > Avançado > marque a caixa de seleção Mostrar recursos para desenvolvedores web. Em seguida, vá para Safari > Ajustes > Desenvolvedor > marque "Permitir automação remota e agentes externos."

Se você estiver usando Claude, pode usar o seguinte comando no seu terminal:

claude mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp

Se você estiver usando Codex, pode usar o seguinte comando no seu terminal:

codex mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp

Para outros agentes, você pode colocar o seguinte no seu arquivo mcp.json ou config.json.

{
  "mcpServers": {
    "safari-mcp": {
      "command": "/usr/bin/safaridriver",
      "args": ["--mcp"]
    }
  }
}

Safari Technology Preview

Primeiro, você precisará instalar o Safari Technology Preview. Após a instalação, certifique-se de habilitar Ajustes do Safari > Avançado > Mostrar recursos para desenvolvedores web. Em seguida, vá para Ajustes do Safari > Desenvolvedor > Habilitar automação remota e agentes externos.

Se você estiver usando Claude, pode usar o seguinte comando no seu terminal:

claude mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp

Se você estiver usando Codex, pode usar o seguinte comando no seu terminal:

codex mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp

Para outros agentes, você pode colocar o seguinte no seu mcp.json ou config.json:

"safari-mcp-stp": {
  "command": "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver",
  "args": ["--mcp"] 
}

Observe que, embora o código acima nomeie o servidor como safari-mcp-stp, você pode nomeá-lo como quiser, até mesmo apenas safari. Depois de instalar o servidor Safari MCP, experimente um dos seguintes prompts:

Find bugs on my site in Safari

How accessible is my site in Safari?

See how my website performs in Safari

Embora cada agente funcione de maneira um pouco diferente, não deve ser necessário instruí-lo explicitamente a usar o servidor Safari MCP — ele descobrirá isso por conta própria. Prompts simples como os acima são suficientes para iniciar o MCP.

Aqui está um exemplo de como uma conversa com um agente usando o servidor Safari MCP pode ocorrer:

Você: Recebi um relatório de bug — algo está quebrado no Safari na página de voos. Você consegue descobrir o que está acontecendo?

Agente: Claro, deixe-me dar uma olhada.

Agente: Encontrei dois bugs distintos na página de voos no Safari. Quer que eu corrija ambos?

Você: Sim. Há mais alguma coisa aqui que possa estar causando problemas para usuários do Safari?

Agente: Sim, mais duas coisas que valem a pena destacar. A animação de revelação dos resultados está silenciosamente quebrada e o log de inicialização do servidor da API está incorreto. Devo lidar com ambas também?

Tudo o que você precisa é de uma solicitação inicial para começar, e com a ajuda do servidor Safari MCP, seu agente pode continuar a partir daí.

O servidor Safari MCP é executado inteiramente na sua máquina local e não faz chamadas de rede próprias. Ele também não tem acesso às suas informações pessoais no Safari (por exemplo, Preenchimento Automático ou outra atividade do navegador). Quando ele captura conteúdo de página, capturas de tela ou logs de console, esses dados vão diretamente para o agente que você está executando — não para a Apple. O que acontece com esses dados a partir daí depende do agente e do modelo que você está usando. Como com qualquer agente ao qual você dá acesso ao seu navegador, use apenas aqueles em que você confia.

Por que criamos isso

Existem muitas maneiras de desenvolver para a web, com e sem IA. Se a IA faz parte do seu fluxo de trabalho, acreditamos que esta ferramenta ajudará a torná-lo ainda mais produtivo. E se não faz, tudo bem também.

Ao criar este recurso, esperamos facilitar mais do que nunca o teste e a depuração no Safari, ajudando seu agente a entender como as coisas parecem e funcionam no navegador.

Se você experimentar ou se esta for sua primeira vez usando um servidor MCP, conte-nos o que achou.

Encontre-nos online: Saron Yitbarek no Bluesky, Jen Simmons no Bluesky / Mastodon e Jon Davis no Bluesky / Mastodon. Se você encontrar algum problema, registre um relatório de bug do WebKit. Registrar problemas realmente faz diferença.