Gemini CLI에서 Antigravity CLI로: agy에 Blender MCP 연결하기

기준: Google Antigravity CLI(agy) 1.4.7(Windows), Antigravity 공식 문서(MCP, 시작하기, Gemini CLI에서 옮기기), Blender Lab MCP 애드온·서버 1.0.3. 2026년 10월에 확인했습니다. 그림은 모두 실제 화면입니다. 6·7절은 agy 1.4.7로 장면을 읽는 질문과 권한 규칙까지 직접 해 본 화면이고, 장면을 바꾸는 코드 실행은 시험하지 않았습니다.

2026년 6월 18일부터 무료 사용자와 Google One 사용자의 Gemini CLI는 Antigravity CLI로 바뀌었습니다. Gemini CLI 공식 문서 맨 위에 이 안내가 붙어 있습니다. 그래서 "Gemini CLI로 Blender MCP 연결하기" 같은 예전 글을 따라 하면 설정 파일 위치부터 어긋납니다.

Antigravity CLI는 터미널(검은 글자 창)에서 말로 일을 시키는 Google의 AI 도우미입니다. 명령 이름은 agy입니다. 이사한 집에 비유하면, 가구(MCP 서버, 규칙 문서)는 대부분 그대로 쓸 수 있는데 서랍 위치(설정 파일)가 바뀌었습니다. 이 글은 새 집의 서랍 위치와 Blender MCP를 넣는 법을 설명합니다.

터미널이 처음이라면 GUI와 CLI, 무엇이 다를까를, MCP라는 말이 처음이라면 MCP란 무엇인가를 먼저 읽어 보세요.

이 글을 마치면 아래를 할 수 있습니다.

1. Gemini CLI와 Antigravity CLI의 관계를 설명합니다.
2. Windows에서 agy를 설치하고 판을 확인합니다.
3. agy mcp add로 Blender 공식 MCP 서버를 등록하고, 목록에서 켜고 끕니다.
4. 작업 폴더 전용 설정 파일 .agents/mcp_config.json을 직접 씁니다.
5. 옛 Gemini CLI 설정에서 바뀐 곳을 찾아 옮깁니다.
6. MCP 도구의 권한을 확인합니다.

1. 무엇이 바뀌었나

~는 여러분의 사용자 폴더(예: C:\Users\이름)를 줄인 표시입니다. 공식 문서 "Gemini CLI에서 옮기기"는 규칙 문서(GEMINI.md)는 고칠 필요가 없다고 설명합니다. 바뀌는 것은 주로 MCP 설정 파일과 스킬 폴더입니다.

Gemini CLI 문서의 안내는 "Unpaid tier and Google One users"를 대상으로 적혀 있습니다. 회사 계정이나 유료 API 키로 쓰는 경우는 이 글의 범위가 아닙니다. 그런 계정이라면 소속 관리자 안내를 먼저 보세요.

2. agy 설치와 판 확인

공식 시작하기 문서의 설치 명령입니다. 하나만 고르면 됩니다.

Windows 패키지 관리자 winget에도 Google.AntigravityCLI라는 이름으로 올라와 있습니다(winget install Google.AntigravityCLI). Windows에서 기본 설치 위치는 C:\Users\<이름>\AppData\Local\agy\bin입니다.

따라 하기:

1. 설치를 마친 뒤 터미널을 새로 엽니다.
2. 아래 명령으로 판을 확인합니다.

agy --version

3. MCP 등록 명령의 도움말도 한 번 봅니다.

agy mcp add --help

그림 1. agy 판과 MCP 등록 도움말. 맨 위 판 1.4.7, 그 아래 Usage 줄의 쓰는 꼴(옵션, 이름, 명령이나 주소, 인자 차례), Flags의 서버 종류 --type stdio·http, Notes의 옵션은 이름 앞에 둔다는 메모 (터미널 화면 캡처)

도움말의 Notes 세 줄이 중요합니다.

• 옵션(--env 같은 것)은 서버 이름보다 앞에 둡니다. 뒤에 두면 거절됩니다.
• 주소가 http://나 https://로 시작하면 웹 방식(http)으로 알아서 알아봅니다.
• -로 시작하는 인자를 넘길 때는 그 앞에 --를 둡니다.

처음 실행: 새 사용자 폴더에서 agy를 처음 켜자, 색 구성을 고르는 화면 다음에 아래 약관·데이터 사용 화면이 나왔습니다.

