簡短回答
- 1在 skillry.dev/mcp 選 Cursor,點 Add to Cursor,然後在 Cursor 裡確認伺服器。
- 2或者把
skillry項目合併進~/.cursor/mcp.json(每個專案)或.cursor/mcp.json(單一專案)。 - 3在 Cursor 的 Customize 頁檢查:
skillry應該是開著的,並列出它的工具。
開始之前
以上步驟於 2026 年 10 月 28 日按官方文件核對,尚未在這個客戶端的實際安裝上實測。要是你電腦上有哪一步不一樣,用頁尾的 回報問題 告訴我們。
- Cursor 已安裝並登入。
- Node.js 22 或更新版(
node --version)。Cursor 用npx啟動伺服器。
| 檔案 | 適用範圍 | 什麼時候用 |
|---|---|---|
~/.cursor/mcp.json | 這台電腦上的每個專案 | 你想到處都能用 Skillry。本篇。 |
專案裡的 .cursor/mcp.json | 只有那個專案 | 你想透過存放庫和團隊共用。 |
把 Skillry 加進 Cursor
- 1
打開 skillry.dev/mcp,選 Cursor 和你的作業系統。
- 2
點 Add to Cursor。瀏覽器會問要不要打開 Cursor;允許它。
- 3
在 Cursor 裡檢視名為
skillry的伺服器和它的npx指令,然後確認。你應該會看到: Customize 頁的 MCP 清單裡有
skillry。Cursor 打開了不等於 Skillry 已連線。去 Customize 頁檢查,或執行下面的第一次搜尋。
- 1
建立或打開
~/.cursor/mcp.json。只給一個專案用的話,改用該專案裡的.cursor/mcp.json。 - 2
把這段合併進
mcpServers物件,保留已有的伺服器。macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows 上改用這個項目。
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
儲存檔案。Cursor 會自動抓到變更;伺服器沒出現就重新啟動 Cursor。
你應該會看到: Customize 頁的 MCP 清單裡有
skillry。
檢查 Cursor 是否已連線
- 1
從側欄打開 Customize,在 MCP 伺服器裡找到
skillry。你應該會看到: 伺服器是開著的、狀態正常,並列出工具,第一個是
search_skills。 - 2
顯示錯誤的話,點它看日誌;第一次啟動要下載套件,可能要十秒以上。
試試第一次搜尋
搜尋不需要帳號,所以這是驗證連線最快的辦法。
- 1
在 Cursor 的 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 工具,或者請求一直卡著,去看不能用怎麼辦。
Cursor 看不到 Skillry 時
| 你看到的現象 | 可能原因 | 解法 |
|---|---|---|
Customize 頁上沒有 skillry | 檔案放錯位置,或 JSON 無效 | 檢查路徑(每個專案用的是 ~/.cursor/mcp.json)並驗證 JSON:沒有多餘的結尾逗號,skillry 在 mcpServers 裡面。 |
| Add to Cursor 連結沒反應 | 瀏覽器封鎖了 cursor:// 連結 | 允許瀏覽器打開 Cursor,或改用 編輯 mcp.json 分頁。 |
| 伺服器是關閉狀態 | 在 Customize 頁被關掉了 | 把它打開;不管開關,Cursor 都會保留項目。 |
| 伺服器在清單裡,但顯示失敗,或者一直沒啟動 | 沒裝 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
在 Customize 頁移除
skillry,或從mcp.json刪掉它的項目。想保留但不載入,就在那裡把它關掉。你應該會看到: MCP 清單裡不再有
skillry。
移除項目不會讓你登出 Skillry。要連已存的核准一起撤銷,先請 Agent 中斷你的 Skillry 帳號連線,或者移除項目後等核准 7 天後自動過期。
參考
| 項目 | macOS | Windows |
|---|---|---|
| 全域設定檔 | ~/.cursor/mcp.json | %USERPROFILE%\.cursor\mcp.json |
| 專案設定檔 | .cursor/mcp.json | 相同 |
| 啟動指令 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 檢查 | Customize 頁 | 相同 |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}Add to Cursor 連結是 cursor://anysphere.cursor-deeplink/mcp/install?name=skillry&config=…,其中 config 就是同一個項目的 base64 編碼。Cursor 會解碼並在儲存前讓你看。細節見安裝連結文件。
常見問題
Add to Cursor 連結安全嗎?
它只帶伺服器名稱和啟動指令,用 base64 編碼。Cursor 在你確認前會把兩者都顯示出來,你確認之前什麼都不會執行。
用全域檔案還是專案檔案?
自己用選全域(~/.cursor/mcp.json)。要讓團隊從存放庫拿到就選專案(.cursor/mcp.json)。
Cursor 需要重新啟動嗎?
通常不用:檔案變了 Customize 頁會自動更新。伺服器一直沒出現才重新啟動 Cursor。
參考來源
這篇指南對你有幫助嗎?
