US$9.99/月,访问全部 Premium Skills,随时取消。立即升级

在 Claude Desktop 里连接 Skillry MCP

下载 Skillry .mcpb,在 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension… 中选择该文件。安装后在 + → Connectors 中确认工具。

适合
Claude Desktop 用户
用时
4 分钟做完
核对
Claude Desktop 4.4212,2026 年 10 月 30 日

先说结论

  1. 1下载 Skillry .mcpb,在 Settings → Desktop app → Extensions → Manage → Advanced settings → Install Extension… 中选择该文件。安装后在 + → Connectors 中确认工具。
  2. 2如果之前手动添加过 Skillry,启用扩展前只删除 claude_desktop_config.json 中的 skillry 条目,保留其他服务器。下载完成不代表已连接。
  3. 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. 1

    在 Claude Desktop 的菜单里选 帮助 → 故障排查 → 启用开发者模式…,再点 启用。如果已经能看到 开发者 菜单,跳过这一步。

    正常的话你会看到: 菜单栏里多了一个 开发者 菜单。

  2. 2

    选 开发者 → 打开应用配置文件。

    正常的话你会看到: claude_desktop_config.json 在默认编辑器里打开。文件不存在的话 Claude Desktop 会创建它。

  3. 3

    把这段合并进 mcpServers 对象,保留已有的其他服务器。文件里还没有 mcpServers 的话,照下面整段加上。

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

    Windows 上改用这段。

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

    保存文件,然后选 开发者 → 重新加载 MCP 配置。

    正常的话你会看到: Connectors 里有 skillry,见下一节。

    如果 Skillry 没出现,完全退出 Claude Desktop 再打开:macOS 上从 Claude 菜单退出(⌘Q),Windows 上从托盘图标退出。

确认 Claude Desktop 已连接

  1. 1

    在对话里点输入框里的 +,再点 Connectors。

    正常的话你会看到: 列表里有 skillry 和它的工具,第一个是 search_skills。

  2. 2

    要看它的状态:打开 Settings → Desktop app,点 Extensions 旁边的 Manage,在 Local MCP servers 下查看(旧版设置布局:Settings → Developer)。开发者 → 打开 MCP 日志文件 会打开日志。

安装时授权

安装会核对你的 Skillry 账户。你不用在 Agent 里输密码、贴 key:第一次安装时它会在浏览器里打开一个页面,你在那里批准一次就行。

  1. 1

    让 Claude 安装你选中的 Skill,比如说 装到这个项目里。

    正常的话你会看到: Agent 说需要连接你的账户,并打开浏览器。终端类客户端可能只打印链接,自己点开就行。

  2. 2

    核对页面上的设备码和 Agent 显示的一致,按提示登录 Skillry,然后点 Approve。

    正常的话你会看到: Authorization approved,并提示你回到 Agent。几秒内 Agent 会察觉到并完成安装。

一次批准管 7 天,存在系统的钥匙串里(macOS 的 Keychain,Windows 的凭据管理器)。到期后 Agent 会再请你批准一次。想提前退出,让 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 给的链接单买或订阅,再让它装一次。你不点,就不会扣费。

移除或断开

移除扩展时,在 Extensions 中停用或卸载 Skillry;手动配置则只删除 skillry 条目。

  1. 1

    从 claude_desktop_config.json 删掉 skillry 条目,保存,然后选 开发者 → 重新加载 MCP 配置。

    正常的话你会看到: Connectors 里没有 skillry 了。

删掉配置并不会让你退出 Skillry。想把已存的授权也撤掉,先让 Agent 断开你的 Skillry 账户,或者删掉配置后等授权 7 天自动过期。

参考

项目macOSWindows
配置文件~/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 mcpcmd /c npx --yes skillry-cli@latest mcp
检查+ → Connectors相同
Claude Desktop 保存的条目(macOS)
{
  "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 那一页加进去。

参考来源

这篇对你有帮助吗?