Antigravity 2.0 데스크탑 에이전트 세팅 — 로컬 설치부터 MCP 연결까지

코드를 신경 쓰지 않고 아이디어에서 제품까지. Antigravity 2.0의 에이전트 퍼스트 개발 환경을 세팅합니다.

---

✅ 핵심 요약

→ Antigravity 2.0은 Google I/O 2026에서 발표된 에이전트 퍼스트 데스크탑 개발 환경입니다 → 기존 IDE 없음 — 에이전트 매니저만 있습니다. "아이디어 → 제품" 직행이 목표 → Antigravity 생태계: 2.0(데스크탑) + IDE(VS Code 스타일) + CLI(터미널) + SDK(Python) → Antigravity CLI는 Gemini CLI의 공식 대체 — Go로 작성, 더 빠른 시작, 낮은 메모리 → Gemini CLI는 2026년 6월 18일 개인 사용자 종료 — 그 전에 마이그레이션 필요 → MCP 설정은 ~/.gemini/config/mcp_config.json 단일 파일로 CLI·IDE·2.0 전체에 공유됩니다 → Google Workspace(Gmail·Drive·Calendar·Meet) MCP 서버 공식 지원 → 프로젝트별 MCP 서버 허용 범위를 독립적으로 제어할 수 있습니다

---

Antigravity 생태계 전체 구조

Antigravity 생태계는 4가지 서피스로 구성됩니다.

서피스 설명 용도

Antigravity 2.0	데스크탑 앱, 에이전트 매니저	코드 안 보고 아이디어→제품
Antigravity IDE	VS Code 유사 에디터 + 에이전트	코드 보면서 에이전트 보조
Antigravity CLI	터미널 TUI, Gemini CLI 대체	터미널 퍼스트 개발
Antigravity SDK	Python 에이전트 SDK	커스텀 에이전트 빌드

모든 서피스가 동일한 에이전트 하네스를 공유합니다. MCP 서버 설정, Skills, 권한이 CLI·IDE·2.0 전체에서 동기화됩니다.

---

설치

Antigravity 2.0 데스크탑 앱

# macOS (Homebrew)
brew install --cask google-antigravity

# Windows (winget)
winget install Google.Antigravity

# Linux (apt)
sudo apt-get install google-antigravity

또는 antigravity.google.com에서 플랫폼별 설치 파일 직접 다운로드.

Antigravity CLI

# macOS / Linux
curl -fsSL https://dl.google.com/antigravity/install.sh | sh

# npm (Node.js 환경)
npm install -g @google/antigravity-cli

# 설치 확인
agy --version

인증

# Google 계정으로 인증
agy auth login

# 인증 상태 확인
agy auth status

---

첫 번째 프로젝트 만들기 (Antigravity 2.0)

Antigravity 2.0에서 프로젝트를 생성하려면 작업할 폴더를 지정해야 합니다. 각 프로젝트는 독립된 에이전트 설정을 가지며, 프로젝트별로 보안 설정과 MCP 서버 허용 범위를 독립적으로 커스터마이징할 수 있습니다.

Antigravity 2.0 실행 →
Select Project → New Project →
Add Folder → 작업 폴더 선택 →
보안 권한 설정 (파일 쓰기, 터미널 실행, 외부 접근) →
Create

프로젝트 보안 설정 항목

설정 옵션

Artifact 리뷰	자동 적용 / 항상 확인 요청
허용 툴	파일 읽기·쓰기, 터미널 실행, 브라우저 조작
MCP 서버	전역 설정에서 이 프로젝트에만 허용할 서버 선택

---

MCP 서버 연결 — 핵심 세팅

MCP 설정 파일은 $HOME/.gemini/config/mcp_config.json입니다. 이 파일 하나가 Antigravity CLI·IDE·2.0 전체에 공유됩니다.

기본 설정 구조

// ~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase/mcp-server-supabase@latest"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_ANON_KEY": "your-anon-key"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token"
      }
    }
  }
}

CLI에서 MCP 서버 추가

# MCP 서버 목록 확인
agy mcp list

# MCP 서버 추가 (대화형)
agy mcp add

# 특정 서버만 허용하여 실행
agy --mcp-only supabase,github "DB 스키마 읽고 API 엔드포인트 만들어줘"

---

Google Workspace MCP 연결

Gmail, Google Drive, Google Calendar, Google Chat, People API를 코드 없이 Antigravity에 연결할 수 있습니다.

설정 방법

