Safari MCP
officielLe serveur Safari MCP permet à votre agent de savoir comment votre code s'affiche réellement dans le navigateur en le connectant à une fenêtre du navigateur Safari.
Que pouvez-vous faire avec Safari MCP ?
- Inspecter le rendu de la page — Demandez à votre agent d'ouvrir un site dans Safari et de vérifier les styles calculés, la mise en page et le contenu de la page.
- Déboguer la console et l'activité réseau — Récupérez les journaux de console mis en mémoire tampon et listez ou inspectez les requêtes réseau avec les en-têtes, le corps et les temps de réponse.
- Exécuter du JavaScript et capturer des captures d'écran — Évaluez du JavaScript dans la page pour faire apparaître des métriques de performance, ou capturez une capture d'écran PNG.
- Tester les interactions et l'état utilisateur — Effectuez des séquences de click, type, scroll, hover et keyPress pour vérifier les formulaires et les parcours de paiement.
- Vérifier l'accessibilité — Demandez à votre agent de rechercher les libellés manquants, les attributs ARIA inappropriés et les contrastes insuffisants.
- Émuler la fenêtre d'affichage et les médias — Définissez la taille de la fenêtre d'affichage en pixels CSS ou émulez un type de média comme print pour les tests responsives.
Documentation
Mise à jour : Dans Safari 27 et Safari Technology Preview 247, nous introduisons le serveur MCP Safari — un serveur Model Context Protocol pour les développeurs web qui rend votre flux de travail de développement et de débogage web plus rapide et plus puissant. Nous savons que les agents font de plus en plus partie intégrante du processus de codage, et le serveur MCP Safari permet à votre agent de savoir comment votre code s'affiche réellement dans le navigateur en le connectant à une fenêtre de navigateur Safari.
Tout client compatible MCP peut se connecter au serveur MCP Safari. En connectant votre agent à une fenêtre de navigateur Safari, votre agent peut reproduire ce que vos utilisateurs vivent, ce qui lui donne les informations dont il a besoin pour déboguer de manière plus autonome, comme l'accès au DOM, aux requêtes réseau, aux captures d'écran et à la sortie de la console.
Cela accélère votre processus de débogage et vous permet de rester dans le confort de votre terminal, ce qui signifie moins d'allers-retours entre les fenêtres et moins de saisie d'invites pour déboguer votre code.
Les cas d'utilisation
Si vous développez pour le web, vous connaissez la danse du débogage. Elle se déroule généralement ainsi :
Vous constatez un problème sur votre site dans le navigateur. Vous ouvrez la console pour le traquer. Vous cliquez dans l'onglet des styles. Vous voyez ce qui est cassé. Vous retournez à votre code pour le corriger. Ou peut-être prenez-vous une capture d'écran, détaillez le problème à votre agent et le laissez faire la correction à votre place. Avec un peu de chance, il s'en sort, le bug est corrigé et vous pouvez passer à autre chose.
Mais quand ce n'est pas corrigé, vous repassez par le même flux de travail — Navigateur. Invite. Agent.
Encore et encore, jusqu'à ce que vous éliminiez enfin le bug.
Quel que soit le navigateur ou les outils que vous utilisez, le flux de travail de débogage implique beaucoup de clics, d'outils et d'allers-retours entre fenêtres pour une seule correction, mais cela ne doit pas forcément être ainsi. Si vous utilisez déjà des agents dans votre flux de travail de développement, le serveur MCP Safari rend votre débogage plus rapide et plus efficace.
Le serveur MCP Safari permet à votre agent d'effectuer davantage de débogage et de dépannage par lui-même. Voici quelques exemples de ce à quoi il peut vous aider :
Développement web dans Safari. La prochaine fois que vous développerez dans Safari, vous bénéficierez d'un flux de travail amélioré. Votre agent vous aide déjà avec votre code ; il peut désormais faire encore plus en vérifiant comment votre code s'affiche réellement dans Safari.
Améliorer la compatibilité avec Safari. Tester dans un seul navigateur signifie manquer des bugs potentiels dans un autre, offrant à ces utilisateurs une expérience médiocre. Avec le serveur MCP Safari, votre agent peut ouvrir votre site dans Safari, inspecter les styles calculés, vérifier la mise en page et la comparer à ce que vous attendez, sans changer de fenêtre.
Analyser les performances. Voyez quelles parties de votre site le ralentissent. Le serveur MCP Safari permet à votre agent d'évaluer le JavaScript de la page pour faire ressortir des métriques de performance, comme les timings de navigation et les temps de chargement des ressources, afin qu'il puisse identifier ce qui ralentit votre site et travailler sur la bonne correction.
Vérifier l'accessibilité. Le serveur MCP Safari permet à votre agent de vérifier les problèmes d'accessibilité courants comme les libellés manquants, les attributs ARIA incorrects et les contrastes insuffisants, afin que vous puissiez détecter les problèmes qui impactent vos utilisateurs.
Vérifier n'importe quel état utilisateur. Assurez-vous que la page fonctionne et s'affiche comme elle le devrait. Votre agent peut vérifier l'état du formulaire, interroger un élément à l'aide d'un sélecteur, confirmer des interactions spécifiques, montrer différents états d'un parcours de paiement, et plus encore. Passez moins de temps sur ces vérifications manuelles et permettez à l'agent de les faire pour vous.
Ce ne sont là que quelques cas d'utilisation. Quelle que soit la façon dont vous décidez de l'implémenter, le serveur MCP Safari aide votre agent à en faire plus pour vous et à réduire tous les allers-retours que le développement web exige souvent. Un flux de travail plus simple signifie plus de bugs éliminés, des utilisateurs plus satisfaits et un meilleur produit.
Les outils
Voici les outils disponibles et ce qu'ils font :
| Outil | Description |
|---|---|
| browser_console_messages | Renvoie les journaux de console mis en mémoire tampon pour l'onglet actuel ou spécifié |
| browser_dialogs | Liste et répond aux boîtes de dialogue du navigateur (accepter, ignorer ou saisir du texte pour les invites JS) |
| close_tab | Ferme un onglet du navigateur par son identifiant |
| create_tab | Crée un nouvel onglet de navigateur, en chargeant éventuellement une URL |
| evaluate_javascript | Exécute du code JavaScript dans la page et renvoie le résultat |
| get_network_request | Obtient les détails complets d'une seule requête réseau enregistrée (en-têtes, corps, timing) |
| get_page_content | Extrait le contenu textuel d'une page dans divers formats (markdown, HTML, JSON, etc.) |
| list_network_requests | Liste les résumés des requêtes réseau (URL, méthode, statut, timing) pour l'onglet actuel |
| list_tabs | Liste tous les onglets de navigateur ouverts avec leurs identifiants et URL |
| navigate_to_url | Navigue vers une URL et renvoie le contenu de la page chargée |
| page_info | Obtient des informations sur la page actuelle : URL, titre et état de chargement |
| page_interactions | Effectue des interactions DOM en séquence : clic, saisie, défilement, survol, appui de touche, etc. |
| screenshot | Capture une capture d'écran de la page actuelle au format PNG |
| set_emulated_media | Émule un type de média CSS (par ex. « print ») pour tester le design responsive |
| set_viewport_size | Définit la taille de la fenêtre d'affichage du navigateur en pixels CSS |
| switch_tab | Bascule vers un autre onglet du navigateur par son identifiant |
| wait_for_navigation | Attend que la page actuelle termine son chargement ; renvoie l'URL finale et le titre |
Avec le serveur MCP Safari, vous n'avez plus besoin d'écrire l'invite parfaite, en décrivant soigneusement à votre agent ce que vous vivez dans le navigateur. Vous pouvez donner à votre agent la capacité de le découvrir par lui-même.
Comment démarrer
Safari 27
Tout d'abord, vous devrez installer Safari 27. Une fois installé, assurez-vous d'activer les fonctionnalités pour développeurs web et l'automatisation à distance. Pour activer les fonctionnalités pour développeurs web, choisissez Safari > Réglages > Avancés > cochez la case Afficher les fonctionnalités pour développeurs web. Ensuite, allez dans Safari > Réglages > Développeur > cochez « Autoriser l'automatisation à distance et les agents externes ».
Si vous utilisez Claude, vous pouvez utiliser la commande suivante dans votre terminal :
claude mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp
Si vous utilisez Codex, vous pouvez utiliser la commande suivante dans votre terminal :
codex mcp add safari-mcp -- "/usr/bin/safaridriver" --mcp
Pour d'autres agents, vous pouvez placer ce qui suit dans votre fichier mcp.json ou config.json.
{
"mcpServers": {
"safari-mcp": {
"command": "/usr/bin/safaridriver",
"args": ["--mcp"]
}
}
}
Safari Technology Preview
Tout d'abord, vous devrez installer Safari Technology Preview. Une fois installé, assurez-vous d'activer Réglages Safari > Avancés > Afficher les fonctionnalités pour développeurs web. Ensuite, allez dans Réglages Safari > Développeur > Activer l'automatisation à distance et les agents externes.
Si vous utilisez Claude, vous pouvez utiliser la commande suivante dans votre terminal :
claude mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp
Si vous utilisez Codex, vous pouvez utiliser la commande suivante dans votre terminal :
codex mcp add safari-mcp-stp -- "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver" --mcp
Pour d'autres agents, vous pouvez placer ce qui suit dans votre mcp.json ou config.json :
"safari-mcp-stp": {
"command": "/Applications/Safari Technology Preview.app/Contents/MacOS/safaridriver",
"args": ["--mcp"]
}
Notez que bien que le code ci-dessus nomme le serveur safari-mcp-stp, vous pouvez le nommer comme vous le souhaitez, même simplement safari. Une fois le serveur MCP Safari installé, essayez l'une des invites suivantes :
Find bugs on my site in Safari
How accessible is my site in Safari?
See how my website performs in Safari
Bien que chaque agent fonctionne un peu différemment, il ne devrait pas être nécessaire de lui dire explicitement d'utiliser le serveur MCP Safari — il le comprendra de lui-même. Des invites simples comme celles ci-dessus suffisent à lancer le MCP.
Voici comment pourrait se dérouler une conversation avec un agent utilisant le serveur MCP Safari :
Vous : J'ai reçu un rapport de bug — quelque chose est cassé dans Safari sur la page de vol. Peux-tu déterminer ce qui se passe ?
Agent : Bien sûr, laisse-moi jeter un œil.
Agent : J'ai trouvé deux bugs distincts sur la page de vol dans Safari. Veux-tu que je corrige les deux ?
Vous : Oui. Y a-t-il autre chose ici qui pourrait causer des problèmes aux utilisateurs de Safari ?
Agent : Oui, deux autres choses méritent d'être signalées. L'animation de révélation des résultats est silencieusement cassée et le journal de démarrage du serveur API est erroné. Dois-je m'occuper des deux également ?
Il vous suffit d'une demande initiale pour commencer, et avec l'aide du serveur MCP Safari, votre agent peut prendre le relais.
Le serveur MCP Safari s'exécute entièrement sur votre machine locale et n'effectue aucun appel réseau de son propre chef. Il n'a pas non plus accès à vos informations personnelles dans Safari (par ex. le remplissage automatique ou d'autres activités du navigateur). Lorsqu'il capture le contenu d'une page, des captures d'écran ou des journaux de console, ces données vont directement à l'agent que vous exécutez — pas à Apple. Ce qu'il advient de ces données ensuite dépend de l'agent et du modèle que vous utilisez. Comme pour tout agent auquel vous donnez accès à votre navigateur, n'utilisez que ceux en lesquels vous avez confiance.
Pourquoi nous avons créé cela
Il existe de nombreuses façons de développer pour le web, avec et sans IA. Si l'IA fait partie de votre flux de travail, nous pensons que cet outil contribuera à le rendre encore plus productif. Et si ce n'est pas le cas, ce n'est pas grave non plus.
En créant cette ressource, nous espérons faciliter plus que jamais les tests et le débogage dans Safari en aidant votre agent à comprendre comment les choses s'affichent et fonctionnent dans le navigateur.
Si vous finissez par l'essayer ou si c'est votre première fois avec un serveur MCP, dites-nous ce que vous en pensez. Signalez les problèmes via Feedback Assistant.
Vous pouvez aussi nous trouver en ligne : Saron Yitbarek sur Bluesky, Jen Simmons sur Bluesky / Mastodon, et Jon Davis sur Bluesky / Mastodon.