在 Claude Code 裡連接 Skillry MCP（macOS 與 Windows）

簡短回答

1在任何終端機執行一次 claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp。不加 --scope user 的話，伺服器只存在於你執行指令的那個資料夾。
2用 claude mcp get skillry 確認。狀態行應該顯示 ✔ Connected。
3項目存在 ~/.claude.json（Windows：%USERPROFILE%\.claude.json）。你也可以手動把 JSON 貼進去。

開始之前

2026 年 10 月 28 日在 macOS 的 Claude Code 2.1.296 上實測。Windows 指令按官方文件撰寫，尚未在實際機器上執行。

Claude Code 已安裝並登入。claude --version 應該印出 2.x 版號。
Node.js 22 或更新版（node --version）。Claude Code 用 Node 附帶的 npx 啟動伺服器。
不用從 Skillry 下載任何東西：伺服器第一次啟動時 npx 會抓套件。

Claude Code 把伺服器存在三種範圍之一。這篇用 user 範圍，讓每個專案都有 Skillry。

範圍	旗標	存在哪	什麼時候用
User	`--scope user`	`~/.claude.json` 最上層	你想在每個專案都用 Skillry。本篇。
Local（預設）	無	`~/.claude.json` 裡目前專案路徑之下	你只想在這個資料夾用。
Project	`--scope project`	存放庫裡的 `.mcp.json`	你想讓隊友從存放庫拿到它。每個人第一次執行時各自核准。

把 Skillry 加進 Claude Code

最快。任何 shell 都行，包括 PowerShell 和命令提示字元

