Safari MCP

offiziell

Der Safari MCP Server ermöglicht es Ihrem Agenten, zu sehen, wie Ihr Code tatsächlich im Browser dargestellt wird, indem er ihn mit einem Safari-Browserfenster verbindet.

Was kann man mit Safari MCP machen?

  • Seitenrendering prüfen — Bitten Sie Ihren Agenten, eine Website in Safari zu öffnen und berechnete Styles, Layout und Seiteninhalt zu überprüfen.
  • Konsole und Netzwerkaktivität debuggen — Rufen Sie gepufferte Konsolenprotokolle ab und listen Sie Netzwerkanfragen auf oder untersuchen Sie sie mit Headern, Body und Timing.
  • JavaScript ausführen und Screenshots aufnehmen — Werten Sie JavaScript in der Seite aus, um Performance-Metriken zu ermitteln, oder nehmen Sie einen PNG-Screenshot auf.
  • Interaktionen und Benutzerstatus testen — Führen Sie Sequenzen aus Klicken, Tippen, Scrollen, Hover und keyPress aus, um Formulare und Checkout-Abläufe zu verifizieren.
  • Barrierefreiheit prüfen — Lassen Sie Ihren Agenten nach fehlenden Labels, unsachgemäßen ARIA-Attributen und schlechtem Kontrast suchen.
  • Viewport und Medien emulieren — Legen Sie die Viewport-Größe in CSS-Pixeln fest oder emulieren Sie einen Medientyp wie print für Responsive-Tests.

Dokumentation

Update: In Safari 27 und Safari Technology Preview 247 führen wir den Safari MCP-Server ein – einen Model Context Protocol-Server für Webentwickler, der deinen Webentwicklungs- und Debugging-Workflow schneller und leistungsfähiger macht. Wir wissen, dass Agenten zunehmend integraler Bestandteil des Programmierprozesses sind, und der Safari MCP-Server gibt deinem Agenten die Möglichkeit zu wissen, wie dein Code tatsächlich im Browser gerendert wird, indem er ihn mit einem Safari-Browserfenster verbindet.

Jeder MCP-kompatible Client kann sich mit dem Safari MCP-Server verbinden. Indem du deinen Agenten mit einem Safari-Browserfenster verbindest, kann dein Agent nachvollziehen, was deine Nutzer erleben, und erhält die Informationen, die er für autonomeres Debugging benötigt, wie etwa Zugriff auf das DOM, Netzwerkanfragen, Screenshots und Konsolenausgaben.

Das beschleunigt deinen Debugging-Prozess und lässt dich im Komfort deines Terminals bleiben, was weniger Runden des Fensterwechselns und Tippens von Prompts zum Debuggen deines Codes bedeutet.

Die Anwendungsfälle

Wenn du für das Web entwickelst, kennst du den Debugging-Tanz. Er läuft meist ungefähr so ab:

Du siehst im Browser, dass mit deiner Website etwas nicht stimmt. Du öffnest die Konsole, um es aufzuspüren. Du klickst dich in den Styles-Tab. Du siehst, was kaputt ist. Du gehst zurück zu deinem Code, um es zu beheben. Oder vielleicht machst du einen Screenshot, beschreibst deinem Agenten das Problem und lässt ihn die Behebung übernehmen. Hoffentlich macht er es richtig, der Bug ist behoben, und du kannst weitermachen.

Aber wenn er nicht behoben ist, gehst du den Workflow erneut durch – Browser. Prompt. Agent.

Und wieder und wieder, bis du den Bug endlich erledigt hast.

Unabhängig vom Browser oder den Tools, die du verwendest, besteht der Debugging-Workflow aus vielen Klicks, Tools und Fensterwechseln für eine einzige Korrektur – aber das muss nicht so sein. Wenn du bereits Agenten in deinem Entwicklungsworkflow einsetzt, macht der Safari MCP-Server dein Debugging schneller und effizienter.

Der Safari MCP-Server ermöglicht es deinem Agenten, mehr Debugging und Fehlerbehebung selbstständig zu erledigen. Hier sind nur einige Beispiele, wobei er helfen kann:

Webentwicklung in Safari. Wenn du das nächste Mal in Safari entwickelst, profitierst du von einem verbesserten Workflow. Dein Agent hilft dir bereits bei deinem Code, jetzt kann er noch mehr tun, indem er prüft, wie dein Code tatsächlich in Safari gerendert wird.

