Safari MCP

официальный

Сервер Safari MCP предоставляет вашему агенту возможность видеть, как ваш код на самом деле отображается в браузере, подключая его к окну браузера Safari.

Документация

Представляем сервер Safari MCP для веб-разработчиков

1 июля 2026 г.

автор Saron Yitbarek

Обновление: В бета-версии Safari 27 и Safari Technology Preview 247 мы представляем сервер Safari MCP — сервер Model Context Protocol для веб-разработчиков, который делает ваш процесс веб-разработки и отладки быстрее и мощнее. Мы знаем, что агенты становятся всё более неотъемлемой частью процесса написания кода, и сервер Safari MCP даёт вашему агенту возможность узнать, как ваш код на самом деле отображается в браузере, подключая его к окну браузера Safari.

Любой MCP-совместимый клиент может подключиться к серверу Safari MCP. Подключив вашего агента к окну браузера Safari, агент может эмулировать то, что испытывают ваши пользователи, предоставляя ему информацию, необходимую для более автономной отладки, такую как доступ к DOM, сетевым запросам, скриншотам и выводу консоли.

Это ускоряет процесс отладки и позволяет вам оставаться в удобстве вашего терминала, что означает меньше переключений между окнами и ввода подсказок для отладки вашего кода.

Варианты использования

Если вы создаёте для веба, то вы знаете о «танце отладки». Обычно это выглядит примерно так:

Вы видите что-то неладное с вашим сайтом в браузере. Вы открываете консоль, чтобы выследить проблему. Вы переходите на вкладку стилей. Вы видите, что сломано. Вы возвращаетесь к коду, чтобы исправить это. Или вы делаете скриншот, подробно описываете проблему своему агенту и позволяете ему исправить её за вас. Надеюсь, он справится, ошибка будет исправлена, и вы сможете двигаться дальше.

Но когда это не исправлено, вы проходите через рабочий процесс снова — Браузер. Подсказка. Агент.

И снова, и снова, пока вы, наконец, не устраните ошибку.

Независимо от того, какой браузер или инструменты вы используете, рабочий процесс отладки — это множество кликов, инструментов и переключений окон для одного исправления, но так быть не должно. Если вы уже используете агентов в своём процессе разработки, сервер Safari MCP делает вашу отладку быстрее и эффективнее.

Сервер Safari MCP позволяет вашему агенту выполнять больше отладки и устранения неполадок самостоятельно. Вот лишь несколько примеров того, с чем он может помочь:

Веб-разработка в Safari. В следующий раз, когда вы будете разрабатывать в Safari, вы получите преимущество от улучшенного рабочего процесса. Ваш агент уже помогает вам с кодом, теперь он может делать ещё больше, проверяя, как ваш код на самом деле отображается в Safari.

Улучшение совместимости с Safari. Тестирование только в одном браузере означает упущение потенциальных ошибок в другом, что создаёт неудовлетворительный опыт для этих пользователей. С сервером Safari MCP ваш агент может открыть ваш сайт в Safari, проверить вычисленные стили, проверить макет и сравнить его с тем, что вы ожидаете, без переключения окон.

Анализ производительности. Посмотрите, какие части вашего сайта замедляют работу. Сервер Safari MCP позволяет вашему агенту выполнять JavaScript на странице для получения метрик производительности, таких как время навигации и время загрузки ресурсов, чтобы он мог точно определить, что замедляет ваш сайт, и работать над правильным исправлением.

Проверка доступности. Сервер Safari MCP позволяет вашему агенту проверять распространённые проблемы доступности, такие как отсутствующие метки, неправильные атрибуты ARIA и плохой контраст, чтобы вы могли выявить проблемы, влияющие на ваших пользователей.

Проверка любого состояния пользователя. Знайте, что страница работает и выглядит так, как должна. Ваш агент может проверить состояние формы, запросить элемент с помощью селектора, подтвердить определённые взаимодействия, показать различные состояния процесса оформления заказа и многое другое. Тратьте меньше времени на эти ручные проверки и дайте агенту возможность делать это за вас.

Это лишь некоторые из вариантов использования. Как бы вы ни решили его внедрить, сервер Safari MCP помогает вашему агенту делать больше для вас и сократить все те хождения туда-сюда, которых часто требует веб-разработка. Более простой рабочий процесс означает больше исправленных ошибок, более счастливых пользователей и лучший продукт.

Инструменты

Вот доступные инструменты и их назначение:

