Skillry MCP in Codex verbinden (CLI, ChatGPT-App und IDE-Erweiterung)

Die Kurzantwort

1Führe codex mcp add skillry -- npx --yes skillry-cli@latest mcp einmal aus; unter Windows packst du den Start in cmd /c.
2Prüfe mit codex mcp list oder tippe /mcp in der Codex-TUI.
3Die ChatGPT-Desktop-App und die IDE-Erweiterung teilen den Eintrag: einmal einrichten, in allen dreien nutzen.

Hier starten:Hinzufügen Prüfen Autorisieren Es funktioniert nicht

Bevor du anfängst

Am 28. Oktober 2026 mit der offiziellen Dokumentation abgeglichen. Noch nicht auf einer echten Installation dieses Clients ausgeführt; wenn ein Schritt bei dir anders aussieht, nutze unten Problem melden.

Codex angemeldet: die CLI, die ChatGPT-Desktop-App mit Codex oder die IDE-Erweiterung. Sie teilen eine Konfiguration.
Node.js 22 oder neuer (node --version). Codex startet den Server mit npx.
Eine projektbezogene .codex/config.toml funktioniert auch, aber nur in Projekten, die du als vertrauenswürdig markiert hast. Diese Anleitung nutzt die globale Datei.

Skillry zu Codex hinzufügen

Am schnellsten, wenn du die Codex CLI nutzt

