Safari MCP

oficial

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.

O que você pode fazer com Safari MCP?

  • Inspecionar a página atual — Peça ao seu agente para extrair o conteúdo da página como markdown, HTML ou JSON usando get_page_content.
  • Depurar JavaScript e erros de console — Peça ao seu agente para recuperar logs de console armazenados em buffer com browser_console_messages ou executar JavaScript arbitrário via evaluate_javascript.
  • Investigar atividade de rede — Permita que seu agente liste todas as requisições de rede registradas (list_network_requests) e inspecione detalhes completos de requisição/resposta com get_network_request.
  • Verificar layout e estilização — Peça ao seu agente para capturar uma screenshot, consultar elementos ou verificar estilos computados para comparar a renderização com as expectativas.
  • Simular modos responsivo e de impressão — Direcione seu agente para redimensionar a viewport (set_viewport_size) ou emular tipos de mídia CSS como “print” (set_emulated_media).
  • Automatizar interações na página — Peça ao seu agente para realizar sequências de clique, digitação, rolagem ou passar o mouse usando page_interactions para verificar estados de formulário e fluxos de checkout.

Documentação

Apresentando o servidor Safari MCP para desenvolvedores web

1 de julho de 2026

por Saron Yitbarek

No Safari Technology Preview 247, estamos apresentando o servidor Safari MCP — um servidor Model Context Protocol para desenvolvedores web que torna seu fluxo de trabalho de desenvolvimento e depuração web mais rápido e poderoso. Sabemos que os agentes estão cada vez mais integrados ao processo de codificação, e o servidor Safari MCP dá ao seu agente a capacidade de saber como seu código é realmente renderizado 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, ele pode emular o que seus usuários experimentam, fornecendo 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 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 é mais ou menos 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 código para corrigir. Ou talvez tire uma captura de tela, detalhe o problema para seu agente e deixe que ele faça a correção. Com sorte, ele acerta, o bug é corrigido e você pode seguir em frente.

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

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

Independentemente do navegador ou ferramentas que você usa, o fluxo de trabalho de depuração envolve muitos cliques, ferramentas e troca de janelas para fazer uma única correção, mas não precisa ser assim. Se você já usa agentes no seu fluxo de trabalho 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, se beneficiará de um fluxo de trabalho aprimorado. Seu agente já ajuda com seu código, agora pode fazer ainda mais verificando como seu código é realmente renderizado 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 esperado sem trocar de janelas.

Analise o desempenho. Veja quais partes do seu site estão deixando as coisas mais lentas. O servidor Safari MCP permite que seu agente avalie JavaScript na página para expor 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 baixo contraste, para que você possa detectar problemas que impactam seus usuários.

Verifique qualquer estado do usuário. Saiba que a página está funcionando e com a aparência esperada. 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. Passe menos tempo nessas verificações manuais e capacite o agente a fazê-las 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 reduzir todo o vaivém que o desenvolvimento web frequentemente exige. Um fluxo de trabalho mais fácil significa mais bugs eliminados, usuários mais felizes e um produto melhor.

As ferramentas

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

FerramentaDescrição
browser_console_messagesRetorna logs do console em buffer para a aba atual ou especificada
browser_dialogsLista e responde a diálogos do navegador (aceitar, dispensar ou inserir texto para prompts JS)
close_tabFecha uma aba do navegador pelo seu identificador
create_tabCria uma nova aba do navegador, opcionalmente carregando uma URL
evaluate_javascriptExecuta código JavaScript dentro da página e retorna o resultado
get_network_requestObtém detalhes completos de uma única requisição de rede gravada (cabeçalhos, corpo, tempo)
get_page_contentExtrai o conteúdo de texto de uma página em vários formatos (markdown, HTML, JSON, etc.)
list_network_requestsLista resumos de requisições de rede (URL, método, status, tempo) para a aba atual
list_tabsLista todas as abas abertas do navegador com seus identificadores e URLs
navigate_to_urlNavega para uma URL e retorna o conteúdo da página carregada
page_infoObtém informações sobre a página atual: URL, título e estado de carregamento
page_interactionsRealiza interações DOM em sequência: clique, digitar, rolar, passar o mouse, keyPress, etc.
screenshotCaptura uma captura de tela da página atual como PNG
set_emulated_mediaEmula um tipo de mídia CSS (ex.: “print”) para testes de design responsivo
set_viewport_sizeDefine o tamanho da janela de visualização do navegador em pixels CSS
switch_tabAlterna para uma aba diferente do navegador pelo seu identificador
wait_for_navigationAguarda 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á vendo no navegador. Você pode dar ao seu agente a capacidade de descobrir por si mesmo.

Como começar

Primeiro, você precisará instalar o Safari Technology Preview. Uma vez instalado, certifique-se de habilitar Ajustes do Safari > Avançado > Mostrar funcionalidades para desenvolvedores web. Depois, vá para Ajustes do Safari > Desenvolvedor > Ativar automação remota e agentes externos.

Se você estiver usando o 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 o 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"] 
}

Note 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, tente 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 forma um pouco diferente, não deve ser necessário instruí-lo explicitamente a usar o servidor Safari MCP — ele descobrirá 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 ser:

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 vale a pena mencionar. A animação de revelação dos resultados está silenciosamente quebrada e o log de inicialização do servidor da API está errado. Devo resolver ambos 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 prosseguir a partir daí.

O servidor Safari MCP é executado inteiramente na sua máquina local e não faz chamadas de rede por conta própria. 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 captura conteúdo da página, capturas de tela ou logs do 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 construímos isso

Existem muitas maneiras de desenvolver para a web, tanto com quanto 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 tornar mais fácil do que nunca testar e depurar no Safari, ajudando seu agente a entender como as coisas parecem e funcionam no navegador.

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

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 no WebKit. Registrar problemas realmente faz a diferença.