그림 2. 첫 실행의 약관·데이터 사용 화면. 위쪽 보안 경고 두 줄, 가운데 처음부터 체크된 데이터 사용 동의 칸, 아래쪽 Previous와 Done (터미널 화면 캡처)

위쪽 두 줄은 AI 코딩 에이전트에 스스로 코드를 실행하는 위험, 데이터가 밖으로 새는 위험, 프롬프트 인젝션, 공급망(가져다 쓰는 부품) 위험이 있으니 에이전트가 하는 일을 지켜보고 확인하라는 경고입니다. 그 아래 칸은 처음부터 체크되어 있습니다. 체크된 채로 Done을 누르면 여러분의 대화(Interactions) 데이터를 Google이 서비스 개선에 쓰는 데 동의하게 됩니다. 원하지 않으면 칸에서 Enter를 눌러 체크를 풀고 Done을 고릅니다. 화면에는 나중에 설정에서 언제든 거둘 수 있다고 적혀 있습니다.

로그인: 공식 인증 문서에 따르면 자기 컴퓨터에서 처음 켤 때 저장된 로그인이 없으면 기본 웹 브라우저가 열리고, 개인 Google 계정이나 회사 계정으로 로그인합니다. 한 번 로그인하면 운영체제의 키 보관함(keyring)에 저장되어, 다음부터는 브라우저 없이 조용히 로그인됩니다. 브라우저가 없는 환경에서는 Gemini API 키(GEMINI_API_KEY)나 Google Cloud 자격 증명으로도 쓸 수 있다고 문서는 안내합니다.

컴퓨터에 예전 Gemini CLI 설정이 있으면 첫 실행 때 무엇을 옮길지 고르는 목록이 나온다고 공식 문서는 설명합니다. 옛 확장 기능만 따로 옮기려면 아래 명령을 씁니다.

agy plugin import gemini

3. Blender 쪽 준비

agy에 등록하기 전에 Blender와 공식 MCP 서버가 준비되어 있어야 합니다. 순서는 Blender 공식 MCP 설치하기와 같습니다.

1. Blender 5.1 이상에 Blender Lab의 MCP 애드온을 설치하고 켭니다.
2. 공식 MCP 서버 소스를 C:\blender_mcp\mcp에 두고 uv를 설치합니다.
3. Blender의 Edit ‣ Preferences ‣ Add-ons ‣ MCP에서 서버가 켜져 있는지 봅니다.

그림 3. Blender 쪽 준비 확인. 위쪽 Port 9876, 맨 아래 Server is running (Blender 화면 캡처)

4. agy에 Blender MCP 등록하기

시작 상태: 2절의 터미널에서 이어 갑니다. Blender를 다룰 작업 폴더로 옮겨 둡니다(예: cd E:\blender_ai_demo\agy_demo).

따라 하기:

1. 아래 명령으로 서버를 등록합니다. 이름은 blender로 짓습니다.

agy mcp add blender uv --directory C:\blender_mcp\mcp run blender-mcp

2. "Added MCP server "blender" (stdio)"가 나오면 등록된 것입니다.
3. 목록으로 확인합니다.

agy mcp list

4. 잠시 쓰지 않을 때는 지우지 말고 꺼 둡니다. 다시 켤 때는 enable입니다.

agy mcp disable blender
agy mcp enable blender

그림 4. 등록·확인·끄기. 맨 위 Added MCP server, 첫 번째 list의 STATUS enabled, disable 뒤 두 번째 list의 disabled, 맨 아래 작업 폴더 설정 파일 (터미널 화면 캡처)

agy mcp add는 전체 설정 파일 ~/.gemini/config/mcp_config.json에 아래처럼 적습니다.

{
  "mcpServers": {
    "blender": {
      "args": ["--directory", "C:\\blender_mcp\\mcp", "run", "blender-mcp"],
      "command": "uv",
      "disabled": false
    }
  }
}

disable을 하면 "disabled": true로 바뀌고, 설정은 지워지지 않습니다. 공식 문서도 disabled를 "설정을 지우지 않고 연결을 멈추는 칸"으로 설명합니다. 전등 스위치를 내리는 것이지 전등을 떼어 내는 것이 아닙니다.

Blender 포트를 9876이 아닌 번호로 바꿨다면 서버에 환경 변수로 알려 줍니다. 공식 서버는 BLENDER_MCP_PORT 값을 읽습니다. 옵션은 이름 앞에 둡니다.