1
在任何資料夾打開終端機，執行：
macOS
```
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp
```
你應該會看到： Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config，接著 File modified: ~/.claude.json。
2
Windows 上改執行這一條。cmd /c 這層包裝讓 Windows 能啟動 npx，因為它是指令碼而不是程式。
Windows（PowerShell 或命令提示字元）
```
claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
開一個新的 Claude Code 工作階段，或在已開啟的工作階段裡輸入 /mcp。
你應該會看到： /mcp 清單裡有 skillry。選它可以看到 12 個工具。

想自己管理檔案時

1
用編輯器打開 ~/.claude.json。Windows 上檔案是 %USERPROFILE%\.claude.json。Claude Code 第一次執行時會建立它。
2
把這段合併進最上層的 mcpServers 物件，保留已有的伺服器。
macOS
```
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}
```
最上層指的是和檔案根層其他鍵並列的位置。放在專案路徑下的項目只會在那個專案載入。

Windows 上改用這個項目。

Windows

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

4
儲存檔案，開一個新工作階段。
你應該會看到： /mcp 清單裡有 skillry。

檢查 Claude Code 是否已連線

1
在終端機執行：
終端機
```
claude mcp get skillry
```
你應該會看到： Scope: User config (available in all your projects)、Status: ✔ Connected，以及你加的 npx 指令。
2
想一次看所有伺服器和健康狀態，執行 claude mcp list。在工作階段裡，/mcp 顯示同一份清單，還能打開某個伺服器的工具。

第一次檢查會啟動伺服器，第一次啟動會下載 skillry-cli。給它十秒以上。之後還一直是 ✘ Failed to connect，就表示缺 Node 或 npx；見下文。

試試第一次搜尋

搜尋不需要帳號，所以這是驗證連線最快的辦法。

1
在 Claude Code 裡開一個新對話，把這段話貼進去。
給 Agent 的提示詞
```
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.
```
你應該會看到： 三個候選 Skill，每個都帶預覽連結、需要的輸入、相依項目和外部費用。什麼都沒有被安裝。
2
Agent 要是回答它沒有 Skillry 工具，或者請求一直卡著，去看不能用怎麼辦。

安裝時授權

安裝會核對你的 Skillry 帳號。你不用在 Agent 裡輸入密碼、貼金鑰：第一次安裝時它會在瀏覽器裡打開一個頁面，你在那裡核准一次就行。

1
請 Claude Code 安裝你選中的 Skill，比如說 裝到這個專案裡。
你應該會看到： Agent 說需要連接你的帳號，並打開瀏覽器。終端機類客戶端可能只印出連結，自己點開就行。
2
核對頁面上的裝置代碼和 Agent 顯示的一致，按提示登入 Skillry，然後點 Approve。
你應該會看到： Authorization approved，並提示你回到 Agent。幾秒內 Agent 會察覺到並完成安裝。

一次核准管 7 天，存在系統的鑰匙圈裡（macOS 的 Keychain，Windows 的憑證管理員）。到期後 Agent 會再請你核准一次。想提前登出，請 Agent 中斷你的 Skillry 帳號連線即可。

/mcp 沒列出 Skillry 時

你看到的現象	可能原因	解法
`/mcp` 沒列出 skillry	它在別的資料夾以本機範圍加入，或者工作階段在你加入之前就開了	執行 `claude mcp get skillry`。顯示 `Scope: Local config` 就移除後用 `--scope user` 重加；顯示 user 範圍就開新工作階段。
`claude mcp add` 印出「was not saved」	Claude Code 無法寫入 `~/.claude.json`	關掉其他 Claude Code 工作階段，確認檔案不是唯讀，再執行一次指令。
Mac 上連得上，Windows PC 上失敗	Windows 項目啟動 `npx` 時沒加 `cmd /c`	執行 `claude mcp remove skillry -s user`，然後加上這個頁面的 Windows 指令。
伺服器在清單裡，但顯示失敗，或者一直沒啟動	沒裝 `npx`，Node.js 版本低於 22，或者第一次啟動下載套件時逾時	在終端機執行 `node --version` 和 `npx --version`。然後手動執行一次 `npx --yes skillry-cli@latest mcp`，等它啟動後按 Ctrl+C，再試一次客戶端：套件已經快取好了。
Windows 上伺服器一啟動就退出	項目直接啟動 `npx`，但 Windows 需要一個 shell 才能執行它	用這個頁面的 Windows 項目：指令是 `cmd`，參數以 `/c`、`npx` 開頭。
瀏覽器頁面說請求無效或已過期	裝置代碼核准得太晚，或者是上一次嘗試留下的	請 Agent 重新連線，並在幾分鐘內核准新的代碼。
安裝停在 Premium 或購買提示	這個 Skill 是 Premium，而你的帳號既沒有方案也沒買過它	點 Agent 給的連結購買 Skill 或訂閱，然後再問一次。在你動手前不會扣任何費用。

移除或中斷連線

1
從使用者設定移除伺服器：
終端機
```
claude mcp remove skillry -s user
```
你應該會看到： Removed MCP server skillry from user config。
2
想保留伺服器但在某個專案關掉它，在 /mcp 裡切換；Claude Code 會按專案記住。

移除項目不會讓你登出 Skillry。要連已存的核准一起撤銷，先請 Agent 中斷你的 Skillry 帳號連線，或者移除項目後等核准 7 天後自動過期。

參考

項目	macOS	Windows
設定檔（user 和 local 範圍）	`~/.claude.json`	`%USERPROFILE%\.claude.json`
啟動指令	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
檢查	`claude mcp get skillry`	相同
移除	`claude mcp remove skillry -s user`	相同

Claude Code 存的項目（macOS）

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

範圍優先順序、專案核准和其他所有選項都在官方 MCP 文件。

常見問題

每個專案都要執行一次指令嗎？

不用。--scope user 讓 Skillry 在你所有專案都可用。預設的本機範圍會把它綁在你執行指令的那個資料夾。

Claude Code 需要重新啟動嗎？

開新工作階段就會載入伺服器。在已開啟的工作階段裡，健康檢查後 /mcp 就會顯示它。

團隊能共用這個項目嗎？

可以。--scope project 把它寫進存放庫的 .mcp.json，每位隊友第一次在那裡開 Claude Code 時核准一次。

參考來源

這篇指南對你有幫助嗎？