在 Claude Code 里连接 Skillry MCP（macOS 与 Windows）

先说结论

1在任意终端跑一次 claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp。不加 --scope user 的话，服务只在你运行命令的那个目录里生效。
2用 claude mcp get skillry 确认，状态那行应该是 ✔ Connected。
3配置写在 ~/.claude.json（Windows：%USERPROFILE%\.claude.json）。你也可以手动把 JSON 贴进去。

开始之前

2026 年 10 月 28 日在 macOS、Claude Code 2.1.296 上实测通过。Windows 命令按官方文档核对，尚未在真机上跑过。

Claude Code 已安装、已登录。claude --version 应该打出 2.x 版本号。
Node.js 22 或更新（node --version）。Claude Code 用随 Node 附带的 npx 启动服务。
不用从 Skillry 下载任何东西：服务第一次启动时 npx 会自己拉取包。

Claude Code 把服务器存在三种作用域之一。本指南用 user 作用域，这样每个项目里都有 Skillry。

作用域	参数	存在哪	什么时候用
User	`--scope user`	`~/.claude.json` 顶层	想在每个项目里都用 Skillry。本指南就是这个。
Local（默认）	无	`~/.claude.json` 里当前项目路径下	只想在这个目录里用。
Project	`--scope project`	仓库里的 `.mcp.json`	想让同事从仓库里拿到。每个人第一次运行时都要批准一次。

把 Skillry 加进 Claude Code

最快。任何 shell 都行，包括 PowerShell 和命令提示符

1
在任意目录打开终端，运行：
macOS
```
claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp
```
正常的话你会看到： Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config，接着是 File modified: ~/.claude.json。
2
Windows 上改跑这条。cmd /c 这层包装是为了让 Windows 能启动 npx，它是个脚本而不是程序。
Windows（PowerShell 或命令提示符）
```
claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
```
3
开一个新的 Claude Code 会话，或者在已经开着的会话里输入 /mcp。
正常的话你会看到： /mcp 列表里有 skillry。选中它能看到 12 个工具。

想自己管理文件的话用这个

1
用编辑器打开 ~/.claude.json。Windows 上文件是 %USERPROFILE%\.claude.json。Claude Code 第一次运行时会创建它。
2
把这段合并进顶层的 mcpServers 对象，保留已有的其他服务器。
macOS
```
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}
```
顶层指的是文件根部、和其他键并列的位置。写在某个项目路径下面的条目只会在那个项目里加载。

Windows 上改用这段。

Windows

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

4
保存文件，开一个新会话。
正常的话你会看到： /mcp 列表里有 skillry。

确认 Claude Code 已连接

1
在终端运行：
终端
```
claude mcp get skillry
```
正常的话你会看到： Scope: User config (available in all your projects)、Status: ✔ Connected，以及你加的那条 npx 命令。
2
想一次看到所有服务器和健康状态，跑 claude mcp list。会话里输入 /mcp 是同一份列表，还能打开某个服务器的工具。

第一次检查会启动服务，而第一次启动要下载 skillry-cli。给它十几秒。之后还一直是 ✘ Failed to connect，说明 Node 或 npx 没装好，见下文。

试一次搜索

搜索不需要账户，所以这是验证连接最快的办法。

1
在 Claude Code 里开一个新对话，把这段话粘进去。
发给 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 工具，或者请求一直卡着，去看不好使怎么办。

安装时授权

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

1
让 Claude Code 安装你选中的 Skill，比如说 装到这个项目里。
正常的话你会看到： Agent 说需要连接你的账户，并打开浏览器。终端类客户端可能只打印链接，自己点开就行。
2
核对页面上的设备码和 Agent 显示的一致，按提示登录 Skillry，然后点 Approve。
正常的话你会看到： Authorization approved，并提示你回到 Agent。几秒内 Agent 会察觉到并完成安装。

一次批准管 7 天，存在系统的钥匙串里（macOS 的 Keychain，Windows 的凭据管理器）。到期后 Agent 会再请你批准一次。想提前退出，让 Agent 断开你的 Skillry 账户即可。

/mcp 里没有 Skillry 怎么办

你看到的现象	可能的原因	怎么办
`/mcp` 里没有 skillry	在别的目录用 local 作用域加的，或者会话在你添加之前就开着了	跑 `claude mcp get skillry`。显示 `Scope: Local config` 的话，删掉再用 `--scope user` 加一次；显示 user 作用域的话，开个新会话。
`claude mcp add` 打印 "was not saved"	Claude Code 写不了 `~/.claude.json`	关掉其他 Claude Code 会话，确认文件不是只读，再跑一次命令。
Mac 上连得上，Windows 电脑上失败	Windows 的配置没加 `cmd /c` 就直接启动了 `npx`	跑 `claude mcp remove skillry -s user`，再把本页的 Windows 命令加上。
服务器列出来了，但显示失败，或者一直起不来	没装 `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
从用户配置里移除服务器：
终端
```
claude mcp remove skillry -s user
```
正常的话你会看到： Removed MCP server skillry from user config。
2
想保留服务器但在某个项目里关掉它，在 /mcp 里切换开关；Claude Code 会按项目记住。

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

参考

项目	macOS	Windows
配置文件（user 和 local 作用域）	`~/.claude.json`	`%USERPROFILE%\.claude.json`
启动命令	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
检查	`claude mcp get skillry`	相同
移除	`claude mcp remove skillry -s user`	相同

Claude Code 保存的条目（macOS）

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

作用域优先级、项目级批准和其他所有选项，见 Claude Code MCP 官方文档。

常见问题

每个项目都要跑一遍命令吗？

不用。--scope user 让 Skillry 在你所有项目里可用。默认的 local 作用域才会把它绑在你运行命令的那个目录。

Claude Code 需要重启吗？

新会话会自动带上它。已经开着的会话里，/mcp 做完健康检查后就能看到。

能和团队共享这条配置吗？

能。--scope project 会把它写进仓库里的 .mcp.json，每位同事第一次在那里打开 Claude Code 时批准一次。

参考来源

这篇对你有帮助吗？