Safari MCP

resmi

Server Safari MCP memberikan kemampuan kepada agen Anda untuk mengetahui bagaimana kode Anda benar-benar dirender di browser dengan menghubungkannya ke jendela browser Safari.

Apa yang bisa Anda lakukan dengan Safari MCP?

  • Periksa rendering halaman — Minta agen Anda membuka situs di Safari dan memeriksa computed styles, tata letak, dan konten halaman.
  • Debug konsol dan aktivitas jaringan — Ambil log konsol yang di-buffer dan daftar atau periksa permintaan jaringan dengan header, body, dan timing.
  • Jalankan JavaScript dan ambil screenshot — Evaluasi JavaScript di halaman untuk menampilkan metrik performa, atau ambil screenshot PNG.
  • Uji interaksi dan status pengguna — Lakukan urutan click, type, scroll, hover, dan keyPress untuk memverifikasi formulir dan alur checkout.
  • Periksa aksesibilitas — Minta agen Anda mencari label yang hilang, atribut ARIA yang tidak tepat, dan kontras yang buruk.
  • Emulasikan viewport dan media — Atur ukuran viewport dalam piksel CSS atau emulasikan tipe media seperti print untuk pengujian responsif.

Dokumentasi

Pembaruan: Di Safari 27 dan Safari Technology Preview 247, kami memperkenalkan server Safari MCP — sebuah server Model Context Protocol untuk pengembang web yang membuat alur kerja pengembangan dan debugging web Anda lebih cepat dan lebih andal. Kami tahu agen semakin menjadi bagian integral dari proses pengodean, dan server Safari MCP memberi agen Anda kemampuan untuk mengetahui bagaimana kode Anda sebenarnya dirender di browser dengan menghubungkannya ke jendela browser Safari.

Klien apa pun yang kompatibel dengan MCP dapat terhubung ke server Safari MCP. Dengan menghubungkan agen Anda ke jendela browser Safari, agen Anda dapat meniru apa yang dialami pengguna Anda, memberinya informasi yang dibutuhkan untuk melakukan debugging secara lebih mandiri, seperti akses ke DOM, permintaan jaringan, tangkapan layar, dan keluaran konsol.

Ini mempercepat proses debugging Anda dan memungkinkan Anda tetap berada di terminal yang nyaman, yang berarti lebih sedikit bolak-balik antarjendela dan mengetik prompt untuk men-debug kode Anda.

Kasus penggunaan

Jika Anda membangun untuk web, Anda pasti tahu tentang tarian debugging. Biasanya kira-kira seperti ini:

Anda melihat ada yang salah dengan situs Anda di browser. Anda membuka konsol untuk melacaknya. Anda mengklik tab styles. Anda melihat apa yang rusak. Anda kembali ke kode Anda untuk memperbaikinya. Atau mungkin Anda mengambil tangkapan layar, menjelaskan masalahnya kepada agen Anda, dan membiarkannya melakukan perbaikan untuk Anda. Semoga agen itu melakukannya dengan benar, bug teratasi, dan Anda bisa melanjutkan.

Tetapi ketika bug tidak teratasi, Anda menjalani alur kerja itu lagi — Browser. Prompt. Agen.

Dan lagi dan lagi, sampai akhirnya Anda berhasil memberantas bug tersebut.

Terlepas dari browser atau alat yang Anda gunakan, alur kerja debugging membutuhkan banyak klik, alat, dan perpindahan jendela hanya untuk melakukan satu perbaikan, tetapi tidak harus seperti itu. Jika Anda sudah menggunakan agen dalam alur kerja pengembangan Anda, server Safari MCP membuat debugging Anda lebih cepat dan efisien.

Server Safari MCP memungkinkan agen Anda melakukan lebih banyak debugging dan pemecahan masalah sendiri. Berikut hanya beberapa contoh hal yang dapat dibantunya:

Pengembangan web di Safari. Lain kali Anda mengembangkan di Safari, Anda akan mendapatkan manfaat dari alur kerja yang lebih baik. Agen Anda sudah membantu Anda dengan kode Anda, kini ia dapat berbuat lebih banyak dengan memeriksa bagaimana kode Anda sebenarnya dirender di Safari.

