월 US$9.99에 모든 Premium Skill을 이용하세요. 언제든지 취소할 수 있습니다.지금 업그레이드

Gemini CLI와 Antigravity에서 Skillry MCP 연결하기

Gemini CLI는 gemini mcp add로 서버를 등록합니다. Google의 Antigravity(CLI, 앱, IDE)는 대신 공유 mcp_config.json을 읽습니다. 2026년 6월 18일부터 무료 티어와 Google One 사용자는 Gemini CLI에서 Antigravity CLI로 옮겨지고 있으므로, 이 페이지는 둘 다 다룹니다.

대상
Gemini CLI와 Antigravity 사용자
소요 시간
완료까지 4분
확인
공식 문서, 2026년 10월 28일

짧은 답변

  1. 1Gemini CLI: gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp를 실행합니다. --scope user가 없으면 현재 프로젝트에만 적용됩니다.
  2. 2Antigravity: skillry 항목을 ~/.gemini/config/mcp_config.json에 병합하고, Antigravity CLI에서 /mcp를 입력합니다.
  3. 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 추가하기

아직 Gemini CLI를 쓸 때 가장 빠름
  1. 1

    아무 터미널에서 이것을 실행합니다. --가 Gemini 자체 옵션과 npx에 넘기는 인수를 구분합니다.

    macOS
    gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp

    다음이 보여야 합니다: 오류 없이 끝나고, gemini mcp list에 skillry가 포함됩니다.

  2. 2

    Windows에서는 Windows가 npx를 시작할 수 있도록 대신 이것을 실행합니다:

    Windows(PowerShell 또는 명령 프롬프트)
    gemini mcp add --scope user --transport stdio skillry cmd -- /c npx --yes skillry-cli@latest mcp
  3. 3

    새 Gemini CLI 세션을 시작합니다.

    다음이 보여야 합니다: /mcp 목록에 도구와 함께 skillry.

연결이 되는지 확인하기

  1. 1

    Gemini CLI: 설정된 서버 목록을 봅니다.

    터미널
    gemini mcp list

    다음이 보여야 합니다: 명령과 연결된 상태가 함께 표시된 skillry.

  2. 2

    두 도구 모두: 세션에서 /mcp를 입력합니다.

    다음이 보여야 합니다: search_skills로 시작하는 도구와 함께 skillry.

설치할 때 승인하기

설치할 때 Skillry 계정을 확인합니다. 에이전트에 비밀번호를 입력하거나 키를 붙여 넣지 않습니다. 처음 한 번 브라우저에 페이지가 열리고, 거기서 승인합니다.

  1. 1

    에이전트에게 선택한 Skill을 설치해 달라고 요청합니다. 예: 이 프로젝트에 설치해 줘.

    다음이 보여야 합니다: 에이전트가 계정 연결이 필요하다고 알리고 브라우저를 엽니다. 터미널 클라이언트에서는 링크만 출력될 수 있으니 직접 열어 주세요.

  2. 2

    페이지의 기기 코드가 에이전트에 표시된 것과 같은지 확인하고, 요청받으면 Skillry에 로그인한 뒤 Approve를 선택합니다.

    다음이 보여야 합니다: Authorization approved와 에이전트로 돌아가라는 안내. 에이전트가 몇 초 안에 이를 감지하고 설치를 끝냅니다.

승인은 7일 동안 유효하며 운영체제의 키링(macOS는 키체인, Windows는 자격 증명 관리자)에 저장됩니다. 만료되면 에이전트가 다시 승인을 요청할 뿐입니다. 더 일찍 로그아웃하려면 에이전트에게 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. 1

    Gemini CLI: 사용자 설정에서 서버를 제거합니다.

    터미널
    gemini mcp remove -s user skillry
  2. 2

    Antigravity: mcp_config.json에서 skillry 항목을 삭제하고 새로 고칩니다. 유지하되 로드되지 않게 하려면 항목에 "disabled": true를 설정합니다.

항목을 제거해도 Skillry에서 로그아웃되지는 않습니다. 저장된 승인까지 취소하려면 먼저 에이전트에게 Skillry 계정 연결 해제를 요청하거나, 항목을 제거하고 7일 뒤 승인이 만료되도록 두세요.

레퍼런스

항목macOSWindows
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 mcpcmd /c npx --yes skillry-cli@latest mcp
확인gemini mcp list 또는 /mcp같음
두 도구가 저장하는 항목(macOS)
{
  "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을 읽습니다.

출처

이 가이드가 도움이 되었나요?