agy mcp add --env BLENDER_MCP_PORT=9877 blender uv --directory C:\blender_mcp\mcp run blender-mcp

5. 작업 폴더에만 등록하기

전체 설정에 넣으면 agy를 어느 폴더에서 켜든 Blender 서버가 붙습니다. Blender 작업 폴더에서만 쓰고 싶다면 그 폴더에 설정 파일을 둡니다. 공식 문서의 작업 폴더 설정 위치는 <작업 폴더>/.agents/mcp_config.json입니다.

따라 하기:

1. 작업 폴더 안에 .agents 폴더를 만듭니다.
2. 그 안에 mcp_config.json을 만들고 아래를 넣어 저장합니다.

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["--directory", "C:\\blender_mcp\\mcp", "run", "blender-mcp"]
    }
  }
}

JSON 파일 안에서는 경로의 \를 \\로 두 번 씁니다. 한 번만 쓰면 파일을 읽지 못합니다.

그림 4의 마지막 부분이 이 파일을 화면에 띄운 모습입니다. 화면에서 역슬래시가 원(₩) 기호 두 개로 보이는 것은 한국어 Windows 명령 프롬프트가 \를 ₩로 그리기 때문입니다. 한 가지 알아 둘 점이 있습니다. agy mcp list는 전체 설정만 보여 줍니다. 그림 4의 PC에서 작업 폴더 파일만 두고 agy mcp list를 실행하면 "No MCP servers configured."가 나왔습니다. 작업 폴더 설정이 잘 읽혔는지는 agy를 그 폴더에서 켠 뒤 6절의 /mcp 화면에서 확인합니다.

웹 방식 서버를 붙일 때는 command 대신 serverUrl을 씁니다. 예를 들어 내 컴퓨터 AI로 Blender 움직이기에서 켠 http://127.0.0.1:9191/ 서버라면 이렇습니다. agy mcp add blender-local http://127.0.0.1:9191/로 넣어도 같은 꼴로 적힙니다.

{
  "mcpServers": {
    "blender-local": {
      "serverUrl": "http://127.0.0.1:9191/"
    }
  }
}

공식 문서는 한 항목에 연결 방식을 하나만 쓰라고 합니다. command와 serverUrl을 한 항목에 같이 두지 않습니다.

6. agy 안에서 연결 확인하기

여기부터는 로그인한 agy 대화 화면에서 하는 일입니다. 5절처럼 작업 폴더의 .agents/mcp_config.json에만 blender를 등록하고, Blender에는 탁자 위에 소품을 올린 예제 장면(물체 11개)을 열어 두고 시험했습니다.

시작 상태: 5절의 작업 폴더와 설정 파일, MCP 서버가 켜진 Blender에서 시작합니다.

따라 하기:

1. 작업 폴더에서 agy를 입력해 대화 화면을 켭니다.
2. 그 폴더에서 처음 켜면 "이 프로젝트의 내용을 믿습니까?"라는 질문이 먼저 나옵니다. agy가 그 폴더의 파일을 읽고, 고치고, 실행하려면 허락이 필요하다는 뜻입니다. 여러분이 만든 작업 폴더라면 Yes, I trust this folder를 고릅니다.

그림 5. 작업 폴더를 처음 열 때 나오는 신뢰 질문. 위쪽 작업 폴더 경로, 아래쪽 Yes와 No 두 선택지 (터미널 화면 캡처)

3. 입력 칸에 /mcp를 넣고 Enter를 누릅니다. MCP Servers 창이 열립니다.

그림 6. /mcp 창. 초록 체크가 붙은 blender와 도구 이름 다섯 개, 그 뒤 +21 more (터미널 화면 캡처)

blender 옆에 초록 체크가 있고 도구가 다섯 개 이름과 "+21 more"로 보입니다. 모두 26개로, 공식 서버의 도구 수와 같습니다. 줄을 고르고 Enter를 누르면 Restart(다시 연결)와 Disable(끄기)을 고를 수 있습니다.

그림에서는 묶음 이름이 "Plugins (~.gemini\config\plugins)"로 보입니다. 그런데 시험한 컴퓨터에는 그 폴더가 없었고, 전체 설정 파일 ~/.gemini/config/mcp_config.json도 비어 있었습니다. blender는 작업 폴더의 .agents/mcp_config.json에서 읽힌 것입니다. 화면의 묶음 이름만 보고 설정 위치를 판단하지 마세요.