Meningkatkan kompatibilitas dengan Safari. Menguji hanya di satu browser berarti melewatkan potensi bug di browser lain, sehingga pengguna tersebut mendapatkan pengalaman yang kurang memuaskan. Dengan server Safari MCP, agen Anda dapat membuka situs Anda di Safari, memeriksa computed styles, memeriksa tata letak, dan membandingkannya dengan apa yang Anda harapkan tanpa berpindah jendela.

Menganalisis performa. Lihat bagian mana dari situs Anda yang memperlambatnya. Server Safari MCP memungkinkan agen Anda mengevaluasi JavaScript di halaman untuk menampilkan metrik performa, seperti navigation timing dan waktu pemuatan sumber daya, sehingga agen dapat menentukan apa yang memperlambat situs Anda dan mengerjakan perbaikan yang tepat.

Memeriksa aksesibilitas. Server Safari MCP memungkinkan agen Anda memeriksa masalah aksesibilitas umum seperti label yang hilang, atribut ARIA yang tidak tepat, dan kontras yang buruk, sehingga Anda dapat menangkap masalah yang berdampak pada pengguna Anda.

Memverifikasi status pengguna apa pun. Ketahui bahwa halaman berfungsi dan tampil sebagaimana mestinya. Agen Anda dapat memeriksa status formulir, menanyakan elemen menggunakan selector, mengonfirmasi interaksi tertentu, menampilkan berbagai status alur checkout, dan banyak lagi. Habiskan lebih sedikit waktu untuk pemeriksaan manual ini dan berdayakan agen untuk melakukannya untuk Anda.

Ini hanyalah beberapa kasus penggunaan. Bagaimanapun Anda memutuskan untuk mengimplementasikannya, server Safari MCP membantu agen Anda berbuat lebih banyak untuk Anda dan mengurangi semua bolak-balik yang sering dibutuhkan dalam pengembangan web. Alur kerja yang lebih mudah berarti lebih banyak bug yang diberantas, pengguna yang lebih bahagia, dan produk yang lebih baik.

Alat-alat

Berikut adalah alat yang tersedia dan fungsinya:

AlatDeskripsi
browser_console_messagesMengembalikan log konsol yang di-buffer untuk tab saat ini atau yang ditentukan
browser_dialogsMenampilkan daftar dan merespons dialog browser (terima, tutup, atau masukkan teks untuk prompt JS)
close_tabMenutup tab browser berdasarkan handle-nya
create_tabMembuat tab browser baru, secara opsional memuat URL
evaluate_javascriptMenjalankan kode JavaScript di dalam halaman dan mengembalikan hasilnya
get_network_requestMendapatkan detail lengkap untuk satu permintaan jaringan yang tercatat (header, body, timing)
get_page_contentMengekstrak konten teks halaman dalam berbagai format (markdown, HTML, JSON, dll.)
list_network_requestsMenampilkan daftar ringkasan permintaan jaringan (URL, metode, status, timing) untuk tab saat ini
list_tabsMenampilkan daftar semua tab browser yang terbuka beserta handle dan URL-nya
navigate_to_urlMenavigasi ke URL dan mengembalikan konten halaman yang dimuat
page_infoMendapatkan info tentang halaman saat ini: URL, judul, dan status pemuatan
page_interactionsMelakukan interaksi DOM secara berurutan: klik, ketik, gulir, hover, keyPress, dll.
screenshotMengambil tangkapan layar halaman saat ini sebagai PNG
set_emulated_mediaMeniru tipe media CSS (misalnya "print") untuk pengujian desain responsif
set_viewport_sizeMengatur ukuran viewport browser dalam piksel CSS
switch_tabBeralih ke tab browser lain berdasarkan handle-nya
wait_for_navigationMenunggu halaman saat ini selesai dimuat; mengembalikan URL dan judul akhir

Dengan server Safari MCP, Anda tidak lagi harus menulis prompt yang sempurna, dengan hati-hati menjelaskan kepada agen Anda apa yang Anda alami di browser. Anda dapat memberi agen Anda kemampuan untuk mengetahuinya sendiri.

Cara memulai

Safari 27

Pertama, Anda perlu menginstal Safari 27. Setelah terinstal, pastikan untuk mengaktifkan fitur pengembang web dan otomasi jarak jauh. Untuk mengaktifkan fitur bagi pengembang web, pilih Safari > Settings > Advanced > centang kotak Show features for web developers. Lalu buka Safari > Settings > Developer > centang "Allow remote automation and external agents."

