Xcode einrichten | Weegloo Docs

Xcode kann Coding-Agents wie Claude Code oder Codex innerhalb seiner eigenen Oberfläche ausführen. Wenn Sie hier den WEEGLOO-MCP-Server anbinden, kann der innerhalb von Xcode laufende Agent Ressourcen wie Content Type, Content und Media direkt erstellen, lesen und bearbeiten. Das Installations-Tool installiert zusammen mit dem MCP-Server auch die Skills und Rules, damit der Agent die WEEGLOO API auf die vorgesehene Weise nutzt. Skills sind Anleitungen, die festhalten, wie eine bestimmte Aufgabe gut ausgeführt wird, und Rules sind Regeln, die über die gesamte Arbeit hinweg einzuhalten sind. Wählen Sie unten den Agenten aus, den Sie innerhalb von Xcode nutzen möchten, richten Sie alles in einem Schritt mit dem Installations-Tool ein und schließen dann die Authentifizierung der MCP-Anbindung ab.

Ausführliche Informationen zum MCP-Server sowie zu Skills und Rules werden jeweils auf den Seiten MCP und Skills und Rules behandelt. Diese Seite behandelt nur, wie Sie Xcode anbinden.

Voraussetzungen

Um den folgenden Installationsbefehl auszuführen, benötigen Sie Node.js. Prüfen Sie zunächst mit dem folgenden Befehl, ob es installiert ist und ob die Version 18 oder höher ist.

Terminal

node --version # v18 oder höher ist OK npx --version # Wenn eine Version ausgegeben wird, ist es OK

Wenn Node.js installiert ist, npx aber nicht, aktualisieren Sie npm mit dem folgenden Befehl auf die neueste Version. Beim Aktualisieren von npm wird npx gleich mitinstalliert.

Terminal

npm install -g npm@latest

Wenn Node.js nicht installiert ist oder die Version zu niedrig ist, installieren Sie Node.js auf die zu Ihrem Betriebssystem passende Weise.

Terminal

brew install node

Wenn Sie Homebrew nicht haben, installieren Sie es zuerst über brew.sh oder laden Sie Node.js direkt von nodejs.org herunter.

Terminal

winget install OpenJS.NodeJS.LTS

Wenn winget nicht vorhanden ist oder nicht erkannt wird, laden Sie die LTS-Installationsdatei von nodejs.org herunter. Nach der Installation müssen Sie das Terminal neu öffnen.

Die Distributionspakete können veraltet sein, daher wird die Installation über nvm empfohlen, das sich in verschiedenen Distributionen verwenden lässt.

Terminal

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

Wenn Sie die Installationsdatei direkt herunterladen möchten, sehen Sie auf nodejs.org nach.

Außerdem muss Xcode installiert sein. Falls noch nicht vorhanden, können Sie es unter Xcode herunterladen beziehen.

Anbinden

Für die Standardinstallation kopieren Sie den Installationsbefehl auf dieser Seite und führen ihn einmal im Terminal aus. Um die einzelnen Installationsschritte selbst auszuwählen, öffnen Sie die Benutzerdefinierte Installation. Die Xcode-Anbindung wird immer im aktuellen Projekt installiert, daher führen Sie den Installationsbefehl im Ordner des anzubindenden Projekts aus.

Coding-Tool

MCP und Skills installieren

Kopieren Sie den Installationsbefehl und führen Sie ihn im Terminal aus. Führen Sie ihn unbedingt innerhalb des Projektordners aus, den Sie anbinden möchten.

Terminal

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

MCP-Verbindung authentifizieren

Authentifizieren Sie in der folgenden Reihenfolge.

Führen Sie Claude Code im Terminal aus. Führen Sie es unbedingt innerhalb des Projektordners aus, den Sie anbinden möchten.

Terminal
claude
Beim ersten Start werden Sie möglicherweise gefragt, ob Sie die neuen MCP-Server aktivieren möchten. Prüfen Sie in diesem Fall, dass weegloo und weegloo-upload angehakt sind, und drücken Sie Enter, um zu bestätigen.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Geben Sie /mcp ein, um den Verwaltungsbildschirm der MCP-Server zu öffnen.

