簡短回答
- 1VS Code 裡要啟用 GitHub Copilot(免費方案就夠)。沒有它就不會出現 MCP 指令。
- 2最快:在 skillry.dev/mcp 點 Add to VS Code,或在終端機敲一條
code --add-mcp。 - 3在 Command Palette 用 MCP: List Servers 確認:
skillry應該在執行中。
開始之前
code --add-mcp 這條路線於 2026 年 10 月 28 日在 macOS 的 VS Code 1.141 上實測。其他路線按官方文件撰寫,尚未在實際安裝上執行。
- VS Code 已登入 GitHub Copilot 並啟用 AI 功能。Copilot 免費方案就夠。
- Node.js 22 或更新版(
node --version)。VS Code 用npx啟動伺服器。 - VS Code 有兩種檔案格式:自己的
mcp.json(鍵是servers),以及可攜的 Copilot 檔案~/.copilot/mcp-config.json(鍵是mcpServers)。兩種都能用;這一頁會告訉你每條路線寫的是哪一個。
| 路線 | 寫入 | 適合 |
|---|---|---|
| Add to VS Code 連結 | 你的使用者設定檔 mcp.json | 你已經在 skillry.dev/mcp 上 |
| Command Palette 的 MCP: Add Server | ~/.copilot/mcp-config.json(Copilot Global) | 你偏好在 VS Code 裡點選 |
終端機的 code --add-mcp | 你的使用者設定檔 mcp.json | 你喜歡一條指令搞定 |
自己編輯 mcp.json | 你打開的那個檔案 | 你想看到項目本身 |
把 Skillry 加進 VS Code
- 1
打開 skillry.dev/mcp,選 VS Code 和你的作業系統,然後點 Add to VS Code。允許瀏覽器打開 VS Code。
- 2
VS Code 顯示伺服器名稱和指令並請你確認。點 Install。
你應該會看到: 項目出現在你的使用者
mcp.json裡,上方有 Start 動作。點它,或等第一次使用時伺服器自己啟動。
- 1
打開 Command Palette(macOS 按 ⇧⌘P,Windows 按 Ctrl+Shift+P),執行 MCP: Add Server。
- 2
選 Command (stdio),輸入啟動指令:macOS 是
npx --yes skillry-cli@latest mcp,Windows 是cmd /c npx --yes skillry-cli@latest mcp。 - 3
伺服器 ID 輸入
skillry。 - 4
選 Global,提示時再選 Copilot Global。這會寫入
~/.copilot/mcp-config.json。你應該會看到: 針對新伺服器的信任提示。接受它,VS Code 才能啟動。
- 1
在終端機執行。Windows 上用 PowerShell,單引號照寫就能用。
macOS code --add-mcp '{"name":"skillry","type":"stdio","command":"npx","args":["--yes","skillry-cli@latest","mcp"]}'你應該會看到:
Added MCP servers: skillry。VS Code 會打開或跳到最前面。 - 2
Windows 上改執行這一條,讓 Windows 能啟動
npx:Windows(PowerShell) code --add-mcp '{"name":"skillry","type":"stdio","command":"cmd","args":["/c","npx","--yes","skillry-cli@latest","mcp"]}'
- 1
從 Command Palette 執行 MCP: Open User Configuration。它會打開你的使用者設定檔
mcp.json,沒有就建一個。 - 2
把這段合併進
servers物件,保留已有的伺服器。macOS { "servers": { "skillry": { "type": "stdio", "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows 上改用這個項目。
Windows { "servers": { "skillry": { "type": "stdio", "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
儲存。VS Code 在項目上方顯示 Start;點它。
你應該會看到: MCP: List Servers 裡伺服器在執行中。
檢查 VS Code 是否已連線
- 1
從 Command Palette 執行 MCP: List Servers,選
skillry。你應該會看到: 執行中的伺服器,帶有 Stop、Restart、Show Output 等動作。如果是停止狀態,點 Start。
- 2
打開 Chat,切到 Agent 模式,打開工具選擇器。
你應該會看到: 以
search_skills開頭的 Skillry 工具可以勾選。
試試第一次搜尋
搜尋不需要帳號,所以這是驗證連線最快的辦法。
- 1
在 Copilot Chat 的 Agent 模式 裡開一個新對話,把這段話貼進去。
給 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 工具,或者請求一直卡著,去看不能用怎麼辦。
VS Code 看不到 Skillry 時
| 你看到的現象 | 可能原因 | 解法 |
|---|---|---|
| Command Palette 裡沒有 MCP: Add Server | Copilot 沒登入或 AI 功能被停用 | 登入 GitHub 並啟用 Copilot。Chat 可用後 MCP 指令就會出現。 |
| 伺服器在清單裡但是停止狀態,或顯示錯誤 | 它從未被啟動,或 npx 失敗 | 在 MCP: List Servers 點 Start,再點 Show Output 看錯誤。找不到 npx 表示 VS Code 用的 shell 裡沒裝 Node.js。 |
| Chat 裡一直沒出現工具 | Chat 不在 Agent 模式,或工具沒勾選 | 切到 Agent 模式,打開工具選擇器,勾選 Skillry 的工具。 |
| 伺服器在清單裡,但顯示失敗,或者一直沒啟動 | 沒裝 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
執行 MCP: List Servers,選
skillry,再點 Uninstall;或從存放它的檔案裡刪掉項目。你應該會看到: 清單裡不再有
skillry。
移除項目不會讓你登出 Skillry。要連已存的核准一起撤銷,先請 Agent 中斷你的 Skillry 帳號連線,或者移除項目後等核准 7 天後自動過期。
參考
| 檔案 | macOS | Windows |
|---|---|---|
使用者設定檔 mcp.json(servers 鍵) | ~/Library/Application Support/Code/User/mcp.json | %APPDATA%\Code\User\mcp.json |
Copilot 檔案(mcpServers 鍵) | ~/.copilot/mcp-config.json | %USERPROFILE%\.copilot\mcp-config.json |
| 工作區檔案 | 專案裡的 .vscode/mcp.json | 相同 |
| 啟動指令 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
{
"servers": {
"skillry": {
"type": "stdio",
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}每個欄位、安裝 URL 格式和兩種檔案格式都在 MCP 設定參考。
常見問題
需要 Copilot 嗎?
需要。VS Code 的 MCP 支援在 Copilot Chat 的 Agent 模式裡。Copilot 免費方案就夠。
該用哪個檔案?
任何一個都行。連結和 code --add-mcp 寫使用者設定檔 mcp.json;MCP: Add Server 寫 Copilot 檔案。不要兩邊都加 Skillry。
能和團隊共用嗎?
把項目放進存放庫的 .vscode/mcp.json(servers 格式)。隊友在 VS Code 第一次啟動它時會看到信任提示。
參考來源
這篇指南對你有幫助嗎?
