Safari MCP
resmiSafari MCP sunucusu, aracınızı bir Safari tarayıcı penceresine bağlayarak kodunuzun tarayıcıda nasıl görüntülendiğini bilmesini sağlar.
Safari MCP ile neler yapabilirsiniz?
- Sayfa oluşturmayı inceleyin — Aracınızdan Safari'de bir site açmasını ve hesaplanan stilleri, düzeni ve sayfa içeriğini kontrol etmesini isteyin.
- Konsol ve ağ etkinliğinde hata ayıklayın — Tamponlanmış konsol günlüklerini alın ve ağ isteklerini başlıklar, gövde ve zamanlama ile listeleyin veya inceleyin.
- JavaScript çalıştırın ve ekran görüntüleri alın — Performans metriklerini ortaya çıkarmak için sayfada JavaScript değerlendirin veya bir PNG ekran görüntüsü alın.
- Etkileşimleri ve kullanıcı durumunu test edin — Formları ve ödeme akışlarını doğrulamak için tıklama, yazma, kaydırma, üzerine gelme ve keyPress dizileri gerçekleştirin.
- Erişilebilirliği kontrol edin — Aracınızdan eksik etiketleri, hatalı ARIA özniteliklerini ve zayıf kontrastı aramasını isteyin.
- Görüntü alanını ve medyayı öykünün — Duyarlı test için görüntü alanı boyutunu CSS piksel cinsinden ayarlayın veya print gibi bir medya türünü öykünün.
Dokümantasyon
Güncelleme: Safari 27 ve Safari Technology Preview 247 sürümlerinde, web geliştiricileri için bir Model Context Protocol sunucusu olan Safari MCP sunucusunu tanıtıyoruz. Bu sunucu, web geliştirme ve hata ayıklama iş akışınızı daha hızlı ve daha güçlü hale getirir. Ajanların kodlama sürecinde giderek daha önemli bir rol oynadığını biliyoruz ve Safari MCP sunucusu, ajanınızı bir Safari tarayıcı penceresine bağlayarak kodunuzun tarayıcıda gerçekte nasıl işlendiğini bilmesini sağlar.
MCP uyumlu herhangi bir istemci Safari MCP sunucusuna bağlanabilir. Ajanınızı bir Safari tarayıcı penceresine bağlayarak, kullanıcılarınızın deneyimlediklerini taklit etmesini sağlayabilir ve ona DOM'a, ağ isteklerine, ekran görüntülerine ve konsol çıktısına erişim gibi daha otonom hata ayıklaması için ihtiyaç duyduğu bilgileri verebilirsiniz.
Bu, hata ayıklama sürecinizi hızlandırır ve terminalinizin rahatlığında kalmanızı sağlar; yani kodunuzda hata ayıklamak için daha az pencere değiştirme ve istem yazma turu demektir.
Kullanım senaryoları
Web için geliştirme yapıyorsanız, hata ayıklama dansını bilirsiniz. Genellikle şöyle gider:
Tarayıcıda sitenizde bir sorun görürsünüz. Sorunu bulmak için konsolu açarsınız. Stiller sekmesine tıklarsınız. Neyin bozuk olduğunu görürsünüz. Düzeltmek için kodunuza geri dönersiniz. Ya da belki bir ekran görüntüsü alır, sorunu ajanınıza detaylandırır ve düzeltmeyi onun yapmasına izin verirsiniz. Umarım doğru yapar, hata düzeltilir ve devam edebilirsiniz.
Ancak düzeltilmediğinde, iş akışını yeniden yaşarsınız — Tarayıcı. İstem. Ajan.
Ve sonunda hatayı ezene kadar tekrar tekrar.
Kullandığınız tarayıcı veya araçlar ne olursa olsun, hata ayıklama iş akışı tek bir düzeltme için birçok tıklama, araç ve pencere değiştirme gerektirir, ancak böyle olmak zorunda değil. Geliştirme iş akışınızda zaten ajanlar kullanıyorsanız, Safari MCP sunucusu hata ayıklamanızı daha hızlı ve daha verimli hale getirir.
Safari MCP sunucusu, ajanınızın kendi başına daha fazla hata ayıklama ve sorun giderme yapmasını sağlar. İşte yardımcı olabileceği birkaç örnek:
Safari'de web geliştirme. Bir dahaki sefere Safari'de geliştirme yaptığınızda, yükseltilmiş bir iş akışından yararlanacaksınız. Ajanınız zaten kodunuzda size yardımcı oluyor; artık kodunuzun Safari'de gerçekte nasıl işlendiğini kontrol ederek daha da fazlasını yapabilir.
Safari ile uyumluluğu iyileştirin. Yalnızca tek bir tarayıcıda test etmek, başka bir tarayıcıdaki olası hataları kaçırmak anlamına gelir ve bu kullanıcılara yetersiz bir deneyim sunar. Safari MCP sunucusu ile ajanınız sitenizi Safari'de açabilir, hesaplanan stilleri inceleyebilir, düzeni kontrol edebilir ve pencereler arasında geçiş yapmadan beklediğinizle karşılaştırabilir.
Performansı analiz edin. Sitenizin hangi bölümlerinin yavaşlattığını görün. Safari MCP sunucusu, ajanınızın sayfada JavaScript çalıştırarak gezinme zamanlaması ve kaynak yükleme süreleri gibi performans metriklerini ortaya çıkarmasını sağlar; böylece sitenizi neyin yavaşlattığını belirleyip doğru düzeltme üzerinde çalışabilir.
Erişilebilirliği kontrol edin. Safari MCP sunucusu, ajanınızın eksik etiketler, hatalı ARIA öznitelikleri ve zayıf kontrast gibi yaygın erişilebilirlik sorunlarını kontrol etmesini sağlar; böylece kullanıcılarınızı etkileyen sorunları yakalayabilirsiniz.
Herhangi bir kullanıcı durumunu doğrulayın. Sayfanın çalıştığını ve olması gerektiği gibi göründüğünü bilin. Ajanınız formun durumunu kontrol edebilir, bir seçici kullanarak bir öğeyi sorgulayabilir, belirli etkileşimleri doğrulayabilir, bir ödeme akışının farklı durumlarını gösterebilir ve daha fazlasını yapabilir. Bu manuel kontrollere daha az zaman harcayın ve ajanın bunu sizin için yapmasını sağlayın.
Bunlar yalnızca birkaç kullanım senaryosu. Nasıl uygulamaya karar verirseniz verin, Safari MCP sunucusu ajanınızın sizin için daha fazlasını yapmasına yardımcı olur ve web geliştirmenin sıklıkla gerektirdiği tüm gidiş gelişleri azaltır. Daha kolay bir iş akışı, daha fazla düzeltilmiş hata, daha mutlu kullanıcılar ve daha iyi bir ürün demektir.
Araçlar
İşte mevcut araçlar ve ne yaptıkları:
| Araç | Açıklama |
|---|---|
| browser_console_messages | Geçerli veya belirtilen sekme için arabelleğe alınmış konsol günlüklerini döndürür |
| browser_dialogs | Tarayıcı iletişim kutularını listeler ve yanıtlar (JS istemleri için kabul et, kapat veya metin gir) |
| close_tab | Bir tarayıcı sekmesini tanıtıcısıyla kapatır |
| create_tab | İsteğe bağlı olarak bir URL yükleyerek yeni bir tarayıcı sekmesi oluşturur |
| evaluate_javascript | Sayfa içinde JavaScript kodu çalıştırır ve sonucu döndürür |
| get_network_request | Tek bir kaydedilmiş ağ isteği için tam ayrıntıyı alır (başlıklar, gövde, zamanlama) |
| get_page_content | Bir sayfanın metin içeriğini çeşitli biçimlerde çıkarır (markdown, HTML, JSON vb.) |
| list_network_requests | Geçerli sekme için ağ isteği özetlerini listeler (URL, yöntem, durum, zamanlama) |
| list_tabs | Tüm açık tarayıcı sekmelerini tanıtıcıları ve URL'leriyle listeler |
| navigate_to_url | Bir URL'ye gider ve yüklenen sayfanın içeriğini döndürür |
| page_info | Geçerli sayfa hakkında bilgi alır: URL, başlık ve yükleme durumu |
| page_interactions | DOM etkileşimlerini sırayla gerçekleştirir: tıklama, yazma, kaydırma, üzerine gelme, tuşa basma vb. |
| screenshot | Geçerli sayfanın PNG olarak ekran görüntüsünü alır |
| set_emulated_media | Duyarlı tasarım testi için bir CSS medya türünü (ör. "print") taklit eder |
| set_viewport_size | Tarayıcı görünüm alanı boyutunu CSS piksel cinsinden ayarlar |
| switch_tab | Tanıtıcısıyla farklı bir tarayıcı sekmesine geçer |
| wait_for_navigation | Geçerli sayfanın yüklenmesinin bitmesini bekler; son URL ve başlığı döndürür |
Safari MCP sunucusu ile artık ajanınıza tarayıcıda neler deneyimlediğinizi dikkatlice açıklayan mükemmel istemi yazmak zorunda değilsiniz. Ajanınıza kendi başına keşfetme yeteneği verebilirsiniz.
Nasıl başlanır
Safari 27
Öncelikle Safari 27 sürümünü yüklemeniz gerekir. Yüklendikten sonra web geliştirici özelliklerini ve uzaktan otomasyonu etkinleştirdiğinizden emin olun. Web geliştiricileri için özellikleri etkinleştirmek üzere Safari > Ayarlar > Gelişmiş > "Web geliştiricileri için özellikleri göster" onay kutusunu işaretleyin. Ardından Safari > Ayarlar > Geliştirici > "Uzaktan otomasyona ve harici ajanlara izin ver" seçeneğini işaretleyin.
Claude kullanıyorsanız, terminalinizde aşağıdaki komutu kullanabilirsiniz:
claude mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp
Codex kullanıyorsanız, terminalinizde aşağıdaki komutu kullanabilirsiniz:
codex mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp
Diğer ajanlar için, aşağıdakini mcp.json veya config.json dosyanıza koyabilirsiniz.
{
"mcpServers": {
"safari-mcp": {
"command": "/usr/bin/safaridriver",
"args": ["--mcp"]
}
}
}
Safari Technology Preview
Öncelikle Safari Technology Preview sürümünü yüklemeniz gerekir. Yüklendikten sonra Safari Ayarlar > Gelişmiş > "Web geliştiricileri için özellikleri göster" seçeneğini etkinleştirdiğinizden emin olun. Ardından Safari Ayarlar > Geliştirici > "Uzaktan otomasyonu ve harici ajanları etkinleştir" seçeneğine gidin.
Claude kullanıyorsanız, terminalinizde aşağıdaki komutu kullanabilirsiniz:
claude mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp
Codex kullanıyorsanız, terminalinizde aşağıdaki komutu kullanabilirsiniz:
codex mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp
Diğer ajanlar için, aşağıdakini mcp.json veya config.json dosyanıza koyabilirsiniz:
"safari-mcp-stp": {
"command": "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver",
"args": ["--mcp"]
}
Yukarıdaki kod sunucuyu safari-mcp-stp olarak adlandırsa da, ona istediğiniz adı verebileceğinizi, hatta sadece safari diyebileceğinizi unutmayın. Safari MCP sunucusunu yükledikten sonra, aşağıdaki istemlerden birini deneyin:
Find bugs on my site in Safari
How accessible is my site in Safari?
See how my website performs in Safari
Her ajan biraz farklı çalışsa da, Safari MCP sunucusunu açıkça kullanmasının söylenmesine gerek kalmamalıdır — kendi başına anlayacaktır. Yukarıdakiler gibi basit istemler MCP'yi başlatmak için yeterlidir.
İşte Safari MCP sunucusunu kullanan bir ajanla bir konuşmanın nasıl geçebileceğine dair bir örnek:
Siz: Bir hata raporu aldım — uçuş sayfasında Safari'de bir şeyler bozuk. Neler olduğunu anlayabilir misin?
Ajan: Tabii, bir bakayım.
Ajan: Safari'de uçuş sayfasında iki ayrı hata buldum. İkisini de düzeltmemi ister misin?
Siz: Evet. Burada Safari kullanıcıları için sorun yaratabilecek başka bir şey var mı?
Ajan: Evet, dikkat çekmeye değer iki şey daha var. Sonuçların ortaya çıkma animasyonu sessizce bozuk ve API sunucusu başlangıç günlüğü yanlış. İkisini de ele alayım mı?
Başlamak için tek ihtiyacınız olan ilk istek ve Safari MCP sunucusunun yardımıyla ajanınız gerisini halledebilir.
Safari MCP sunucusu tamamen yerel makinenizde çalışır ve kendi başına hiçbir ağ çağrısı yapmaz. Ayrıca Safari'deki kişisel bilgilerinize (ör. AutoFill veya diğer tarayıcı etkinliği) erişimi yoktur. Sayfa içeriğini, ekran görüntülerini veya konsol günlüklerini yakaladığında, bu veriler doğrudan çalıştırdığınız ajana gider — Apple'a değil. Bu verilerin oradan sonra ne olacağı, kullandığınız ajana ve modele bağlıdır. Tarayıcınıza erişim verdiğiniz herhangi bir ajanda olduğu gibi, yalnızca güvendiğiniz ajanları kullanın.
Bunu neden geliştirdik
Web için geliştirme yapmanın, hem yapay zekâ ile hem de yapay zekâ olmadan birçok yolu vardır. Yapay zekâ iş akışınızın bir parçasıysa, bu aracın onu daha da verimli hale getirmeye yardımcı olacağını düşünüyoruz. Değilse, bu da sorun değil.
Bu kaynağı oluşturarak, ajanınızın tarayıcıda işlerin nasıl göründüğünü ve çalıştığını anlamasına yardımcı olarak Safari'de test etmeyi ve hata ayıklamayı her zamankinden daha kolay hale getirmeyi umuyoruz.
Denemek isterseniz veya bir MCP sunucusunu ilk kez kullanıyorsanız, ne düşündüğünüzü bize bildirin. Sorunları Feedback Assistant aracılığıyla bildirin.
Ayrıca bizi çevrimiçi bulabilirsiniz: Saron Yitbarek Bluesky'da, Jen Simmons Bluesky / Mastodon'da ve Jon Davis Bluesky / Mastodon'da.