Terminal
/mcp
Wählen Sie in der Liste weegloo aus. Es wird mit dem Status needs authentication angezeigt.

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

Wenn die Server nicht in der Liste erscheinen: Wenn weegloo und weegloo-upload nicht in der Liste erscheinen, haben Sie sie im Aktivierungsbildschirm aus Schritt 2 möglicherweise nicht bestätigt, oder sie sind deaktiviert. Beenden Sie Claude Code, geben Sie den folgenden Befehl im Terminal ein und führen Sie erneut claude aus. Wenn derselbe Bildschirm wie in Schritt 2 wieder erscheint, drücken Sie bei angehakten weegloo und weegloo-upload Enter, um zu bestätigen.
Terminal
claude mcp reset-project-choices
Prüfen Sie, ob die Verbindungsadresse https://ai.weegloo.com/mcp lautet, und wählen Sie Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Wenn Sie Authenticate wählen, öffnet sich im Browser die WEEGLOO-Authentifizierungsseite wie unten dargestellt. Kopieren Sie mit der Schaltfläche Token kopieren den Token, fügen Sie ihn ein und klicken Sie auf Server verbinden. Sobald weegloo zu connected wechselt, ist es fertig.

Nach der Installation müssen Sie eine neue Xcode-Agent-Sitzung öffnen, damit die Einstellungen wirksam werden.

MCP und Skills installieren

Kopieren Sie den Installationsbefehl und führen Sie ihn im Terminal aus. Führen Sie ihn unbedingt innerhalb des Projektordners aus, den Sie anbinden möchten.

Terminal

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

MCP-Verbindung authentifizieren

Authentifizieren Sie in der folgenden Reihenfolge.

Wenn Sie den folgenden Befehl im Terminal ausführen, öffnet sich die WEEGLOO-Authentifizierungsseite im Browser.

Terminal
codex mcp login weegloo
Kopieren Sie auf der geöffneten WEEGLOO-Authentifizierungsseite mit der Schaltfläche Token kopieren unten den Token, fügen Sie ihn ein und klicken Sie auf Server verbinden. Ein bereits laufender Agent muss nach Abschluss der Authentifizierung neu gestartet werden, damit die Änderungen wirksam werden.

Nach der Installation müssen Sie eine neue Xcode-Agent-Sitzung öffnen, damit die Einstellungen wirksam werden.

Führen Sie npx weegloo interaktiv aus und installieren Sie, indem Sie die abgefragten Punkte selbst auswählen.

Coding-Tool

Installations-Tool ausführen

Wechseln Sie in den Projektordner, den Sie anbinden möchten, führen Sie dann in diesem Ordner den folgenden Befehl aus und wählen Sie die abgefragten Punkte der Reihe nach aus. Wo nach dem Token gefragt wird, kopieren Sie den Token mit der Schaltfläche Token kopieren unten und fügen ihn ein. Führen Sie ihn unbedingt innerhalb dieses Projektordners aus.

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: **** ← kopierter Token ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

MCP-Verbindung authentifizieren

Authentifizieren Sie in der folgenden Reihenfolge.

Führen Sie Claude Code im Terminal aus. Führen Sie es unbedingt innerhalb des Projektordners aus, den Sie anbinden möchten.

Terminal
claude
Beim ersten Start werden Sie möglicherweise gefragt, ob Sie die neuen MCP-Server aktivieren möchten. Prüfen Sie in diesem Fall, dass weegloo und weegloo-upload angehakt sind, und drücken Sie Enter, um zu bestätigen.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Geben Sie /mcp ein, um den Verwaltungsbildschirm der MCP-Server zu öffnen.

Terminal
/mcp
Wählen Sie in der Liste weegloo aus. Es wird mit dem Status needs authentication angezeigt.

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