// ~/.gemini/config/mcp_config.json에 추가
{
  "mcpServers": {
    "gws-gmail": {
      "httpUrl": "https://gmail.googleapis.com/mcp/v1",
      "auth": "oauth2"
    },
    "gws-drive": {
      "httpUrl": "https://drive.googleapis.com/mcp/v1",
      "auth": "oauth2"
    },
    "gws-calendar": {
      "httpUrl": "https://calendar.googleapis.com/mcp/v1",
      "auth": "oauth2"
    }
  }
}

인증 처리

각 Antigravity 서피스(2.0, IDE, CLI)별로 OAuth 토큰을 따로 인증해야 합니다. 토큰이 중앙화되지 않기 때문입니다.

Antigravity 2.0 Settings → Customizations →
Installed MCP Servers → Refresh →
각 Google Workspace 서버 → Authenticate →
브라우저 OAuth 플로우 완료

사용 예시

agy "오늘 받은 이메일 중 미응답인 것 목록 만들어줘"
agy "다음 주 회의 일정 요약하고 Docs에 아젠다 초안 만들어줘"
agy "Drive에서 Q2 보고서 찾아서 핵심 내용 정리해줘"

---

실전 MCP 활용 — Supabase 버그 픽스 워크플로우

MCP 없이는 불가능하지만 MCP가 있으면 3분 안에 끝나는 워크플로우가 있습니다.

# 시나리오: 유저가 프로필 저장이 안 된다는 버그 리포트

agy "profiles 테이블의 마지막 실패한 insert 로그 확인해줘"
# → Supabase MCP로 DB 로그 조회
# → "Row Level Security Policy Violation" 발견

agy "현재 RLS 정책 읽고, 유저가 자신의 row를 업데이트할 수 있도록 수정해줘"
# → 파일 접근으로 SQL 정의 읽기
# → 새 RLS 정책 제안

agy "SQL 정책 적용하고 Vercel에 배포해줘"
# → Supabase MCP로 SQL 실행
# → Vercel MCP로 빌드 트리거

# 총 소요 시간: 3분 / 열어본 탭: 0개

---

Skills — 반복 프롬프트를 재사용 명령으로

Agent Skills는 마크다운 파일로 자주 쓰는 프롬프트를 재사용 슬래시 커맨드로 만드는 기능입니다.

<!-- ~/.gemini/skills/code-review.md -->
---
name: code-review
description: PR 코드 리뷰 수행
trigger: /review
---

# Code Review Skill

다음 기준으로 코드를 리뷰합니다:
1. 보안 취약점 (SQL 인젝션, XSS, 인증 누락)
2. 성능 병목 (N+1 쿼리, 불필요한 루프)
3. 코드 컨벤션 및 타입 안정성
4. 테스트 커버리지 미비 항목

각 항목에 대해 구체적인 수정 제안을 코드와 함께 제시합니다.

# Skills 사용
agy /review "이 PR 리뷰해줘"

---

Gemini CLI → Antigravity CLI 마이그레이션

개인 Google AI Pro·Ultra 사용자 기준 Gemini CLI는 2026년 6월 18일 종료됩니다.

마이그레이션 체크리스트

# 1. Antigravity CLI 설치
npm install -g @google/antigravity-cli

# 2. 기존 Gemini CLI 설정 확인
cat ~/.gemini/config.json

# 3. MCP 설정 위치 확인 (그대로 사용 가능)
cat ~/.gemini/config/mcp_config.json

# 4. 커맨드 변경 확인
# 기존: gemini "프롬프트"
# 신규: agy "프롬프트"

# 5. 인증 재설정
agy auth login

# 6. MCP 서버 정상 동작 확인
agy mcp list
agy "MCP 서버 연결 테스트해줘"

💡 MCP 설정 파일은 그대로 재사용 가능합니다. ~/.gemini/config/mcp_config.json은 Antigravity CLI에서도 동일 경로를 사용합니다.

---

자주 발생하는 에러와 해결법

에러 원인 해결

MCP server connection failed	서버 미설치 또는 경로 오류	npx -y @서버패키지 먼저 직접 실행해서 확인
OAuth token expired	Workspace MCP 토큰 만료	Settings → MCP Servers → Re-authenticate
Permission denied	프로젝트 보안 설정	프로젝트 Settings → 허용 툴 확인
agy: command not found	PATH 미설정	export PATH=$PATH:$HOME/.agy/bin
Gemini CLI 계속 뜸	이전 버전 PATH 우선	which gemini → 이전 설치 제거 후 재시작

---

관련 글

• Google AI Ultra 구독 분석 — Gemini Spark·Antigravity 포함 정리