ИнструментОписание
browser_console_messagesВозвращает буферизованные логи консоли для текущей или указанной вкладки
browser_dialogsПеречисляет диалоги браузера и отвечает на них (принять, отклонить или ввести текст для JS-подсказок)
close_tabЗакрывает вкладку браузера по её дескриптору
create_tabСоздаёт новую вкладку браузера, опционально загружая URL
evaluate_javascriptВыполняет код JavaScript на странице и возвращает результат
get_network_requestПолучает полную информацию об одном записанном сетевом запросе (заголовки, тело, время)
get_page_contentИзвлекает текстовое содержимое страницы в различных форматах (markdown, HTML, JSON и т.д.)
list_network_requestsПеречисляет сводки сетевых запросов (URL, метод, статус, время) для текущей вкладки
list_tabsПеречисляет все открытые вкладки браузера с их дескрипторами и URL
navigate_to_urlПереходит по URL и возвращает содержимое загруженной страницы
page_infoПолучает информацию о текущей странице: URL, заголовок и состояние загрузки
page_interactionsВыполняет последовательность взаимодействий с DOM: клик, ввод, прокрутка, наведение, нажатие клавиш и т.д.
screenshotДелает скриншот текущей страницы в формате PNG
set_emulated_mediaЭмулирует тип медиа CSS (например, «print») для тестирования адаптивного дизайна
set_viewport_sizeУстанавливает размер области просмотра браузера в пикселях CSS
switch_tabПереключается на другую вкладку браузера по её дескриптору
wait_for_navigationОжидает завершения загрузки текущей страницы; возвращает конечный URL и заголовок

С сервером Safari MCP вам больше не нужно писать идеальную подсказку, тщательно описывая своему агенту то, что вы видите в браузере. Вы можете дать своему агенту возможность узнать это самостоятельно.

Как начать работу

Бета-версия Safari 27

Во-первых, вам нужно установить бета-версию Safari 27. После установки обязательно включите функции для веб-разработчиков и удалённую автоматизацию. Чтобы включить функции для веб-разработчиков, выберите Safari > Настройки > Дополнения > установите флажок «Показывать функции для веб-разработчиков». Затем перейдите в Safari > Настройки > Разработка > установите флажок «Разрешить удалённую автоматизацию и внешних агентов».

Если вы используете Claude, вы можете использовать следующую команду в терминале:

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

Если вы используете Codex, вы можете использовать следующую команду в терминале:

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

Для других агентов вы можете поместить следующее в ваш файл mcp.json или config.json.

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

Safari Technology Preview

Во-первых, вам нужно установить Safari Technology Preview. После установки убедитесь, что вы включили Safari > Настройки > Дополнения > Показывать функции для веб-разработчиков. Затем перейдите в Safari > Настройки > Разработка > Включить удалённую автоматизацию и внешних агентов.

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

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

Для других агентов вы можете поместить следующее в ваш mcp.json или config.json :

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

Обратите внимание, что хотя в приведённом выше коде сервер назван safari-mcp-stp, вы можете назвать его как угодно, даже просто safari. После установки сервера Safari MCP попробуйте одну из следующих подсказок:

Find bugs on my site in Safari

How accessible is my site in Safari?

See how my website performs in Safari

Хотя каждый агент работает немного по-разному, ему не нужно явно указывать использовать сервер Safari MCP — он разберётся самостоятельно. Простых подсказок, подобных приведённым выше, достаточно, чтобы запустить MCP.

Вот как может выглядеть разговор с агентом, использующим сервер Safari MCP:

Вы: Получил отчёт об ошибке — что-то сломано в Safari на странице рейсов. Можешь выяснить, в чём дело?

Агент: Конечно, давай посмотрю.

Агент: Я нашёл две отдельные ошибки на странице рейсов в Safari. Хочешь, чтобы я исправил обе?

Вы: Да. Есть ли здесь что-то ещё, что может вызвать проблемы у пользователей Safari?

Агент: Да, ещё два момента, на которые стоит обратить внимание. Анимация появления результатов молча сломана, и журнал запуска API-сервера неверен. Мне заняться и тем, и другим?

Всё, что вам нужно, — это первоначальный запрос, чтобы начать, а с помощью сервера Safari MCP ваш агент может продолжить работу самостоятельно.

Сервер Safari MCP работает полностью на вашем локальном компьютере и не совершает собственных сетевых вызовов. Он также не имеет доступа к вашей личной информации в Safari (например, автозаполнение или другая активность браузера). Когда он захватывает содержимое страницы, скриншоты или логи консоли, эти данные отправляются непосредственно агенту, которого вы используете, — а не в Apple. Что происходит с этими данными дальше, зависит от агента и модели, которые вы используете. Как и в случае с любым агентом, которому вы предоставляете доступ к браузеру, используйте только тех, кому доверяете.

Почему мы это создали

Существует множество способов создавать для веба, как с ИИ, так и без него. Если ИИ является частью вашего рабочего процесса, мы думаем, что этот инструмент поможет сделать его ещё более продуктивным. А если нет, это тоже нормально.

Создавая этот ресурс, мы надеемся сделать тестирование и отладку в Safari проще, чем когда-либо, помогая вашему агенту понять, как всё выглядит и работает в браузере.

Если вы в итоге попробуете его или если это ваш первый опыт использования сервера MCP, дайте нам знать, что вы думаете.

Найдите нас онлайн: Saron Yitbarek в BlueSky, Jen Simmons в Bluesky / Mastodon и Jon Davis в Bluesky / Mastodon. Если вы столкнётесь с какими-либо проблемами, отправьте отчёт об ошибке WebKit. Отправка отчётов действительно имеет значение.