簡短回答
- 1下載 Skillry .mcpb,在 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension… 選取該檔案。安裝後在 + → Connectors 確認工具。
- 2若先前手動新增過 Skillry,啟用擴充功能前只刪除
claude_desktop_config.json中的 skillry 項目,保留其他伺服器。下載完成不代表已連線。 - 3擴充功能使用 Claude Desktop 內建的 Node.js 22+,無須另裝 Node.js。下方手動設定方式需要另裝 Node.js 22+ 和 npx。
安裝 Skillry 桌面擴充功能
下載 Skillry .mcpb,在 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension… 選取該檔案。安裝後在 + → Connectors 確認工具。
擴充功能使用 Claude Desktop 內建的 Node.js 22+,無須另裝 Node.js。下方手動設定方式需要另裝 Node.js 22+ 和 npx。
若先前手動新增過 Skillry,啟用擴充功能前只刪除 claude_desktop_config.json 中的 skillry 項目,保留其他伺服器。下載完成不代表已連線。
開始之前
選單名稱已於 2026 年 10 月 30 日依 Claude Desktop 4.4212 與 Claude 說明中心核對,完整流程尚未實測。如果你電腦上的步驟不同,請用頁面底部的 回報問題。
- macOS 或 Windows 上的 Claude Desktop,已更新:Claude 選單 → 檢查更新…。
- 擴充功能使用 Claude Desktop 內建的 Node.js 22+,無須另裝 Node.js。下方手動設定方式需要另裝 Node.js 22+ 和 npx。
下載 Skillry .mcpb,在 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension… 選取該檔案。安裝後在 + → Connectors 確認工具。
| 系統 | 設定檔 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
手動設定(備選)
- 1
在 Claude Desktop 的選單中選 說明 → 疑難排解 → 啟用開發人員模式…,再點 啟用。如果已經看得到 開發人員 選單,跳過這一步。
你應該會看到: 選單列多了一個 開發人員 選單。
- 2
選 開發人員 → 開啟應用程式設定檔。
你應該會看到:
claude_desktop_config.json會在預設編輯器中開啟。檔案不存在時 Claude Desktop 會建立它。 - 3
把這段合併進
mcpServers物件,保留既有的其他伺服器。檔案裡還沒有mcpServers的話,照下面整段加上。macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
Windows 上改用這段。
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 5
儲存檔案,然後選 開發人員 → 重新載入 MCP 設定。
你應該會看到: Connectors 裡有
skillry,見下一節。如果 Skillry 沒出現,請完全結束 Claude Desktop 再開啟:macOS 從 Claude 選單結束(⌘Q),Windows 從系統匣圖示結束。
檢查 Claude Desktop 是否已連線
- 1
在對話中點輸入框裡的 +,再點 Connectors。
你應該會看到: 清單裡有
skillry和它的工具,第一個是search_skills。 - 2
要看它的狀態:開啟 Settings → Desktop app,點 Extensions 旁的 Manage,在 Local MCP servers 底下查看(舊版設定版面:Settings → Developer)。開發人員 → 開啟 MCP 記錄檔 會開啟記錄。
試試第一次搜尋
搜尋不需要帳號,所以這是驗證連線最快的辦法。
- 1
在 Claude Desktop 裡開一個新對話,把這段話貼進去。
給 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 工具,或者請求一直卡著,去看不能用怎麼辦。
Claude Desktop 看不到 Skillry 時
| 你看到的現象 | 可能原因 | 解法 |
|---|---|---|
| 沒有 開發人員 選單 | 開發人員模式沒開 | 選 說明 → 疑難排解 → 啟用開發人員模式…。也可以照開始之前裡的路徑直接開啟檔案。 |
| 重新載入後 Connectors 裡什麼都沒有 | 檔案裡的 JSON 有錯,或 App 還沒重新載入 | 檢查 JSON(沒有多餘的逗號,skillry 在 mcpServers 裡面),選 開發人員 → 重新載入 MCP 設定,或結束後重新開啟 App。開發人員 → 開啟 MCP 記錄檔 會寫明問題。 |
| Windows:項目已在檔案裡,但 Skillry 一直不載入 | Windows 安裝程式以 MSIX 封裝 Claude Desktop,App 可能讀取另一份封裝副本 | 把同一段項目也合併進 %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json,然後結束再重新開啟 App。 |
mcp-server-skillry.log 說找不到 npx | Node.js 沒安裝,或 App 看不到它 | 到 nodejs.org 裝 LTS 版,然後結束並重新打開 Claude Desktop。 |
Windows:日誌裡的路徑出現 ${APPDATA} | App 的環境裡 npm 沒有全域安裝 | 在項目加 "env": { "APPDATA": "C:\\Users\\<你>\\AppData\\Roaming\\" },執行一次 npm install -g npm,再重新打開 App。 |
| 伺服器在清單裡,但顯示失敗,或者一直沒啟動 | 沒裝 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 或訂閱,然後再問一次。在你動手前不會扣任何費用。 |
移除或中斷連線
移除擴充功能時,在 Extensions 停用或解除安裝 Skillry;手動設定則只刪除 skillry 項目。
- 1
從
claude_desktop_config.json刪掉skillry項目,儲存,然後選 開發人員 → 重新載入 MCP 設定。你應該會看到: Connectors 裡沒有
skillry了。
移除項目不會讓你登出 Skillry。要連已存的核准一起撤銷,先請 Agent 中斷你的 Skillry 帳號連線,或者移除項目後等核准 7 天後自動過期。
參考
| 項目 | macOS | Windows |
|---|---|---|
| 設定檔 | ~/Library/Application Support/Claude/claude_desktop_config.json | %APPDATA%\Claude\claude_desktop_config.json |
| 開啟檔案 | 開發人員 → 開啟應用程式設定檔 | 相同 |
| 套用變更 | 開發人員 → 重新載入 MCP 設定 | 相同 |
| 日誌 | ~/Library/Logs/Claude/mcp*.log | %APPDATA%\Claude\logs |
| 啟動指令 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 檢查 | + → Connectors | 相同 |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}設定檔的格式見 Model Context Protocol 文件;那裡的截圖是舊版設定視窗,有現在已經沒有的 Edit Config 按鈕。
常見問題
有一鍵安裝嗎?
下載 Skillry .mcpb,在 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension… 選取該檔案。安裝後在 + → Connectors 確認工具。
Edit Config 去哪了?
現在的 Claude Desktop 先選 說明 → 疑難排解 → 啟用開發人員模式…,再從 開發人員 → 開啟應用程式設定檔 開啟這個檔案。
需要 Node.js 嗎?
擴充功能使用 Claude Desktop 內建的 Node.js 22+,無須另裝 Node.js。下方手動設定方式需要另裝 Node.js 22+ 和 npx。
同一個項目能用在 Claude Code 嗎?
JSON 一樣,但 Claude Code 讀的是 ~/.claude.json。照 Claude Code 頁面 加到那裡。
參考來源
這篇指南對你有幫助嗎?
