Configurer Xcode | Weegloo Docs

Xcode peut exécuter des agents de codage comme Claude Code ou Codex à l'intérieur de sa propre interface. En y connectant le serveur MCP de WEEGLOO, l'agent qui s'exécute dans Xcode peut créer, lire et modifier directement des ressources comme Content Type, Content ou Media. L'outil d'installation installe aussi des Skills et des Rules en plus du serveur MCP, ce qui aide l'agent à utiliser l'API de WEEGLOO de la manière prévue. Les Skills sont des guides qui expliquent comment bien accomplir une tâche précise, et les Rules sont des règles à respecter tout au long du travail. Ci-dessous, choisissez l'agent que vous utiliserez dans Xcode, configurez tout en une fois avec l'outil d'installation, puis terminez l'authentification de la connexion MCP.

Pour en savoir plus sur le serveur MCP et sur les Skills et les Rules, reportez-vous respectivement aux pages MCP et Skills et Rules. Cette page ne traite que de la manière de se connecter à Xcode.

Prérequis

Node.js est nécessaire pour exécuter les commandes d'installation ci-dessous. Vérifiez d'abord, avec les commandes suivantes, s'il est installé et si sa version est 18 ou ultérieure.

Terminal

node --version # OK si v18 ou version ultérieure npx --version # OK si une version s'affiche

Si Node.js est installé mais que npx ne l'est pas, mettez npm à jour vers sa dernière version avec la commande ci-dessous. La mise à jour de npm installe npx en même temps.

Terminal

npm install -g npm@latest

Si Node.js n'est pas installé ou si sa version est trop ancienne, installez Node.js selon la méthode adaptée à votre système d'exploitation.

Terminal

brew install node

Si vous n'avez pas Homebrew, installez-le d'abord depuis brew.sh, ou téléchargez Node.js directement depuis nodejs.org.

Terminal

winget install OpenJS.NodeJS.LTS

Si winget est absent ou n'est pas reconnu, téléchargez le fichier d'installation LTS depuis nodejs.org. Après l'installation, vous devez rouvrir le terminal.

Les paquets des distributions peuvent être anciens ; nous recommandons donc l'installation via nvm, utilisable sur plusieurs distributions.

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

Pour télécharger le fichier d'installation directement, rendez-vous sur nodejs.org.

Xcode doit également être installé. Si ce n'est pas encore le cas, vous pouvez le télécharger depuis Télécharger Xcode.

Se connecter

Pour l'installation par défaut, il vous suffit de copier la commande d'installation de cette page et de l'exécuter une fois dans le terminal. Pour choisir vous-même chaque étape de l'installation, ouvrez Installation personnalisée. La connexion à Xcode s'installe toujours dans le projet en cours ; vous exécutez donc la commande d'installation dans le dossier du projet que vous voulez connecter.

Outil de codage

Installer MCP et Skills

Copiez la commande d'installation et exécutez-la dans le terminal. Vous devez impérativement l'exécuter dans le dossier du projet que vous voulez connecter.

Terminal

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --location project \ --token <Personal Access Token>

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

Lancez Claude Code dans le terminal. Vous devez impérativement l'exécuter dans le dossier du projet que vous voulez connecter.

Terminal
claude
Au premier lancement, il se peut qu'on vous demande d'activer les nouveaux serveurs MCP. Dans ce cas, vérifiez que weegloo et weegloo-upload sont cochés, puis appuyez sur Enter pour valider.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Saisissez /mcp pour ouvrir l'écran de gestion des serveurs MCP.

Terminal
/mcp
Dans la liste, sélectionnez weegloo. Il apparaît avec l'état needs authentication.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

Si les serveurs n'apparaissent pas dans la liste : si weegloo et weegloo-upload n'apparaissent pas dans la liste, il se peut que vous n'ayez pas validé à l'écran d'activation de l'étape 2, ou qu'ils soient désactivés. Fermez Claude Code, saisissez la commande ci-dessous dans le terminal, puis relancez claude. Si le même écran qu'à l'étape 2 réapparaît, appuyez sur Enter pour valider avec weegloo et weegloo-upload cochés.
Terminal
claude mcp reset-project-choices
Vérifiez que l'adresse de connexion est https://ai.weegloo.com/mcp, puis sélectionnez Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Lorsque vous sélectionnez Authenticate, la page d'authentification WEEGLOO suivante s'ouvre dans le navigateur. Copiez le token avec le bouton Copier le token, collez-le, puis cliquez sur Connecter le serveur. C'est terminé lorsque weegloo passe à connected.

Une fois l'installation terminée, vous devez ouvrir une nouvelle session Xcode Agent pour que les changements prennent effet.

Installer MCP et Skills

Copiez la commande d'installation et exécutez-la dans le terminal. Vous devez impérativement l'exécuter dans le dossier du projet que vous voulez connecter.

Terminal

$ npx weegloo@latest -y \ --agent codex \ --host xcode \ --location project \ --token <Personal Access Token>

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

En exécutant la commande ci-dessous dans le terminal, la page d'authentification WEEGLOO s'ouvre dans votre navigateur.

Terminal
codex mcp login weegloo
Sur la page d'authentification WEEGLOO qui s'ouvre, copiez le token avec le bouton Copier le token ci-dessous, collez-le, puis cliquez sur Connecter le serveur. Un agent qui était déjà en cours d'exécution doit être redémarré une fois l'authentification terminée pour que les changements prennent effet.

