先说结论
- 1Gemini CLI:跑
gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp。不加--scope user只对当前项目生效。 - 2Antigravity:把
skillry条目合并进~/.gemini/config/mcp_config.json,然后在 Antigravity CLI 里输入/mcp。 - 3两个工具里,会话内的
/mcp都会列出服务器和它的工具。
开始之前
以上步骤于 2026 年 10 月 28 日按官方文档核对,尚未在这个客户端的真实安装上实测。要是你机器上有哪一步不一样,用页尾的 反馈问题 告诉我们。
- Gemini CLI(
gemini --version)或 Antigravity CLI(agy)已安装、已登录。gemini提示它已被替换的话,看 Antigravity 那个标签页。 - Node.js 22 或更新(
node --version)。
| 工具 | 配置文件 | 检查 |
|---|---|---|
| Gemini CLI | ~/.gemini/settings.json(用户)或 .gemini/settings.json(项目) | gemini mcp list 或 /mcp |
| Antigravity CLI、App 和 IDE | ~/.gemini/config/mcp_config.json(全局)或 .agents/mcp_config.json(工作区) | CLI 里 /mcp;App 里 Installed MCP Servers |
把 Skillry 加进 Gemini CLI 或 Antigravity
- 1
在任意终端运行。
--把 Gemini 自己的选项和传给npx的参数分开。macOS gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp正常的话你会看到: 没有报错,
gemini mcp list里多了skillry。 - 2
Windows 上改跑这条,让 Windows 能启动
npx:Windows(PowerShell 或命令提示符) gemini mcp add --scope user --transport stdio skillry cmd -- /c npx --yes skillry-cli@latest mcp - 3
开一个新的 Gemini CLI 会话。
正常的话你会看到:
/mcp列表里有skillry和它的工具。
- 1
打开
~/.gemini/settings.json(只给一个项目用的话,是项目里的.gemini/settings.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
保存,开一个新会话。
正常的话你会看到:
/mcp列表里有skillry。
- 1
打开或新建
~/.gemini/config/mcp_config.json。只给一个工作区用的话,改用它里面的.agents/mcp_config.json。 - 2
把这段合并进
mcpServers对象。格式和 Gemini CLI 的一样。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
Antigravity CLI 里输入
/mcp打开 MCP 管理面板并刷新。Antigravity App 里打开 Settings,再到 Customizations,找到 Installed MCP Servers,点 Refresh。正常的话你会看到: 列表里有
skillry和它的工具。
确认连接可用
- 1
Gemini CLI:列出已配置的服务器。
终端 gemini mcp list正常的话你会看到:
skillry、它的命令和已连接的状态。 - 2
两个工具都可以:在会话里输入
/mcp。正常的话你会看到:
skillry和它的工具,第一个是search_skills。
试一次搜索
搜索不需要账户,所以这是验证连接最快的办法。
- 1
在 Gemini CLI 或 Antigravity 里开一个新对话,把这段话粘进去。
发给 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 怎么办
| 你看到的现象 | 可能的原因 | 怎么办 |
|---|---|---|
换个目录 gemini mcp list 就是空的 | 服务器是按默认的 project 作用域加的 | 用 --scope user 重新加一次,或者把条目挪到 ~/.gemini/settings.json。 |
gemini 提示 CLI 已被替换 | 你的套餐已迁到 Antigravity CLI | 用 Antigravity 标签页。条目是同一段 JSON,只是文件不同。 |
| Antigravity 没读到文件 | JSON 有错,或者没刷新 | 检查 JSON,然后在 CLI 里 /mcp,或在 App 里点 Refresh。 |
| 服务器列出来了,但显示失败,或者一直起不来 | 没装 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
Gemini CLI:从用户设置里移除服务器。
终端 gemini mcp remove -s user skillry - 2
Antigravity:从
mcp_config.json删掉skillry条目并刷新。想保留但不加载,给条目加上"disabled": true。
删掉配置并不会让你退出 Skillry。想把已存的授权也撤掉,先让 Agent 断开你的 Skillry 账户,或者删掉配置后等授权 7 天自动过期。
参考
| 项目 | macOS | Windows |
|---|---|---|
| Gemini CLI 用户设置 | ~/.gemini/settings.json | %USERPROFILE%\.gemini\settings.json |
| Antigravity 全局配置 | ~/.gemini/config/mcp_config.json | %USERPROFILE%\.gemini\config\mcp_config.json |
| 启动命令 | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 检查 | gemini mcp list 或 /mcp | 相同 |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}Gemini CLI 的 --scope、--timeout 和 --trust 选项见 Gemini CLI MCP 文档;Antigravity 的文件格式和 App 里的 MCP 设置见 Antigravity MCP 文档。
常见问题
Gemini CLI 要没了吗?
Google 在 2026 年 6 月 18 日把免费层和 Google One 用户迁到了 Antigravity CLI;付费套餐仍可用 Gemini CLI。Skillry 的条目在两个工具里是同一段 JSON。
为什么要加 --scope user?
Gemini CLI 默认作用域是当前项目。user 作用域把条目写进 ~/.gemini/settings.json,每个目录都能用。
Antigravity 的 App 和 CLI 共用这条配置吗?
共用。App、CLI 和 IDE 读的都是 ~/.gemini/config/mcp_config.json。
参考来源
这篇对你有帮助吗?
