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. Отправка отчётов действительно имеет значение.