Wenn die Server nicht in der Liste erscheinen: Wenn weegloo und weegloo-upload nicht in der Liste erscheinen, haben Sie sie im Aktivierungsbildschirm aus Schritt 2 möglicherweise nicht bestätigt, oder sie sind deaktiviert. Beenden Sie Claude Code, geben Sie den folgenden Befehl im Terminal ein und führen Sie erneut claude aus. Wenn derselbe Bildschirm wie in Schritt 2 wieder erscheint, drücken Sie bei angehakten weegloo und weegloo-upload Enter, um zu bestätigen.
Terminal
claude mcp reset-project-choices
Prüfen Sie, ob die Verbindungsadresse https://ai.weegloo.com/mcp lautet, und wählen Sie Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Wenn Sie Authenticate wählen, öffnet sich im Browser die WEEGLOO-Authentifizierungsseite wie unten dargestellt. Kopieren Sie mit der Schaltfläche Token kopieren den Token, fügen Sie ihn ein und klicken Sie auf Server verbinden. Sobald weegloo zu connected wechselt, ist es fertig.

Nach der Installation müssen Sie eine neue Xcode-Agent-Sitzung öffnen, damit die Einstellungen wirksam werden.

Installations-Tool ausführen

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: **** ← kopierter Token ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

MCP-Verbindung authentifizieren

Authentifizieren Sie in der folgenden Reihenfolge.

Wenn Sie den folgenden Befehl im Terminal ausführen, öffnet sich die WEEGLOO-Authentifizierungsseite im Browser.

Terminal
codex mcp login weegloo
Kopieren Sie auf der geöffneten WEEGLOO-Authentifizierungsseite mit der Schaltfläche Token kopieren unten den Token, fügen Sie ihn ein und klicken Sie auf Server verbinden. Ein bereits laufender Agent muss nach Abschluss der Authentifizierung neu gestartet werden, damit die Änderungen wirksam werden.

Nach der Installation müssen Sie eine neue Xcode-Agent-Sitzung öffnen, damit die Einstellungen wirksam werden.

MCP-Server-Konfigurationsdatei

Das Installations-Tool erstellt und verwaltet die Konfigurationsdatei automatisch, sodass Sie sie nicht selbst prüfen müssen. Der folgende Inhalt ist Referenzmaterial für Benutzer, die die konkrete Struktur und die Pfade der Konfigurationsdatei benötigen.

Das Installations-Tool registriert den Server in der Konfigurationsdatei des Agenten, den Sie für die Nutzung innerhalb von Xcode gewählt haben. Die Xcode-Anbindung wird immer im aktuellen Projekt installiert, daher wird auch die Datei im Projektordner erstellt. Je nach gewähltem Agenten unterscheidet sich die Datei.

Claude Code: .mcp.json im Projektordner (das Format ist dasselbe wie unter Claude Code einrichten)
Codex: .codex/config.toml im Projektordner (das Format ist dasselbe wie unter Codex einrichten)

Nur bei der Nutzung innerhalb von Xcode gibt es einen Unterschied. Im env des Servers weegloo-upload, der Dateien verarbeitet, kommt zusätzlich ein PATH-Eintrag hinzu. Xcode führt den Agenten mit einem minimalen PATH aus, und ohne diesen Eintrag findet er das für die Serverausführung nötige npx nicht. Bei Claude Code (.mcp.json) sieht es wie folgt aus.

{
  "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>"
      }
    }
  }
}

In diesem PATH wird der Ort des Node, mit dem die Installation ausgeführt wurde, unverändert festgeschrieben. Wenn Sie Node auf eine neue Version anheben, stimmt dieser Pfad nicht mehr, führen Sie daher nach dem Upgrade das Installations-Tool erneut aus, um den Wert zu aktualisieren.

Skills und Rules

Auch Skills und Rules folgen der Vorgehensweise des gewählten Agenten. Die genauen Orte finden Sie in den Skills- und Rules-Abschnitten von Claude Code einrichten und Codex einrichten.

Nächste Schritte

MCP: Behandelt die Grundlagen der Anbindung wie Servergruppen und den Server für Datei-Uploads.
Skills und Rules: Behandelt, was die Skills und Rules sind, die das Installations-Tool gleich mitinstalliert.
Auf dem neuesten Stand halten: Behandelt, wie Sie die installierten Skills und Rules aktuell halten.
Statische Seiten mit KI übernehmen: Folgt dem Ablauf, eine reale Seite mit dem angebundenen MCP in einen content-basierten Service zu überführen.