Une fois l'installation terminée, vous devez ouvrir une nouvelle session Xcode Agent pour que les changements prennent effet.

Exécutez npx weegloo en mode interactif et installez en choisissant vous-même les éléments demandés.

Outil de codage

Exécuter l'outil d'installation

Rendez-vous dans le dossier du projet que vous voulez connecter, puis exécutez la commande ci-dessous dans ce dossier et choisissez les éléments demandés les uns après les autres. Là où le token est demandé, copiez le token avec le bouton Copier le token ci-dessous et collez-le. Veillez à l'exécuter dans ce dossier de projet.

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token copié ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

Lancez Claude Code dans le terminal. Vous devez impérativement l'exécuter dans le dossier du projet que vous voulez connecter.

Terminal
claude
Au premier lancement, il se peut qu'on vous demande d'activer les nouveaux serveurs MCP. Dans ce cas, vérifiez que weegloo et weegloo-upload sont cochés, puis appuyez sur Enter pour valider.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Saisissez /mcp pour ouvrir l'écran de gestion des serveurs MCP.

Terminal
/mcp
Dans la liste, sélectionnez weegloo. Il apparaît avec l'état needs authentication.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

Si les serveurs n'apparaissent pas dans la liste : si weegloo et weegloo-upload n'apparaissent pas dans la liste, il se peut que vous n'ayez pas validé à l'écran d'activation de l'étape 2, ou qu'ils soient désactivés. Fermez Claude Code, saisissez la commande ci-dessous dans le terminal, puis relancez claude. Si le même écran qu'à l'étape 2 réapparaît, appuyez sur Enter pour valider avec weegloo et weegloo-upload cochés.
Terminal
claude mcp reset-project-choices
Vérifiez que l'adresse de connexion est https://ai.weegloo.com/mcp, puis sélectionnez Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Lorsque vous sélectionnez Authenticate, la page d'authentification WEEGLOO suivante s'ouvre dans le navigateur. Copiez le token avec le bouton Copier le token, collez-le, puis cliquez sur Connecter le serveur. C'est terminé lorsque weegloo passe à connected.

Une fois l'installation terminée, vous devez ouvrir une nouvelle session Xcode Agent pour que les changements prennent effet.

Exécuter l'outil d'installation

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token copié ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

Authentifier la connexion MCP

Authentifiez-vous dans l'ordre ci-dessous.

En exécutant la commande ci-dessous dans le terminal, la page d'authentification WEEGLOO s'ouvre dans votre navigateur.

Terminal
codex mcp login weegloo
Sur la page d'authentification WEEGLOO qui s'ouvre, copiez le token avec le bouton Copier le token ci-dessous, collez-le, puis cliquez sur Connecter le serveur. Un agent qui était déjà en cours d'exécution doit être redémarré une fois l'authentification terminée pour que les changements prennent effet.

Une fois l'installation terminée, vous devez ouvrir une nouvelle session Xcode Agent pour que les changements prennent effet.

Fichier de configuration du serveur MCP

L'outil d'installation crée et gère automatiquement le fichier de configuration, vous n'avez donc pas besoin de le vérifier vous-même. Le contenu ci-dessous est un document de référence destiné aux utilisateurs qui ont besoin de la structure et des chemins précis du fichier de configuration.

L'outil d'installation enregistre le serveur dans le fichier de configuration de l'agent que vous avez choisi d'utiliser dans Xcode. La connexion à Xcode s'installe toujours dans le projet en cours ; le fichier est donc lui aussi créé à l'intérieur du dossier du projet. Le fichier diffère selon l'agent choisi.

Claude Code : le fichier .mcp.json du dossier du projet (le format est le même que dans Configurer Claude Code)
Codex : le fichier .codex/config.toml du dossier du projet (le format est le même que dans Configurer Codex)

Il y a une seule différence propre à l'utilisation dans Xcode. Une entrée PATH est ajoutée dans l'env du serveur weegloo-upload, qui gère les fichiers. Xcode exécute l'agent avec un PATH minimal, et sans cette entrée il ne trouverait pas npx, nécessaire pour lancer le serveur. Pour Claude Code (.mcp.json), cela ressemble à ceci.

{
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "PATH": "/Users/jiwoo/.nvm/versions/node/v22.14.0/bin:/usr/bin:/bin",
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

Ce PATH contient tel quel l'emplacement du Node avec lequel l'installation a été exécutée. Si vous passez Node à une nouvelle version, ce chemin ne correspond plus ; après une mise à niveau, relancez donc l'outil d'installation pour actualiser la valeur.

Skills et Rules

Les Skills et les Rules suivent eux aussi la manière de faire de l'agent choisi. Pour les emplacements précis, reportez-vous aux sections Skills et Rules de Configurer Claude Code et Configurer Codex.

Étapes suivantes

MCP : présente les bases de la connexion, comme les groupes de serveurs et le serveur de téléversement de fichiers.
Skills et Rules : présente ce que sont les Skills et les Rules que l'outil d'installation installe en même temps.
Rester à jour : présente comment maintenir à jour les Skills et les Rules installés.
Migrer des pages statiques avec l'IA : suit le déroulé permettant de migrer une page réelle vers un service basé sur le contenu à l'aide du MCP connecté.