Codex einrichten | Weegloo Docs

Codex ist ein Coding-Agent, der im Terminal läuft. Wenn Sie hier den WEEGLOO-MCP-Server anbinden, kann Codex 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 Codex 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. Sie richten alles in einem Schritt mit dem Installations-Tool ein und schließen anschließend 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 Codex anbinden.

Voraussetzungen

Um die folgenden Installationsbefehle 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 Codex so installiert sein, dass Sie es im Terminal mit dem Befehl codex ausführen können. Falls noch nicht vorhanden, sehen Sie in der Anleitung zur Installation der Codex CLI nach.

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.

Installationsort

MCP und Skills installieren

Kopieren Sie den Installationsbefehl und führen Sie ihn im Terminal aus.

Terminal

$ npx weegloo@latest -y \ --agent codex \ --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.

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 \ --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.

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

Installationsort

Installations-Tool ausführen

Führen Sie den folgenden Befehl im Terminal 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.

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? Global … ✔ 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.

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

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.

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 Nutzer, die die konkrete Struktur und die Pfade der Konfigurationsdatei benötigen.

Der Server weegloo verbindet sich per HTTP mit https://ai.weegloo.com/mcp, und der Server weegloo-upload, der Dateien verarbeitet, läuft über npx und verwendet zur Authentifizierung den Personal Access Token. Bei einer globalen Installation wird er in ~/.codex/config.toml im Home-Verzeichnis registriert, bei einer Projekt-Installation in .codex/config.toml innerhalb des Projektordners.

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"
 
[mcp_servers.weegloo-upload]
command = "npx"
args = ["-y", "weegloo-upload"]
 
[mcp_servers.weegloo-upload.env]
UPLOAD_API_URL = "https://upload.weegloo.com/v1"
AUTH_BEARER_TOKEN = "<Personal Access Token>"

Um die Servergruppe zu ändern, hängen Sie an das Ende der url des Servers weegloo einen group-Wert an. Um zum Beispiel alle Tools zu nutzen, schreiben Sie https://ai.weegloo.com/mcp?group=all. Für die Tool-Zusammensetzung der einzelnen Gruppen siehe MCP-Servergruppen.

Bei einer Projekt-Installation fügt das Installations-Tool auch in ~/.codex/config.toml im Home-Verzeichnis einen Eintrag hinzu. Codex liest die .codex/config.toml innerhalb eines Ordners nur bei Projekten, denen es vertraut. Ohne diesen Eintrag werden die soeben registrierten MCP-Server ignoriert, daher markiert das Installations-Tool das betreffende Projekt als vertrauenswürdig. An der Stelle des Pfads steht der tatsächliche Pfad des Projektordners, in dem Sie die Installation ausgeführt haben.

[projects."/Users/jimin/projects/jeju-shop"]
trust_level = "trusted"

Skills

Das Installations-Tool legt jeden Skill als einzelnes Verzeichnis unter .agents/skills/ ab. Eine globale Installation verwendet ~/.agents/skills/, eine Projekt-Installation .agents/skills/ im Projektordner; Codex liest die Skills von diesem Ort.

Rules

Codex hat kein eigenes Konzept von Rules. Deshalb legt das Installations-Tool die Inhalte, die den Rules entsprechen, also Inhalte, die dieselbe Rolle wie die Rules von Claude Code spielen, in die Datei AGENTS.md. Eine globale Installation verwendet ~/.codex/AGENTS.md, eine Projekt-Installation die AGENTS.md im Projektordner.

Nächste Schritte

MCP: behandelt die Grundlagen der Anbindung, etwa Servergruppen und den Datei-Upload-Server.
Skills und Rules: behandelt, was die Skills und Rules sind, die das Installations-Tool zugleich installiert.
Auf dem neuesten Stand halten: behandelt, wie Sie die installierten Skills und Rules aktuell halten.
Statische Seiten mit KI migrieren: folgt dem Ablauf, eine reale Seite mit der eingerichteten MCP-Anbindung in einen inhaltsbasierten Dienst zu überführen.