先说结论
- 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 给的链接单买或订阅,再让它装一次。你不点,就不会扣费。 |
移除或断开
移除扩展时,在 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 那一页加进去。
参考来源
这篇对你有帮助吗?
