짧은 답변
- 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, 앱, IDE | ~/.gemini/config/mcp_config.json(전역) 또는 .agents/mcp_config.json(워크스페이스) | CLI에서는 /mcp, 앱에서는 Installed MCP Servers |
Gemini CLI 또는 Antigravity에 Skillry 추가하기
- 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 앱에서는 Settings, Customizations를 차례로 열고 Installed MCP Servers를 찾아 Refresh를 선택합니다.다음이 보여야 합니다: 도구와 함께
skillry가 나열됩니다.
연결이 되는지 확인하기
- 1
Gemini CLI: 설정된 서버 목록을 봅니다.
터미널 gemini mcp list다음이 보여야 합니다: 명령과 연결된 상태가 함께 표시된
skillry. - 2
두 도구 모두: 세션에서
/mcp를 입력합니다.다음이 보여야 합니다:
search_skills로 시작하는 도구와 함께skillry.
첫 검색 해 보기
검색에는 계정이 필요 없으므로, 연결이 되었는지 확인하는 가장 빠른 방법입니다.
- 1
Gemini CLI 또는 Antigravity에서 새 대화를 열고 이 요청을 붙여 넣습니다.
에이전트에게 보낼 프롬프트 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
에이전트가 Skillry 도구가 없다고 답하거나 요청이 멈춰 있으면 작동하지 않을 때로 가세요.
에이전트가 Skillry를 보지 못할 때
| 보이는 현상 | 예상 원인 | 해결 방법 |
|---|---|---|
다른 폴더에서 gemini mcp list가 비어 있음 | 서버가 기본 프로젝트 범위로 추가됨 | --scope user로 다시 추가하거나, 항목을 ~/.gemini/settings.json으로 옮깁니다. |
gemini가 CLI가 대체되었다고 말함 | 플랜이 Antigravity CLI로 옮겨짐 | Antigravity 탭을 사용합니다. 항목은 같은 JSON이고 파일만 다릅니다. |
| Antigravity가 파일을 읽지 않음 | 파일에 JSON 오류가 있거나 새로 고치지 않음 | JSON을 검증한 뒤 CLI에서는 /mcp, 앱에서는 Refresh를 실행합니다. |
| 서버가 목록에 있지만 실패로 표시되거나 아예 시작되지 않음 | npx가 설치되지 않았거나, Node.js가 22보다 오래되었거나, 첫 시작이 패키지 다운로드 중에 시간 초과됨 | 터미널에서 node --version과 npx --version을 실행합니다. 그다음 npx --yes skillry-cli@latest mcp를 직접 한 번 실행하고, 시작되면 Ctrl+C를 누른 뒤 클라이언트를 다시 시도합니다. 이제 패키지가 캐시에 있습니다. |
| Windows에서 서버가 시작되자마자 종료됨 | 항목이 npx를 직접 실행하는데, Windows는 실행에 셸이 필요함 | 이 페이지의 Windows 항목을 사용합니다. 명령은 cmd이고 인수는 /c, npx로 시작합니다. |
| 브라우저 페이지에 요청이 잘못되었거나 만료되었다고 표시됨 | 기기 코드를 너무 늦게 승인했거나, 이전 시도의 코드임 | 에이전트에게 다시 연결해 달라고 요청하고 새 코드를 몇 분 안에 승인합니다. |
| 설치가 Premium 또는 구매 메시지와 함께 멈춤 | Skill이 Premium이고 계정에 플랜도 구매 내역도 없음 | 에이전트가 보여 주는 링크로 Skill을 구매하거나 구독한 뒤 다시 요청합니다. 그전에는 아무것도 결제되지 않습니다. |
제거 또는 연결 해제
- 1
Gemini CLI: 사용자 설정에서 서버를 제거합니다.
터미널 gemini mcp remove -s user skillry - 2
Antigravity:
mcp_config.json에서skillry항목을 삭제하고 새로 고칩니다. 유지하되 로드되지 않게 하려면 항목에"disabled": true를 설정합니다.
항목을 제거해도 Skillry에서 로그아웃되지는 않습니다. 저장된 승인까지 취소하려면 먼저 에이전트에게 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의 파일 형식과 앱의 MCP 설정은 Antigravity MCP 문서에 있습니다.
자주 묻는 질문
Gemini CLI가 사라지나요?
Google은 2026년 6월 18일에 무료 티어와 Google One 사용자를 Antigravity CLI로 옮겼습니다. 유료 플랜은 Gemini CLI를 유지합니다. Skillry 항목은 두 도구에서 같은 JSON입니다.
왜 --scope user인가요?
Gemini CLI의 기본 범위는 현재 프로젝트입니다. 사용자 범위는 항목을 ~/.gemini/settings.json에 넣어 모든 폴더에서 작동하게 합니다.
Antigravity 앱과 CLI가 항목을 공유하나요?
예. 앱, CLI, IDE가 모두 ~/.gemini/config/mcp_config.json을 읽습니다.
출처
이 가이드가 도움이 되었나요?