1
Führe dies in einem beliebigen Terminal aus:
macOS
```
codex mcp add skillry -- npx --yes skillry-cli@latest mcp
```
Das solltest du sehen: Kein Fehler, und codex mcp list enthält jetzt skillry.
2
Unter Windows führe stattdessen dies aus, damit Windows npx starten kann:
Windows (PowerShell oder Eingabeaufforderung)
```
codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Starte Codex erneut, oder starte die App oder die Erweiterung neu, falls eine offen ist.
Das solltest du sehen: skillry in der Liste von /mcp in Codex.

Kein Terminal nötig

1
Öffne in der ChatGPT-Desktop-App Settings, dann MCP servers. In der IDE-Erweiterung öffne das Zahnrad-Menü, dann MCP servers.
2
Wähle Add server. Gib den Namen skillry ein, wähle STDIO und gib den Befehl npx --yes skillry-cli@latest mcp ein (unter Windows cmd /c npx --yes skillry-cli@latest mcp).
3
Speichere, dann wähle Restart in der App oder Restart extension in der IDE.
Das solltest du sehen: skillry als aktiviert in der Liste der MCP-Server.

Wenn du deine Codex-Einstellungen in der Datei pflegst

1
Öffne ~/.codex/config.toml in einem Editor; lege sie an, falls sie nicht existiert.
2
Hänge diese Tabelle an. Existiert bereits eine Tabelle [mcp_servers.skillry], ersetze sie.
macOS
```
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]
```

Unter Windows nimm stattdessen diese Tabelle.

Windows

[mcp_servers.skillry]
command = "cmd"
args = ["/c","npx","--yes","skillry-cli@latest","mcp"]

4
Läuft der erste Start in den Timeout, füge startup_timeout_sec = 60 unter der Tabelle hinzu. Der Standard sind 10 Sekunden, und der erste npx-Lauf lädt das Paket herunter.
5
Speichere, dann starte Codex erneut.
Das solltest du sehen: skillry in codex mcp list und in /mcp.

Prüfen, ob Codex verbunden ist

1
Liste in einem Terminal die konfigurierten Server auf:
Terminal
```
codex mcp list
```
Das solltest du sehen: skillry mit dem npx-Befehl, den du eingegeben hast.
2
Tippe in der Codex-TUI /mcp.
Das solltest du sehen: skillry unter den aktiven Servern, mit seinen Tools.

Deine erste Suche

Suchen braucht kein Konto. Deshalb ist das der schnellste Weg, um zu prüfen, ob die Verbindung steht.

1
Starte eine neue Unterhaltung in Codex und füge diese Anfrage ein.
Prompt für deinen Agenten
```
Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.
```
Das solltest du sehen: Drei Skill-Kandidaten, jeder mit Vorschau-Link, benötigten Eingaben, Abhängigkeiten und etwaigen externen Kosten. Nichts wird installiert.
2
Antwortet der Agent, er habe kein Skillry-Tool, oder hängt die Anfrage, geh zu Es funktioniert nicht.

Beim Installieren autorisieren

Beim Installieren wird dein Skillry-Konto geprüft. Du tippst kein Passwort und fügst keinen Key in den Agenten ein: Beim ersten Mal öffnet er eine Seite in deinem Browser, und dort bestätigst du.

1
Bitte Codex, den gewählten Skill zu installieren, zum Beispiel mit Installiere ihn für dieses Projekt.
Das solltest du sehen: Der Agent meldet, dass er dein Konto verbinden muss, und öffnet den Browser. In einem Terminal-Client gibt er stattdessen vielleicht nur den Link aus; öffne ihn selbst.
2
Prüfe, ob der Gerätecode auf der Seite mit dem im Agenten übereinstimmt, melde dich bei Skillry an, falls nötig, und wähle Approve.
Das solltest du sehen: Authorization approved mit dem Hinweis, zum Agenten zurückzukehren. Der Agent merkt es innerhalb weniger Sekunden und schließt die Installation ab.

Die Freigabe gilt 7 Tage und liegt im Schlüsselbund deines Betriebssystems (Keychain auf macOS, Credential Manager auf Windows). Läuft sie ab, bittet der Agent einfach erneut um Bestätigung. Um dich früher abzumelden, bitte den Agenten, dein Skillry-Konto zu trennen.

Wenn Codex Skillry nicht sieht

Was du siehst	Wahrscheinliche Ursache	Was zu tun ist
`skillry` fehlt in `codex mcp list`	Die Tabelle landete in einer Projektdatei eines nicht vertrauenswürdigen Projekts, oder der Tabellenname hat einen Tippfehler	Lege die Tabelle in `~/.codex/config.toml` ab und prüfe, dass sie genau `[mcp_servers.skillry]` lautet.
Der Server wird nie bereit, oder Codex meldet einen Start-Timeout	Der erste `npx`-Download dauerte länger als `startup_timeout_sec` (standardmäßig 10 Sekunden)	Füge `startup_timeout_sec = 60` zur Tabelle hinzu, oder führe den Startbefehl einmal von Hand aus, damit das Paket im Cache liegt.
Funktioniert in der CLI, aber nicht in der ChatGPT-App	Die App war offen, während die Datei geändert wurde	Beende die ChatGPT-Desktop-App und öffne sie erneut, oder wähle Restart extension in der IDE.
Der Server ist aufgelistet, zeigt aber „failed“ oder startet nie	`npx` ist nicht installiert, Node.js ist älter als 22, oder der erste Start ist beim Herunterladen des Pakets in den Timeout gelaufen	Führe `node --version` und `npx --version` in einem Terminal aus. Starte dann einmal von Hand `npx --yes skillry-cli@latest mcp`, warte, bis es läuft, drücke Strg+C und probiere den Client erneut: Das Paket ist jetzt im Cache.
Unter Windows beendet sich der Server sofort nach dem Start	Der Eintrag startet `npx` direkt, Windows braucht dafür aber eine Shell	Nimm den Windows-Eintrag von dieser Seite: Der Befehl ist `cmd`, und die Argumente beginnen mit `/c`, `npx`.
Die Browserseite meldet, die Anfrage sei ungültig oder abgelaufen	Der Gerätecode wurde zu spät bestätigt oder gehört zu einem früheren Versuch	Bitte den Agenten, sich erneut zu verbinden, und bestätige den neuen Code innerhalb weniger Minuten.
Die Installation bricht mit einem Hinweis auf Premium oder Kauf ab	Der Skill ist Premium, und dein Konto hat weder einen Plan noch einen Kauf dafür	Folge dem Link, den der Agent zeigt, um den Skill zu kaufen oder zu abonnieren, und frag dann erneut. Vorher wird nichts abgebucht.

Entfernen oder trennen

1
Lösche die Tabelle [mcp_servers.skillry] aus ~/.codex/config.toml, oder nutze den Entfernen-Befehl, den codex mcp --help für deine Version auflistet. Um ihn abzuschalten, ohne ihn zu löschen, füge enabled = false zur Tabelle hinzu.
2
Starte Codex, die App oder die Erweiterung neu.
Das solltest du sehen: skillry ist aus codex mcp list verschwunden.

Den Eintrag zu entfernen meldet dich nicht bei Skillry ab. Um auch die gespeicherte Freigabe zu widerrufen, bitte den Agenten zuerst, dein Skillry-Konto zu trennen, oder entferne den Eintrag und lass die Freigabe nach 7 Tagen ablaufen.

Referenz

Element	macOS	Windows
Globale Konfigurationsdatei	`~/.codex/config.toml`	`%USERPROFILE%\.codex\config.toml`
Projekt-Konfigurationsdatei	`.codex/config.toml` (nur vertrauenswürdige Projekte)	gleich
Startbefehl	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Prüfen	`codex mcp list` oder `/mcp`	gleich

Die Tabelle, die Codex speichert (macOS)

[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]

Timeouts, Tool-Freigabelisten und Bestätigungsmodi stehen in der offiziellen Codex-MCP-Dokumentation.

Häufige Fragen

Richte ich es für die ChatGPT-Desktop-App separat ein?

Nein. App, CLI und IDE-Erweiterung lesen dieselbe config.toml. Starte die App nach der Änderung neu.

Kann ich es nur in einem Projekt nutzen?

Ja. Lege die Tabelle in einem vertrauenswürdigen Projekt in dessen .codex/config.toml ab statt in der globalen Datei.

Warum ist der erste Start langsam?

Der erste npx-Lauf lädt skillry-cli herunter. Erhöhe startup_timeout_sec oder führe den Startbefehl einmal von Hand aus; danach startet er sofort.

Quellen

War diese Anleitung hilfreich?

ZurückClaude Code WeiterCursor