Jika Anda menggunakan Claude, Anda dapat menggunakan perintah berikut di terminal Anda:

claude mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp

Jika Anda menggunakan Codex, Anda dapat menggunakan perintah berikut di terminal Anda:

codex mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp

Untuk agen lain, Anda dapat menempatkan berikut ini di file mcp.json atau config.json Anda.

{
  "mcpServers": {
    "safari-mcp": {
      "command": "/usr/bin/safaridriver",
      "args": ["--mcp"]
    }
  }
}

Safari Technology Preview

Pertama, Anda perlu menginstal Safari Technology Preview. Setelah terinstal, pastikan Anda mengaktifkan Safari Settings > Advanced > Show features for web developers. Lalu buka Safari Settings > Developer > Enable remote automation and external agents.

Jika Anda menggunakan Claude, Anda dapat menggunakan perintah berikut di terminal Anda:

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

Jika Anda menggunakan Codex, Anda dapat menggunakan perintah berikut di terminal Anda:

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

Untuk agen lain, Anda dapat menempatkan berikut ini di mcp.json atau config.json:

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

Perhatikan bahwa meskipun kode di atas menamai server safari-mcp-stp, Anda dapat menamainya sesuka Anda, bahkan cukup safari. Setelah server Safari MCP terinstal, coba salah satu prompt berikut:

Find bugs on my site in Safari
How accessible is my site in Safari?
See how my website performs in Safari

Meskipun setiap agen bekerja sedikit berbeda, agen tidak perlu diberi tahu secara eksplisit untuk menggunakan server Safari MCP — agen akan mengetahuinya sendiri. Prompt sederhana seperti contoh di atas sudah cukup untuk memulai MCP.

Berikut gambaran bagaimana percakapan dengan agen yang menggunakan server Safari MCP:

Anda: Ada laporan bug — ada yang rusak di Safari pada halaman penerbangan. Bisakah kamu mencari tahu apa yang terjadi?

Agen: Tentu, biar saya periksa.

Agen: Saya menemukan dua bug berbeda di halaman penerbangan di Safari. Mau saya perbaiki keduanya?

Anda: Ya. Ada hal lain di sini yang mungkin menyebabkan masalah bagi pengguna Safari?

Agen: Ya, ada dua hal lagi yang perlu diperhatikan. Animasi reveal hasil secara diam-diam rusak dan log startup server API salah. Haruskah saya tangani keduanya juga?

Anda hanya perlu satu permintaan awal untuk memulai, dan dengan bantuan server Safari MCP, agen Anda dapat melanjutkannya dari sana.

Server Safari MCP berjalan sepenuhnya di mesin lokal Anda dan tidak melakukan panggilan jaringan sendiri. Server ini juga tidak memiliki akses ke informasi pribadi Anda di Safari (misalnya AutoFill atau aktivitas browser lainnya). Saat server menangkap konten halaman, tangkapan layar, atau log konsol, data tersebut langsung dikirim ke agen yang Anda jalankan — bukan ke Apple. Apa yang terjadi pada data tersebut setelahnya bergantung pada agen dan model yang Anda gunakan. Seperti halnya agen apa pun yang Anda beri akses ke browser Anda, hanya gunakan agen yang Anda percayai.

Mengapa kami membangun ini

Ada banyak cara untuk membangun untuk web, baik dengan maupun tanpa AI. Jika AI adalah bagian dari alur kerja Anda, kami pikir alat ini akan membantu membuatnya lebih produktif. Dan jika bukan, tidak apa-apa juga.

Dengan membuat sumber daya ini, kami berharap dapat mempermudah pengujian dan debugging di Safari dengan membantu agen Anda memahami bagaimana tampilan dan cara kerja di browser.

Jika Anda mencobanya atau jika ini pertama kalinya Anda menggunakan server MCP, beri tahu kami pendapat Anda. Laporkan masalah melalui Feedback Assistant.

Anda juga dapat menemukan kami secara online: Saron Yitbarek di Bluesky, Jen Simmons di Bluesky / Mastodon, dan Jon Davis di Bluesky / Mastodon.