4. 장면을 바꾸지 않는 질문부터 보냅니다.

지금 열린 Blender 장면에 있는 물체 이름과 개수를 알려 줘. 아무것도 바꾸지 마.

시험에서는 agy가 MCP 도구를 바로 쓰지 않고, 먼저 PowerShell 명령으로 작업 폴더와 그 위 폴더의 파일 목록을 보려 했습니다. 명령마다 "Run this command?" 허락을 물었고, No, cancel로 거절했습니다. 이럴 때는 쓸 도구를 분명히 말해 줍니다.

파일은 보지 말고, blender MCP 서버의 장면 요약 도구로 확인해 줘.

5. 이번에는 MCP 도구 blender/get_objects_summary를 부르기 전에 허락 창이 뜹니다.

그림 7. MCP 도구 허락 창. 위쪽 부르려는 도구 이름, 아래쪽 한 번·이 대화 내내·늘 허락과 거절 선택지 여섯 개 (터미널 화면 캡처)

장면을 읽기만 하는 도구이므로 1번을 고릅니다. 잠시 뒤 답이 나옵니다.

그림 8. Blender 장면을 읽은 답. 위쪽 도구 호출 기록, 가운데 물체 11개 표, 맨 아래 조회만 했다는 문장 (터미널 화면 캡처)

물체 11개와 각각의 유형(MESH, CAMERA, LIGHT)을 맞혔습니다. 연결되지 않으면 아래 "자주 하는 실수와 해결" 표의 순서로 봅니다.

7. 권한과 안전

공식 문서에 따르면 따로 정하지 않은 MCP 도구는 Ask 모드로 돌아갑니다. 도구를 쓸 때마다 허락을 묻는다는 뜻이고, 6절의 그림 7이 바로 그 허락 창입니다. 자주 쓰는 도구만 허락 목록에 넣을 수 있고, 규칙은 아래 꼴입니다.

6절의 허락 창에서 매번 고르는 대신, 읽기 도구 하나를 미리 허락 목록에 넣어 봅니다.

따라 하기:

1. 대화 화면에서 /permissions를 입력하고 Enter를 누릅니다. Permission Config Editor가 열리고 범위를 고르라고 합니다. 선택지는 Project, Shared with Antigravity, Global입니다.
2. Project를 고르고 Enter를 누릅니다. allowlist(허락), denylist(금지), asklist(묻기) 세 목록이 보입니다.
3. allowlist에서 a를 누르고 mcp(blender/get_objects_summary)를 넣은 뒤 Enter를 누릅니다. allowlist (1)이 됩니다.

그림 9. /permissions의 Project 범위 allowlist에 규칙 한 줄을 넣은 모습 (터미널 화면 캡처)

4. agy를 끄고 같은 폴더에서 다시 켠 뒤, 장면 요약 도구를 쓰라고 말합니다.

그림 10. 규칙을 넣은 뒤의 새 대화. 허락 창 없이 바로 도구를 부르고 답함 (터미널 화면 캡처)

이번에는 허락 창 없이 바로 도구를 불렀습니다. 규칙이 적용된 것입니다. 시험한 판(1.4.7)에서 Project 범위 규칙은 작업 폴더가 아니라 사용자 폴더의 ~/.gemini/config/projects/default-cli-project.json에 저장됐습니다. 규칙을 지우려면 같은 창에서 그 줄을 고르고 d를 누릅니다. 작업 폴더를 믿는다고 고른 기록(6절 2번)도 ~/.gemini/antigravity-cli/settings.json의 trustedWorkspaces에 남습니다.

이 새 대화에서도 agy는 먼저 PowerShell로 Blender 프로그램이 켜져 있는지 보려 했고, 그 명령은 따로 허락을 물었습니다. MCP 도구 규칙은 셸 명령 허락과 따로 움직입니다.

Blender MCP에는 이렇게 권합니다.

