[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

Intégrations

Xcode

Xcode 26.3+ intègre un serveur MCP qui donne à Cursor un accès direct à vos projets Xcode. L’agent de Cursor peut lire et modifier des fichiers, déclencher des builds, exécuter des tests, capturer des aperçus SwiftUI et effectuer des recherches dans la documentation d’Apple, le tout sans quitter votre éditeur.

Cela fonctionne via xcrun mcpbridge, un binaire fourni par Apple avec Xcode qui traduit les messages du protocole MCP vers la couche XPC interne de Xcode. Vous le configurez une seule fois, et Cursor traite les 20 outils intégrés de Xcode comme n’importe quel autre serveur MCP.

Prérequis

  • macOS avec Xcode 26.3 ou une version ultérieure installé
  • Un forfait Cursor payant
  • Un projet Xcode ouvert dans Xcode (Xcode doit être en cours d’exécution)

Activer MCP dans Xcode

Pour permettre à Cursor de se connecter, activez le pont MCP de Xcode :

1

Ouvrir les réglages de Xcode

Accédez à Xcode > Settings > Intelligence.

2

Activer MCP

Dans Model Context Protocol, activez Xcode Tools.

Configurer Cursor

Choisissez la méthode la mieux adaptée à votre flux de travail.

Option 1 : interface des paramètres MCP

1

Ouvrir les paramètres MCP

Accédez à Customize > MCPs.

2

Ajouter le serveur

Cliquez sur Add New MCP Server. Définissez le transport sur stdio, nommez-le xcode-tools et saisissez xcrun mcpbridge comme commande.

Option 2 : mcp.json

Ajoutez une entrée dans votre fichier de configuration MCP :

~/.cursor/mcp.json
{  "mcpServers": {    "xcode-tools": {      "command": "xcrun",      "args": ["mcpbridge"]    }  }}

Option 3 : CLI de Cursor

Si vous utilisez la CLI de Cursor, enregistrez le serveur depuis le terminal :

agent mcp add xcode-tools -- xcrun mcpbridge

La CLI utilise la même configuration MCP que l’éditeur : le serveur apparaît donc dans les deux.

Outils disponibles

Xcode met à disposition 20 outils MCP répartis en cinq catégories :

Opérations sur les fichiers

  • XcodeRead - Lire le contenu des fichiers (jusqu’à 600 lignes par appel, avec décalage/limite pour les fichiers plus volumineux)
  • XcodeWrite - Créer ou écraser des fichiers
  • XcodeUpdate - Appliquer des modifications ciblées à des fichiers existants
  • XcodeGrep - Rechercher dans le contenu des fichiers à l’aide d’expressions régulières
  • XcodeGlob - Rechercher des fichiers par motif
  • XcodeLS - Lister le contenu des répertoires
  • XcodeMakeDir - Créer des répertoires
  • XcodeRM - Supprimer des fichiers ou des répertoires
  • XcodeMV - Déplacer ou renommer des fichiers

Compilation et tests

  • BuildProject - Compiler le schéma actif
  • GetBuildLog - Récupérer les journaux de compilation, filtrables par niveau de gravité, expression régulière ou glob de fichiers
  • RunAllTests - Exécuter l’intégralité de la suite de tests
  • RunSomeTests - Exécuter des classes ou méthodes de test spécifiques
  • GetTestList - Lister les tests disponibles

Diagnostics

  • XcodeListNavigatorIssues - Afficher les avertissements et les erreurs dans le navigateur de problèmes
  • XcodeRefreshCodeIssuesInFile - Vérifier à nouveau un fichier pour détecter les problèmes de code

Intelligence

  • RenderPreview - Capturer une capture d’écran d’un aperçu SwiftUI
  • DocumentationSearch - Recherche sémantique dans la documentation d’Apple et les transcriptions de la WWDC
  • ExecuteSnippet - Exécuter un extrait de code Swift

Espace de travail

  • XcodeListWindows - Répertorie les fenêtres et onglets Xcode ouverts

Exemple de flux de travail

Voici à quoi ressemble un flux de travail type avec Cursor et Xcode :

  1. Ouvrez votre projet dans Cursor et Xcode
  2. Demandez à l’agent de Cursor d’ajouter une fonctionnalité ou de corriger un bug
  3. L’agent utilise XcodeRead et XcodeGrep pour comprendre votre code
  4. Il modifie des fichiers avec XcodeWrite ou XcodeUpdate
  5. Il exécute BuildProject pour vérifier les erreurs, puis lit les résultats avec GetBuildLog
  6. Il exécute des tests avec RunSomeTests pour vérifier la modification
  7. Il génère un aperçu SwiftUI avec RenderPreview pour vérifier l’interface utilisateur

Vous restez dans Cursor tout au long du processus. Xcode gère la compilation, les tests et les aperçus en arrière-plan.

CLI de Cursor avec Xcode

La CLI de Cursor fonctionne également avec les outils MCP de Xcode. Elle est utile pour les flux de travail sans interface graphique, les pipelines CI ou les développeurs travaillant principalement dans le terminal.

# Lancer l'agent avec les outils Xcode disponiblesagent "Add unit tests for the NetworkManager class"

L’agent détecte le serveur MCP xcode-tools dans votre configuration et utilise les mêmes outils que dans l’éditeur.

Dépannage

Assurez-vous que Xcode est lancé et qu’un projet y est ouvert. Le processus xcrun mcpbridge nécessite une session Xcode active avec laquelle communiquer.

Certains outils MCP de Xcode nécessitent un contexte d’espace de travail. Vérifiez qu’un projet ou un espace de travail est ouvert dans Xcode, et non une fenêtre vide.

Les projets volumineux prennent plus de temps à compiler. Vérifiez directement la progression de la compilation dans Xcode. Le pont MCP attend la réponse de Xcode ; les délais d’expiration indiquent donc généralement que l’opération sous-jacente est toujours en cours.

Vous avez besoin de Xcode 26.3 ou d’une version ultérieure. Vérifiez votre version dans Xcode > À propos de Xcode et effectuez la mise à jour via le Mac App Store ou les téléchargements Apple Developer.

Votre système utilise les Command Line Tools au lieu de l’installation complète de Xcode. Corrigez cela en exécutant :

sudo xcode-select -s /Applications/Xcode.app/Contents/Developersudo xcodebuild -runFirstLaunch

Vérifiez ensuite que le pont est disponible :

xcrun --find mcpbridge

Cette commande doit renvoyer un chemin de fichier, et non une erreur. Une fois cette étape effectuée, ouvrez Xcode avec votre projet, accédez à Settings > Intelligence > Model Context Protocol, puis activez Allow external agents. Réactivez ensuite le serveur MCP de Xcode dans les paramètres de Cursor. Une boîte de dialogue d’autorisation dans Xcode devrait confirmer la connexion.

À consulter également

Aperçu de MCP

Guide complet de MCP, incluant l’installation, la configuration et l’authentification

iOS et macOS (Swift)

Flux de travail de développement Swift avec Cursor, Sweetpad et Xcode Build Server

CLI de Cursor

Utilisez l’agent de Cursor depuis le terminal

Commandes MCP de la CLI

Gérez les serveurs MCP depuis la ligne de commande