Safari MCP
공식Safari MCP 서버는 에이전트를 Safari 브라우저 창에 연결하여 코드가 브라우저에서 실제로 어떻게 렌더링되는지 알 수 있게 해줍니다.
Safari MCP(으)로 무엇을 할 수 있나요?
- 페이지 렌더링 검사 — 에이전트에게 Safari에서 사이트를 열고 계산된 스타일, 레이아웃, 페이지 콘텐츠를 확인하도록 요청하세요.
- 콘솔 및 네트워크 활동 디버그 — 버퍼링된 콘솔 로그를 가져오고 헤더, 본문, 타이밍과 함께 네트워크 요청을 나열하거나 검사하세요.
- JavaScript 실행 및 스크린샷 캡처 — 페이지에서 JavaScript를 평가하여 성능 지표를 표시하거나 PNG 스크린샷을 캡처하세요.
- 상호작용 및 사용자 상태 테스트 — click, type, scroll, hover, keyPress 시퀀스를 수행하여 양식과 결제 흐름을 검증하세요.
- 접근성 확인 — 에이전트에게 누락된 레이블, 부적절한 ARIA 속성, 낮은 대비를 찾도록 하세요.
- 뷰포트 및 미디어 에뮬레이션 — CSS 픽셀 단위로 뷰포트 크기를 설정하거나 반응형 테스트를 위해 print와 같은 미디어 유형을 에뮬레이션하세요.
문서
업데이트: Safari 27과 Safari Technology Preview 247에서 웹 개발자를 위한 Model Context Protocol 서버인 Safari MCP 서버를 소개합니다. 이 서버는 웹 개발 및 디버깅 워크플로를 더 빠르고 강력하게 만들어 줍니다. 에이전트가 코딩 과정에서 점점 더 중요한 역할을 맡고 있다는 것을 잘 알고 있습니다. 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 -- "/usr/bin/safaridriver" --mcp
Codex를 사용하는 경우 터미널에서 다음 명령을 사용할 수 있습니다.
codex mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp
다른 에이전트의 경우 mcp.json 또는 config.json 파일에 다음을 넣을 수 있습니다.
{
"mcpServers": {
"safari-mcp": {
"command": "/usr/bin/safaridriver",
"args": ["--mcp"]
}
}
}
Safari Technology Preview
먼저 Safari Technology Preview를 설치해야 합니다. 설치한 후에는 Safari 설정 > 고급 > "웹 개발자용 기능 표시"를 반드시 활성화하세요. 그런 다음 Safari 설정 > 개발자 > "원격 자동화 및 외부 에이전트 활성화"로 이동하세요.
Claude를 사용하는 경우 터미널에서 다음 명령을 사용할 수 있습니다.
claude mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp
Codex를 사용하는 경우 터미널에서 다음 명령을 사용할 수 있습니다.
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의 개인 정보(예: AutoFill 또는 기타 브라우저 활동)에 접근할 수 없습니다. 페이지 콘텐츠, 스크린샷, 콘솔 로그를 캡처할 때 해당 데이터는 Apple이 아닌 여러분이 실행 중인 에이전트로 직접 전달됩니다. 그 이후 데이터가 어떻게 처리되는지는 사용 중인 에이전트와 모델에 따라 다릅니다. 브라우저 접근 권한을 부여하는 모든 에이전트와 마찬가지로, 신뢰하는 에이전트만 사용하세요.
이 도구를 만든 이유
웹을 위한 개발 방법은 AI를 사용하든 사용하지 않든 다양합니다. AI가 워크플로의 일부라면, 이 도구가 워크플로를 더욱 생산적으로 만드는 데 도움이 될 것이라고 생각합니다. AI가 워크플로의 일부가 아니라면, 그래도 괜찮습니다.
이 리소스를 만들어서 에이전트가 브라우저에서 사물이 어떻게 보이고 작동하는지 이해하도록 도움으로써, Safari에서 테스트하고 디버깅하는 것을 그 어느 때보다 쉽게 만들고자 합니다.
한번 사용해 보시거나 MCP 서버를 처음 사용해 보신다면, 의견을 알려주세요. Feedback Assistant를 통해 이슈를 제출하세요.
또한 온라인에서도 만날 수 있습니다: Saron Yitbarek은 Bluesky, Jen Simmons는 Bluesky / Mastodon, Jon Davis는 Bluesky / Mastodon에서 활동하고 있습니다.