先说结论
- 1VS Code 里要启用 GitHub Copilot(免费版就够)。没有它,MCP 相关命令不会出现。
- 2最快:在 skillry.dev/mcp 点 Add to VS Code,或者在终端跑一条
code --add-mcp。 - 3在命令面板跑 MCP: List Servers 确认:
skillry应该在运行中。
开始之前
code --add-mcp 这条路线于 2026 年 10 月 28 日在 macOS、VS Code 1.141 上实测通过。其他路线按官方文档核对,尚未在真实安装上跑过。
- VS Code 已登录 GitHub Copilot 并启用 AI 功能。Copilot 免费版就够。
- Node.js 22 或更新(
node --version)。VS Code 用npx启动服务。 - VS Code 有两种文件格式:自己的
mcp.json(键是servers),和可移植的 Copilot 文件~/.copilot/mcp-config.json(键是mcpServers)。两种都行;本页会告诉你每条路线写的是哪个。
| 路线 | 写到哪 | 适合 |
|---|---|---|
| Add to VS Code 链接 | 用户级 mcp.json | 你正好在 skillry.dev/mcp 上 |
| 命令面板里的 MCP: Add Server | ~/.copilot/mcp-config.json(Copilot Global) | 喜欢在 VS Code 里点着做 |
终端里的 code --add-mcp | 用户级 mcp.json | 喜欢一条命令 |
自己改 mcp.json | 你打开的那个文件 | 想亲眼看见条目 |
把 Skillry 加进 VS Code
- 1
打开 skillry.dev/mcp,选 VS Code 和你的操作系统,点 Add to VS Code。允许浏览器打开 VS Code。
- 2
VS Code 会显示服务器名和命令,请你确认。点 Install。
正常的话你会看到: 用户级
mcp.json里的条目,上方有一个 Start 按钮。点它,或者等第一次用到时自动启动。
- 1
打开命令面板(macOS ⇧⌘P,Windows Ctrl+Shift+P),运行 MCP: Add Server。
- 2
选 Command (stdio),输入启动命令:macOS 是
npx --yes skillry-cli@latest mcp,Windows 是cmd /c npx --yes skillry-cli@latest mcp。 - 3
服务器 ID 填
skillry。 - 4
选 Global,提示时再选 Copilot Global。这会写入
~/.copilot/mcp-config.json。正常的话你会看到: 新服务器的信任提示。接受后 VS Code 才会启动它。
- 1
在终端运行。Windows 上用 PowerShell,单引号可以原样使用。
macOS code --add-mcp '{"name":"skillry","type":"stdio","command":"npx","args":["--yes","skillry-cli@latest","mcp"]}'正常的话你会看到:
Added MCP servers: skillry。VS Code 会打开或跳到前台。 - 2
Windows 上改跑这条,让 Windows 能启动
npx:Windows(PowerShell) code --add-mcp '{"name":"skillry","type":"stdio","command":"cmd","args":["/c","npx","--yes","skillry-cli@latest","mcp"]}'
- 1
在命令面板运行 MCP: Open User Configuration。它会打开用户级
mcp.json,没有就创建。 - 2
把这段合并进
servers对象,保留已有的其他服务器。macOS { "servers": { "skillry": { "type": "stdio", "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows 上改用这段。
Windows { "servers": { "skillry": { "type": "stdio", "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
保存。VS Code 会在条目上方显示 Start,点它。
正常的话你会看到: MCP: List Servers 里服务器在运行。
确认 VS Code 已连接
- 1
在命令面板运行 MCP: List Servers,选
skillry。正常的话你会看到: 一个运行中的服务器,带 Stop、Restart、Show Output 等操作。停着的话点 Start。
- 2
打开 Chat,切到 Agent 模式,打开工具选择器。
正常的话你会看到: 可以勾选的 Skillry 工具,第一个是
search_skills。
试一次搜索
搜索不需要账户,所以这是验证连接最快的办法。
- 1
在 Copilot Chat 的 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 工具,或者请求一直卡着,去看不好使怎么办。
VS Code 看不到 Skillry 怎么办
| 你看到的现象 | 可能的原因 | 怎么办 |
|---|---|---|
| 命令面板里没有 MCP: Add Server | Copilot 没登录,或者 AI 功能被关了 | 登录 GitHub 并启用 Copilot。Chat 可用后 MCP 命令就会出现。 |
| 服务器列出来了但停着,或者显示错误 | 从来没启动过,或者 npx 失败了 | 在 MCP: List Servers 里点 Start,再点 Show Output 看报错。提示找不到 npx,说明 VS Code 用的那个 shell 里没有 Node.js。 |
| Chat 里一直没有这些工具 | Chat 不在 Agent 模式,或者工具没勾上 | 切到 Agent 模式,打开工具选择器,勾上 Skillry 的工具。 |
| 服务器列出来了,但显示失败,或者一直起不来 | 没装 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
运行 MCP: List Servers,选
skillry,再选 Uninstall;或者从保存它的那个文件里删掉条目。正常的话你会看到: 列表里没有
skillry了。
删掉配置并不会让你退出 Skillry。想把已存的授权也撤掉,先让 Agent 断开你的 Skillry 账户,或者删掉配置后等授权 7 天自动过期。
参考
| 文件 | macOS | Windows |
|---|---|---|
用户级 mcp.json(键是 servers) | ~/Library/Application Support/Code/User/mcp.json | %APPDATA%\Code\User\mcp.json |
Copilot 文件(键是 mcpServers) | ~/.copilot/mcp-config.json | %USERPROFILE%\.copilot\mcp-config.json |
| 工作区文件 | 项目里的 .vscode/mcp.json | 相同 |
| 启动命令 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
{
"servers": {
"skillry": {
"type": "stdio",
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}每个字段、安装链接的格式和两种文件格式,见 MCP 配置参考。
常见问题
必须有 Copilot 吗?
是的。VS Code 的 MCP 支持在 Copilot Chat 的 Agent 模式里。Copilot 免费版就够。
该用哪个文件?
哪个都行。链接和 code --add-mcp 写用户级 mcp.json;MCP: Add Server 写 Copilot 文件。别把 Skillry 两边都加。
能和团队共享吗?
把条目写进仓库里的 .vscode/mcp.json(servers 格式)。同事第一次让 VS Code 启动它时会看到信任提示。
参考来源
这篇对你有帮助吗?
