Weegloo Docs - Configurer Xcode

Xcode peut exécuter des agents de codage comme Claude Code ou Codex directement dans 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. Ci-dessous, choisissez l'agent à utiliser dans Xcode, configurez tout en une fois avec l'outil d'installation, puis il ne vous reste qu'à terminer l'authentification.

MCP lui-même, les groupes de serveurs et le serveur de téléversement de fichiers sont présentés dans MCP. Cette page ne traite que des étapes de connexion à 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.

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

Choisissez l'agent à utiliser dans Xcode, puis suivez le guide ci-dessous. La connexion à Xcode s'installe toujours dans le projet en cours ; exécutez donc la commande d'installation à l'intérieur du dossier du projet à connecter.

Agent à utiliser dans Xcode

Installer MCP · Skills

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

Terminal

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --token wgl_••••••••••••

Authentifier MCP

Authentifiez-vous dans l'ordre ci-dessous.

1.Lancez Claude Code dans le terminal. Veillez à le lancer dans le dossier du projet que vous voulez connecter.
Terminal
claude
2.Au premier lancement, Claude Code peut demander quels nouveaux serveurs MCP activer. Le cas échéant, vérifiez que weegloo et weegloo-upload sont cochés et appuyez sur Enter pour valider.
Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
3.Saisissez /mcp pour ouvrir l'écran de gestion des serveurs MCP.
Terminal
/mcp
4.Sélectionnez weegloo dans la liste. Il apparaît comme 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, vous ne les avez peut-être pas validés sur l'écran d'activation de l'étape 2, ou ils sont désactivés. Quittez Claude Code, saisissez la commande ci-dessous dans le terminal, puis relancez claude. Quand le même écran qu'à l'étape 2 réapparaît, vérifiez que weegloo et weegloo-upload sont cochés et appuyez sur Enter pour valider.
Terminal
claude mcp reset-project-choices
5.Vérifiez que l'URL est https://ai.weegloo.com/mcp et choisissez Authenticate.
Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
6.Quand vous choisissez Authenticate, une page d'authentification WEEGLOO comme ci-dessous s'ouvre dans le navigateur. Copiez le token avec le bouton Copier le token, collez-le, puis cliquez sur Connecter le serveur. Quand weegloo passe à connected, c'est terminé.

Après l'installation, ouvrez une nouvelle session de l'agent Xcode pour qu'il prenne en compte la configuration.

Vérifier directement le fichier de configuration

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'installant toujours dans le projet en cours, le fichier est lui aussi créé à l'intérieur du dossier du projet. Le fichier diffère selon l'agent choisi.

Claude Code : .mcp.json dans le dossier du projet (le format est le même que dans Configurer Claude Code)
Codex : .codex/config.toml dans le 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 : l'env du serveur weegloo-upload, qui gère les fichiers, comporte en plus une entrée PATH. En effet, Xcode exécute l'agent avec un PATH minimal, et sans cette entrée, il ne trouverait pas npx, nécessaire à l'exécution du serveur. Avec Claude Code (.mcp.json), cela ressemble à ce qui suit.

{
  "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 reçoit 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.

É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.
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é.