Skillry MCP in Claude Code verbinden (macOS und Windows)

Die Kurzantwort

1Führe claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp einmal in einem beliebigen Terminal aus. Ohne --scope user existiert der Server nur in dem Ordner, aus dem du ihn angelegt hast.
2Prüfe mit claude mcp get skillry. Die Statuszeile sollte ✔ Connected zeigen.
3Der Eintrag liegt in ~/.claude.json (Windows: %USERPROFILE%\.claude.json). Du kannst das JSON auch von Hand dort einfügen.

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

Bevor du anfängst

Am 28. Oktober 2026 auf macOS mit Claude Code 2.1.296 getestet. Der Windows-Befehl folgt der offiziellen Dokumentation und wurde noch nicht auf einem echten Rechner ausgeführt.

Claude Code installiert und angemeldet. claude --version sollte eine 2.x-Version ausgeben.
Node.js 22 oder neuer (node --version). Claude Code startet den Server mit npx, das mit Node mitkommt.
Nichts von Skillry herunterladen: npx holt das Paket beim ersten Start des Servers.

Claude Code speichert einen Server in einem von drei Geltungsbereichen. Diese Anleitung nutzt den Bereich user, damit Skillry in jedem Projekt da ist.

Geltungsbereich	Flag	Gespeichert in	Nutze ihn, wenn
User	`--scope user`	`~/.claude.json`, oberste Ebene	Du Skillry in jedem Projekt willst. Diese Anleitung.
Local (Standard)	keins	`~/.claude.json`, unter dem Pfad des aktuellen Projekts	Du es nur in diesem Ordner willst.
Project	`--scope project`	`.mcp.json` im Repository	Dein Team es aus dem Repo bekommen soll. Jeder bestätigt es beim ersten Start.

Skillry zu Claude Code hinzufügen

Am schnellsten. Funktioniert in jeder Shell, auch PowerShell und Eingabeaufforderung

1
Öffne ein Terminal in einem beliebigen Ordner und führe aus:
macOS
```
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp
```
Das solltest du sehen: Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config, dann File modified: ~/.claude.json.
2
Unter Windows führe stattdessen dies aus. Der Wrapper cmd /c erlaubt Windows, npx zu starten, das ein Skript und kein Programm ist.
Windows (PowerShell oder Eingabeaufforderung)
```
claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
Starte eine neue Claude-Code-Sitzung oder tippe /mcp in einer bereits offenen.
Das solltest du sehen: skillry in der Liste von /mcp. Wähle es aus, um seine 12 Tools zu sehen.

Wenn du die Datei lieber selbst verwaltest

1
Öffne ~/.claude.json in einem Editor. Unter Windows heißt die Datei %USERPROFILE%\.claude.json. Claude Code legt sie beim ersten Start an.
2
Füge dies in das Objekt mcpServers auf oberster Ebene ein und behalte vorhandene Server bei.
macOS
```
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}
```
Oberste Ebene heißt: neben den anderen Schlüsseln an der Wurzel der Datei. Ein Eintrag unter einem Projektpfad lädt nur in diesem Projekt.

Unter Windows nimm stattdessen diesen Eintrag.

Windows

{
  "mcpServers": {
    "skillry": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

4
Speichere die Datei und starte eine neue Sitzung.
Das solltest du sehen: skillry in der Liste von /mcp.

Prüfen, ob Claude Code verbunden ist

1
Führe in einem Terminal aus:
Terminal
```
claude mcp get skillry
```
Das solltest du sehen: Scope: User config (available in all your projects), Status: ✔ Connected und der npx-Befehl, den du hinzugefügt hast.
2
Um alle Server mit ihrem Zustand auf einmal zu sehen, führe claude mcp list aus. In einer Sitzung zeigt /mcp dieselbe Liste und lässt dich die Tools eines Servers öffnen.

Die erste Prüfung startet den Server, und der erste Start lädt skillry-cli herunter. Gib ihm zehn Sekunden oder mehr. Ein ✘ Failed to connect, das danach bleibt, bedeutet, dass Node oder npx fehlt; siehe unten.

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 Claude Code 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 Claude Code, 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 /mcp Skillry nicht auflistet

Was du siehst	Wahrscheinliche Ursache	Was zu tun ist
`/mcp` listet skillry nicht auf	Es wurde im lokalen Geltungsbereich in einem anderen Ordner hinzugefügt, oder die Sitzung lief schon, bevor du es hinzugefügt hast	Führe `claude mcp get skillry` aus. Steht dort `Scope: Local config`, entferne es und füge es erneut mit `--scope user` hinzu. Steht dort User-Geltungsbereich, starte eine neue Sitzung.
`claude mcp add` gibt „was not saved“ aus	Claude Code konnte `~/.claude.json` nicht schreiben	Schließe andere Claude-Code-Sitzungen, prüfe, ob die Datei nicht schreibgeschützt ist, und führe den Befehl erneut aus.
Auf deinem Mac verbunden, auf deinem Windows-PC fehlgeschlagen	Der Windows-Eintrag startet `npx` ohne `cmd /c`	Führe `claude mcp remove skillry -s user` aus und füge dann den Windows-Befehl von dieser Seite hinzu.
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
Entferne den Server aus deiner Benutzerkonfiguration:
Terminal
```
claude mcp remove skillry -s user
```
Das solltest du sehen: Removed MCP server skillry from user config.
2
Um den Server zu behalten, ihn aber für ein Projekt abzuschalten, schalte ihn in /mcp um; Claude Code merkt sich das pro Projekt.

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
Konfigurationsdatei (User- und Local-Geltungsbereich)	`~/.claude.json`	`%USERPROFILE%\.claude.json`
Startbefehl	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Prüfen	`claude mcp get skillry`	gleich
Entfernen	`claude mcp remove skillry -s user`	gleich

Der Eintrag, den Claude Code speichert (macOS)

{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

Vorrang der Geltungsbereiche, Projektfreigabe und alle weiteren Optionen stehen in der offiziellen MCP-Dokumentation.

Häufige Fragen

Muss ich den Befehl in jedem Projekt ausführen?

Nein. --scope user macht Skillry in allen deinen Projekten verfügbar. Der Standard-Geltungsbereich Local würde es an den Ordner binden, in dem du den Befehl ausgeführt hast.

Braucht Claude Code einen Neustart?

Eine neue Sitzung übernimmt den Server. In einer offenen Sitzung zeigt /mcp ihn nach der Zustandsprüfung.

Kann mein Team den Eintrag teilen?

Ja. --scope project schreibt ihn in .mcp.json im Repository, und jedes Teammitglied bestätigt ihn, wenn es Claude Code dort zum ersten Mal öffnet.

Quellen

War diese Anleitung hilfreich?

ZurückÜbersicht WeiterCodex