先说结论
- 1给客户端加一条配置。它会启动
npx --yes skillry-cli@latest mcp(Windows 上是cmd /c npx …):不用手动下载什么,也不需要 API key。 - 2搜索不用账户。第一次安装时,Agent 会打开浏览器页面让你批准一次;授权存在系统钥匙串里,管 7 天。
- 3在下面选你的客户端看具体步骤。每一页末尾都有怎么确认连上了、连不上该查哪里。
需要准备什么
- 一台 Mac 或 Windows 电脑。Linux 暂不支持:授权存在系统钥匙串里,Skillry 目前只支持 Keychain 和凭据管理器。
- Node.js 22 或更新。用
node --version查;没有这个命令就去 nodejs.org 装 LTS 版。 - 下面六个客户端之一,已登录、已更新。
- Skillry 账户只在安装时才需要。搜索和看 Skill 详情什么都不用。免费账户能装免费 Skill;Premium Skill 需要单买或套餐。
选你的客户端
按顺序会发生什么
你把 Skillry 加进客户端
客户端第一次需要时用 npx 启动本地服务。第一次启动要下载包,可能要十几秒;之后都是秒开。
你说想做什么
Agent 调用 search_skills,列出候选,带预览链接、输入、依赖和外部费用。不需要账户。
你选一个,说"装"
Agent 调用 get_skill_access。账户还没连上的话,它会打开下面说的浏览器页面。
你在浏览器里批准
Agent 把 Skill 装进你指定的 Agent 和范围。安装不会运行 Skill;你之后让它跑,它才跑。
试一次搜索
搜索不需要账户,所以这是验证连接最快的办法。
- 1
在 你的 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 工具,或者请求一直卡着,去看不好使怎么办。
Agent 看不到 Skillry 怎么办
先看你那个客户端的页面,那里有它自己的检查方法。下面这些问题每个客户端都可能遇到:
| 你看到的现象 | 可能的原因 | 怎么办 |
|---|---|---|
| Agent 说它没有 Skillry 工具 | 配置加在了别的项目或作用域,或者改完没重启客户端 | 按你的客户端页面里的方法检查。没列出来就按 user 作用域重新加;列出来了就重启或重新加载客户端。 |
| 搜索能用,安装却被拒绝,提示每日限额 | 账户今天的 50 次 Skill 载入用完了 | 每天 00:00 UTC 重置。这期间搜索照常可用。 |
| 服务器列出来了,但显示失败,或者一直起不来 | 没装 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 给的链接单买或订阅,再让它装一次。你不点,就不会扣费。 |
限额与边界
每天 50 次
每个账户的 Skill 载入次数,MCP、Skillry CLI 和网站共享。搜索不计入。
7 天
一次浏览器批准的有效期。到期后 Agent 会再问你一次。
无需 API key
什么都不用贴。授权由操作系统保存,不经 Agent 的手。
12 个工具
搜索、查看、安装、更新和账户工具。每个参数都在参考页里。
- 安装只是把文件放进 Agent 的 Skills 目录。Skillry 不运行 Skill,也不替你付模型费用:需要图片或视频模型的 Skill 用你自己的工具或 key,Agent 会在你选之前把费用说清楚。
- 服务跑在你电脑上,只为目录、权限检查和下载访问 skillry.dev,并把目录和包内容当作不可信数据处理。
- 随时可以断开:让 Agent 断开你的 Skillry 账户,或者把配置从客户端里删掉。
全部工具,看参考页
Skillry MCP 工具参考列出了全部 12 个工具的参数、默认值、示例和出错后的恢复路径。连接本身用不到它,但"我能让 Agent 做什么"在那里有准确答案。
常见问题
需要 API key 吗?
不需要。搜索什么都不用;安装只需在浏览器里批准一次你的 Skillry 账户。唯一保存的密钥是系统钥匙串里那份 7 天有效的授权。
还能用老办法装 Skill 吗?
能。安装提示词、Skillry CLI 和 ZIP 下载都还在。见安装 Skill。
这个服务会把我的文件发到哪里去吗?
不会。它在本地运行,只为目录、权限检查和你要的那个 Skill 的下载访问 skillry.dev。
我该选哪个客户端?
选你平时使用的客户端。Claude Code、Codex 和 Gemini CLI 用终端命令;Cursor 和 VS Code 用安装链接;Claude Desktop 安装 Skillry .mcpb 扩展。
参考来源
这篇对你有帮助吗?