• 장면 요약, 물체 자세히 보기, 화면 캡처처럼 읽기만 하는 도구만 허락 목록에 넣습니다.
• 코드를 실행하는 execute_blender_code는 Ask로 남겨 매번 코드를 보고 허락합니다.
• mcp(blender/*)나 mcp(*)처럼 넓은 허락은 쓰지 않습니다.
• agy --help에 있는 --dangerously-skip-permissions(모든 허락을 자동으로 승인)는 Blender 작업에 쓰지 않습니다.

AI에게 장면을 맡기기 전의 점검 순서는 AI에게 Blender를 맡기기 전 안전 점검에 따로 정리했습니다.

8. 옛 Gemini CLI 설정 옮기기

예전 Gemini CLI의 ~/.gemini/settings.json에 아래처럼 Blender 서버를 넣어 두었다고 해 봅니다.

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["--directory", "C:\\blender_mcp\\mcp", "run", "blender-mcp"],
      "timeout": 30000,
      "trust": false
    }
  }
}

따라 하기:

1. mcpServers 안의 blender 항목에서 command, args, env, cwd를 가져옵니다. timeout이 있으면 2번에서 이름과 단위를 바꿔 옮깁니다.
2. ~/.gemini/config/mcp_config.json(전체) 또는 .agents/mcp_config.json(작업 폴더)에 붙여 넣습니다. 4절처럼 agy mcp add 한 줄로 다시 등록해도 됩니다.
3. 웹 방식 서버였다면 url이나 httpUrl을 serverUrl로 바꿉니다.
4. .gemini/skills/에 둔 스킬이 있다면 .agents/skills/로 옮깁니다. 공식 문서는 이 옮기기를 손으로 해야 한다고 적습니다.
5. agy mcp list로 전체 설정을 확인합니다.

옛 timeout은 밀리초 단위였고, agy의 MCP 설정 문서에는 초 단위의 timeoutSeconds 칸이 있습니다. 위 예의 "timeout": 30000은 "timeoutSeconds": 30으로 바꿔 옮깁니다. 이 칸을 비워 두면 공식 문서의 기본값(도구 한 번에 180초, 연결에 300초)이 쓰입니다. 문서의 속성 표에는 이 밖에도 서버의 일부 도구만 보이게 하는 enabledTools, 일부 도구를 숨기는 disabledTools 같은 칸이 있습니다.

trust는 agy 설정 표에 없는 칸이라 옮기지 않습니다. 도구를 믿고 자동 허락하는 일은 7절의 권한 규칙으로 정합니다.

연습 문제

1. agy --version을 실행하고 판 번호를 적어 보세요.
2. agy mcp add --help의 Notes에서 옵션을 어디에 두라고 하는지 찾아 보세요.
3. Blender 서버를 agy mcp add로 등록한 뒤 agy mcp list로 STATUS를 확인합니다.
4. agy mcp disable blender로 끈 뒤 다시 list를 보고, 설정 파일에서 무엇이 바뀌었는지 적어 보세요.
5. 옛 Gemini CLI 설정의 httpUrl 항목을 agy용으로 고쳐 써 보세요.

자주 하는 실수와 해결

한 줄 정리

agy 설치 → agy mcp add blender uv --directory C:\blender_mcp\mcp run blender-mcp → /mcp로 확인, 설정 파일은 mcp_config.json. 같은 Blender 지식을 여러 AI 도구에 나눠 주는 방법은 Blender 에이전트 스킬에서 다룹니다.

함께 읽기

• Blender 공식 MCP 설치하기
• Claude Code에 Blender 공식 MCP 붙이기
• AI에게 Blender를 맡기기 전 안전 점검
• Blender 에이전트 스킬 쓰는 법: SKILL.md 넣기, 검사, 지오메트리 노드 실습
• MCP 서버 연결하기: AI에게 도구를 붙이는 방법

참고 자료

• Gemini CLI 공식 문서, MCP servers(Antigravity CLI 전환 안내): https://geminicli.com/docs/tools/mcp-server/
• Antigravity 공식 문서, MCP: https://antigravity.google/docs/mcp
• Antigravity 공식 문서, 시작하기(CLI): https://antigravity.google/docs/getting-started
• Antigravity 공식 문서, Gemini CLI에서 옮기기: https://antigravity.google/docs/cli/gcli-migration/
• Antigravity 공식 문서, /permissions 명령: https://antigravity.google/docs/cli/commands/permissions/
• Antigravity 공식 문서, 설치와 인증(CLI): https://antigravity.google/docs/install?tab=cli
• Blender Lab, MCP Server: https://www.blender.org/lab/mcp-server/
• 그림: 터미널 화면 9장(agy 1.4.7, Windows 명령 프롬프트. 계정 이름과 요금제가 보이는 머리 부분은 잘라 냄), Blender 5.2.1 환경설정 화면 1장