Verbessere die Kompatibilität mit Safari. Wenn du nur in einem Browser testest, übersiehst du potenzielle Bugs in einem anderen und bietest diesen Nutzern eine minderwertige Erfahrung. Mit dem Safari MCP-Server kann dein Agent deine Website in Safari öffnen, berechnete Styles inspizieren, das Layout prüfen und es mit deinen Erwartungen vergleichen, ohne das Fenster zu wechseln.

Analysiere die Performance. Sieh, welche Teile deiner Website alles verlangsamen. Der Safari MCP-Server ermöglicht es deinem Agenten, JavaScript auf der Seite auszuwerten, um Performance-Metriken wie Navigation Timing und Ressourcen-Ladezeiten aufzudecken, damit er genau bestimmen kann, was deine Website verlangsamt, und an der richtigen Lösung arbeiten kann.

Prüfe die Barrierefreiheit. Der Safari MCP-Server ermöglicht es deinem Agenten, nach häufigen Barrierefreiheitsproblemen wie fehlenden Labels, unsachgemäßen ARIA-Attributen und schlechtem Kontrast zu suchen, damit du Probleme erkennen kannst, die deine Nutzer betreffen.

Verifiziere jeden Nutzerzustand. Stelle sicher, dass die Seite funktioniert und wie erwartet aussieht. Dein Agent kann den Zustand des Formulars prüfen, ein Element über einen Selektor abfragen, bestimmte Interaktionen bestätigen, verschiedene Zustände eines Checkout-Flows anzeigen und mehr. Verbringe weniger Zeit mit diesen manuellen Prüfungen und befähige den Agenten, sie für dich zu erledigen.

Dies sind nur einige der Anwendungsfälle. Wie auch immer du es implementierst, der Safari MCP-Server hilft deinem Agenten, mehr für dich zu tun, und reduziert das ständige Hin und Her, das die Webentwicklung oft erfordert. Ein einfacherer Workflow bedeutet mehr behobene Bugs, zufriedenere Nutzer und ein besseres Produkt.

Die Tools

Hier sind die verfügbaren Tools und was sie tun:

ToolBeschreibung
browser_console_messagesGibt gepufferte Konsolen-Logs für den aktuellen oder angegebenen Tab zurück
browser_dialogsListet Browser-Dialoge auf und antwortet auf sie (akzeptieren, verwerfen oder Text für JS-Prompts eingeben)
close_tabSchließt einen Browser-Tab über sein Handle
create_tabErstellt einen neuen Browser-Tab, optional mit Laden einer URL
evaluate_javascriptFührt JavaScript-Code innerhalb der Seite aus und gibt das Ergebnis zurück
get_network_requestRuft vollständige Details für eine einzelne aufgezeichnete Netzwerkanfrage ab (Header, Body, Timing)
get_page_contentExtrahiert den Textinhalt einer Seite in verschiedenen Formaten (Markdown, HTML, JSON usw.)
list_network_requestsListet Netzwerkanfrage-Zusammenfassungen (URL, Methode, Status, Timing) für den aktuellen Tab auf
list_tabsListet alle geöffneten Browser-Tabs mit ihren Handles und URLs auf
navigate_to_urlNavigiert zu einer URL und gibt den Inhalt der geladenen Seite zurück
page_infoRuft Informationen über die aktuelle Seite ab: URL, Titel und Ladezustand
page_interactionsFührt DOM-Interaktionen nacheinander aus: Klicken, Tippen, Scrollen, Hover, Tastendruck usw.
screenshotErstellt einen Screenshot der aktuellen Seite als PNG
set_emulated_mediaEmuliert einen CSS-Medientyp (z. B. „print“) für Responsive-Design-Tests
set_viewport_sizeLegt die Größe des Browser-Viewports in CSS-Pixeln fest
switch_tabWechselt zu einem anderen Browser-Tab über sein Handle
wait_for_navigationWartet, bis die aktuelle Seite fertig geladen ist; gibt die endgültige URL und den Titel zurück

Mit dem Safari MCP-Server musst du nicht mehr den perfekten Prompt schreiben und deinem Agenten sorgfältig beschreiben, was du im Browser erlebst. Du kannst deinem Agenten die Fähigkeit geben, es selbst herauszufinden.

Erste Schritte

Safari 27

