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