Safari MCP
oficialO 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 renderização da página — Peça ao seu agente para abrir um site no Safari e verificar estilos computados, layout e conteúdo da página.
- Depurar console e atividade de rede — Recupere logs de console em buffer e liste ou inspecione requisições de rede com cabeçalhos, corpo e tempo.
- Executar JavaScript e capturar screenshots — Avalie JavaScript na página para expor métricas de desempenho, ou capture um screenshot em PNG.
- Testar interações e estado do usuário — Execute sequências de click, type, scroll, hover e keyPress para verificar formulários e fluxos de checkout.
- Verificar acessibilidade — Peça ao seu agente para procurar rótulos ausentes, atributos ARIA inadequados e contraste ruim.
- Emular viewport e mídia — Defina o tamanho do viewport em pixels CSS ou emule um tipo de mídia como print para testes responsivos.
Documentação
Atualização: No Safari 27 e no Safari Technology Preview 247, estamos apresentando o servidor MCP do Safari — 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 são cada vez mais essenciais ao processo de programação, e o servidor MCP do Safari 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 MCP do Safari. Ao conectar seu agente a uma janela do navegador Safari, seu agente pode emular o que seus usuários vivenciam, fornecendo a ele as informações de que precisa 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 rodadas de alternar entre janelas e digitar prompts para depurar seu código.
Os casos de uso
Se você desenvolve para a web, então conhece a dança da depuração. Geralmente funciona mais ou menos assim:
Você vê algo errado com seu site no navegador. Você abre o console para investigar. Você clica na aba de estilos. Você vê o que está quebrado. Você volta ao seu código para corrigir. Ou talvez você tire uma captura de tela, detalhe o problema ao seu agente e deixe que ele faça a correção para você. Com sorte, ele acerta, o bug é corrigido e você pode 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ê usa, o fluxo de trabalho de depuração envolve muitos cliques, ferramentas e alternâncias de janela 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 MCP do Safari torna sua depuração mais rápida e eficiente.
O servidor MCP do Safari 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 com seu código, agora ele pode fazer ainda mais verificando como seu código realmente é renderizado no Safari.
Melhorar a compatibilidade com o Safari. Testar em apenas um navegador significa perder possíveis bugs em outro, dando a esses usuários uma experiência inferior. Com o servidor MCP do Safari, seu agente pode abrir seu site no Safari, inspecionar estilos computados, verificar o layout e compará-lo com o que você espera sem alternar janelas.
Analisar desempenho. Veja quais partes do seu site estão deixando as coisas mais lentas. O servidor MCP do Safari permite que seu agente avalie JavaScript na página para expor métricas de desempenho, como tempos de navegação e tempos de carregamento de recursos, para que ele possa identificar o que está deixando seu site mais lento e trabalhar na correção certa.
Verificar acessibilidade. O servidor MCP do Safari 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 impactam seus usuários.
Verificar qualquer estado do usuário. Saiba que a página está funcionando e parecendo 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 com essas 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 MCP do Safari 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 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 do navegador abertas 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 com o DOM em sequência: clique, digitação, rolagem, hover, keyPress, 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 viewport 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 MCP do Safari, 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 por conta própria.
Como começar
Safari 27
Primeiro, você precisará instalar o Safari 27. Depois de instalado, certifique-se de habilitar os recursos para desenvolvedores web e a automação remota. Para habilitar recursos para desenvolvedores web, escolha Safari > Ajustes > Avançado > marque a caixa de seleção Mostrar recursos para desenvolvedores web. Em seguida, vá em Safari > Ajustes > Desenvolvedor > marque "Permitir 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 -- "/usr/bin/safaridriver" --mcp
Se você estiver usando o 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. Depois de instalado, certifique-se de habilitar Safari Ajustes > Avançado > Mostrar recursos para desenvolvedores web. Em seguida, vá em Safari Ajustes > Desenvolvedor > Habilitar 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"]
}
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 MCP do Safari, 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, ele não deve precisar ser instruído a usar o servidor MCP do Safari explicitamente — ele descobrirá sozinho. Prompts simples como os acima são suficientes para iniciar o MCP.
Veja como uma conversa com um agente usando o servidor MCP do Safari poderia acontecer:
Você: Recebi um relatório de bug — algo está quebrado no Safari na página de voos. Você pode 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 os dois?
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 destacar. A animação de revelação dos resultados está silenciosamente quebrada e o log de inicialização do servidor de API está errado. Devo tratar os dois também?
Tudo o que você precisa é de uma solicitação inicial para começar e, com a ajuda do servidor MCP do Safari, seu agente pode assumir a partir daí.
O servidor MCP do Safari é 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 outras atividades 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 construímos isso
Há 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 fizer, 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 aparecem e funcionam no navegador.
Se você acabar experimentando ou se for sua primeira vez usando um servidor MCP, conte-nos o que você achou. Registre problemas pelo Feedback Assistant.
Você também pode nos encontrar online: Saron Yitbarek no Bluesky, Jen Simmons no Bluesky / Mastodon, e Jon Davis no Bluesky / Mastodon.