Zuerst musst du Safari 27 installieren. Nach der Installation stelle sicher, dass du Webentwickler-Funktionen und Remote-Automatisierung aktivierst. Um Funktionen für Webentwickler zu aktivieren, wähle Safari > Einstellungen > Erweitert > und setze das Häkchen bei „Funktionen für Webentwickler anzeigen“. Gehe dann zu Safari > Einstellungen > Entwickler > und setze das Häkchen bei „Remote-Automatisierung und externe Agenten erlauben“.

Wenn du Claude verwendest, kannst du den folgenden Befehl in deinem Terminal verwenden:

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

Wenn du Codex verwendest, kannst du den folgenden Befehl in deinem Terminal verwenden:

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

Für andere Agenten kannst du Folgendes in deine mcp.json- oder config.json-Datei einfügen.

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

Safari Technology Preview

Zuerst musst du Safari Technology Preview installieren. Nach der Installation stelle sicher, dass du Safari-Einstellungen > Erweitert > Funktionen für Webentwickler anzeigen aktivierst. Gehe dann zu Safari-Einstellungen > Entwickler > Remote-Automatisierung und externe Agenten aktivieren.

Wenn du Claude verwendest, kannst du den folgenden Befehl in deinem Terminal verwenden:

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

Wenn du Codex verwendest, kannst du den folgenden Befehl in deinem Terminal verwenden:

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

Für andere Agenten kannst du Folgendes in deine mcp.json oder config.json einfügen:

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

Beachte, dass der obige Code den Server safari-mcp-stp nennt, du kannst ihn aber benennen, wie du möchtest, sogar einfach safari. Sobald du den Safari MCP-Server installiert hast, probiere einen der folgenden Prompts aus:

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

Obwohl jeder Agent etwas anders funktioniert, sollte es nicht nötig sein, ihm explizit zu sagen, dass er den Safari MCP-Server verwenden soll – er wird es von selbst herausfinden. Einfache Prompts wie die oben genannten reichen aus, um das MCP anzustoßen.

So könnte ein Gespräch mit einem Agenten ablaufen, der den Safari MCP-Server verwendet:

Du: Ich habe einen Bug-Report bekommen – etwas ist in Safari auf der Flugseite kaputt. Kannst du herausfinden, was los ist?

Agent: Klar, lass mich einen Blick darauf werfen.

Agent: Ich habe zwei verschiedene Bugs auf der Flugseite in Safari gefunden. Soll ich beide beheben?

Du: Ja. Gibt es sonst noch etwas, das Probleme für Safari-Nutzer verursachen könnte?

Agent: Ja, zwei weitere Dinge, die es wert sind, erwähnt zu werden. Die Animation, die die Ergebnisse aufdeckt, ist stillschweigend kaputt, und das Startprotokoll des API-Servers ist falsch. Soll ich mich auch um beides kümmern?

Du brauchst nur eine erste Anfrage, um loszulegen, und mit Hilfe des Safari MCP-Servers kann dein Agent von dort aus übernehmen.

Der Safari MCP-Server läuft vollständig auf deinem lokalen Rechner und führt keine eigenen Netzwerkaufrufe durch. Er hat auch keinen Zugriff auf deine persönlichen Informationen in Safari (z. B. AutoFill oder andere Browser-Aktivitäten). Wenn er Seiteninhalte, Screenshots oder Konsolen-Logs erfasst, gehen diese Daten direkt an den Agenten, den du ausführst – nicht an Apple. Was danach mit diesen Daten geschieht, hängt vom Agenten und dem Modell ab, die du verwendest. Wie bei jedem Agenten, dem du Zugriff auf deinen Browser gibst, verwende nur solche, denen du vertraust.

Warum wir das gebaut haben

Es gibt viele Wege, für das Web zu entwickeln, sowohl mit als auch ohne KI. Wenn KI Teil deines Workflows ist, glauben wir, dass dieses Tool ihn noch produktiver machen wird. Und wenn nicht, ist das auch in Ordnung.

Indem wir diese Ressource schaffen, hoffen wir, das Testen und Debuggen in Safari einfacher denn je zu machen, indem wir deinem Agenten helfen zu verstehen, wie die Dinge im Browser aussehen und funktionieren.

Wenn du es ausprobierst oder wenn dies dein erstes Mal mit einem MCP-Server ist, lass uns wissen, was du denkst. Reiche Probleme über den Feedback Assistant ein.

Außerdem findest du uns online: Saron Yitbarek auf Bluesky, Jen Simmons auf Bluesky / Mastodon und Jon Davis auf Bluesky / Mastodon.