MCP & Browser Subagent (도구 & 연동) - 오늘코드 Antigravity 튜토리얼

MCP (Model Context Protocol) 공식 문서 #

MCP는 로컬 도구, 데이터베이스, 외부 서비스에 연결하기 위한 표준 프로토콜입니다. 에이전트가 GitHub, Notion, 데이터베이스 등 다양한 서비스와 통신할 수 있게 해줍니다.

핵심 기능 (Core Features)

1) Context Resources

MCP 서버로부터 데이터를 읽습니다. 라이브 DB 스키마 조회, 빌드 로그 확인, 외부 API 데이터 수집 등에 사용됩니다.

2) Custom Tools

안전한 작업을 실행합니다. 이슈 생성, PR 관리, 데이터 쿼리 실행, 배포 트리거 등 MCP 서버를 통해 외부 서비스에 작업을 수행합니다.

연결 방법: 내장된 MCP Store 패널에서 연결할 수 있습니다. "..." 드롭다운 메뉴에서 MCP Store를 열고 원하는 서비스를 검색하세요.

MCP 활용 시나리오

예를 들어, Google Sheets MCP 서버를 연결하면 "구글 시트의 매출 데이터를 가져와서 분기별 성장률을 계산해줘"라고 한 마디로 요청할 수 있습니다. 에이전트가 직접 시트에 접근하여 데이터를 읽고 분석합니다.

MCP 서버 설정 공식 문서 #

MCP Store에 없는 커스텀 MCP 서버는 설정 파일을 직접 수정하여 연결합니다.

설정 파일 경로

사용 환경에 따라 두 가지 경로가 있습니다.

      Antigravity IDE (데스크톱 앱)
      ~/.gemini/antigravity/mcp_config.json
    

      Antigravity CLI (agy, 2026-05+)
      # 전역
~/.gemini/antigravity-cli/mcp_config.json

# 워크스페이스 단위 (팀 공유)
<프로젝트_루트>/.agents/mcp_config.json
    

필드명 변경 안내: Antigravity CLI(agy)부터는 원격 MCP 서버 정의에서 url·httpUrl 필드가 폐지되고 serverUrl로 통일됐습니다. Gemini CLI 시절 설정을 옮긴다면 이 필드만 바꾸면 됩니다. 본 페이지의 예시는 이미 serverUrl을 사용합니다.

설정 구조

mcpServers 객체 안에 각 서버를 정의합니다. 서버마다 transport 방식을 지정합니다.

      JSON
      {
  "mcpServers": {
    "my-server": {
      "command": "npx",           // stdio transport
      "args": ["my-mcp-server"],
      "env": { "API_KEY": "..." },
      "cwd": "/path/to/dir"
    },
    "remote-server": {
      "serverUrl": "https://example.com/mcp",  // HTTP transport
      "headers": { "Authorization": "Bearer ..." }
    }
  }
}
    

사용 가능한 속성

MCP 설정 파일 사용 가능한 속성
속성	필수	설명
`command`	stdio 시	stdio transport를 위한 실행 명령
`serverUrl`	HTTP 시	HTTP transport를 위한 서버 URL
`args`	선택	명령어 인수 배열
`env`	선택	환경 변수 객체
`cwd`	선택	작업 디렉토리
`headers`	선택	HTTP 요청 헤더
`authProviderType`	선택	인증 제공자 유형
`oauth`	선택	OAuth 설정 객체
`disabled`	선택	서버 비활성화 여부 (boolean)
`disabledTools`	선택	비활성화할 도구 목록

MCP 서버 연결 5단계

MCP Store 확인: Antigravity 내 "..." 메뉴에서 MCP Store를 열고, 원하는 서버가 있는지 검색합니다.
Store에 있으면: 클릭 한 번으로 연결 완료. 별도 설정 불필요.
Store에 없으면: ~/.gemini/antigravity/mcp_config.json 파일을 직접 편집합니다.
서버 정보 추가: transport 방식(stdio 또는 HTTP)에 맞는 속성을 작성합니다.
연결 확인: Antigravity를 재시작하고 에이전트에게 "연결된 MCP 서버 목록을 보여줘"라고 요청합니다.

연결 오류 시 체크리스트: ① command 경로가 올바른지 확인 (npx, node 등) ② env에 API 키가 정확히 입력됐는지 확인 ③ JSON 문법 오류 여부 검사 (쉼표, 중괄호) ④ 방화벽/프록시 설정 확인 (HTTP transport)

데이터 분석 활용

BigQuery MCP 서버를 연결하면 에이전트가 직접 SQL 쿼리를 실행하여 데이터를 가져올 수 있습니다. "지난 분기 매출 데이터를 BigQuery에서 가져와서 pandas로 분석해줘"라고 말하면 에이전트가 MCP를 통해 쿼리를 실행하고 결과를 분석합니다.

MCP 인증 (Authentication) #

MCP 서버 연결 시 다양한 인증 방식을 지원합니다.

Google Credentials (ADC)

Application Default Credentials를 사용하여 Google Cloud 서비스(BigQuery, Cloud SQL, Spanner 등)에 인증합니다.

OAuth

동적 클라이언트 등록(Dynamic Client Registration) 또는 수동 자격 증명(Manual Credentials)으로 OAuth 인증을 수행합니다.

OAuth 토큰 저장: OAuth 토큰은 ~/.gemini/antigravity/mcp_oauth_tokens.json에 저장됩니다. 보안상 이 파일은 다른 사람과 공유하지 마세요.

v1.21.6 인증 변경: MCP 서버 인증 방식이 새로운 토큰 교환(token-exchange) 메커니즘으로 변경되었습니다. v1.20.x 이하에서 생성된 기존 인증 토큰은 무효화되므로, 업데이트 후 MCP 서버 인증을 다시 설정해야 합니다.

GitHub MCP 서버 설정 가이드 #

GitHub MCP 서버를 연결하면 에이전트가 이슈 관리, PR 생성, 코드 검색, 저장소 관리를 직접 수행할 수 있습니다. 이 가이드는 처음부터 끝까지 따라할 수 있도록 모든 단계를 안내합니다.

이 가이드를 완료하면: "이번 주 열린 이슈를 정리해줘", "버그 수정 PR을 만들어줘", "README를 업데이트해줘" 등의 요청을 에이전트가 GitHub에서 직접 수행합니다.

설정 전체 흐름

Step 1: GitHub Personal Access Token (PAT) 생성

GitHub MCP 서버가 사용자의 GitHub 계정에 접근하려면 Personal Access Token이 필요합니다. 일종의 "디지털 출입증"이라고 생각하면 됩니다.

비유로 이해하기

Personal Access Token은 아파트 출입 카드와 같습니다. 비밀번호(마스터키)를 직접 주는 대신, 특정 구역만 접근 가능한 카드를 발급하는 것입니다. 필요 없어지면 카드만 폐기하면 되고, 본래 비밀번호는 안전하게 유지됩니다.

토큰 종류 비교

GitHub 토큰 종류 비교
구분	Classic Token	Fine-grained Token (권장)
권한 범위	넓은 범위 (repo, admin 등)	저장소/권한별 세밀한 제어
보안성	보통	높음 (최소 권한 원칙)
만료일	선택사항	필수 (최대 1년)
추천 용도	빠른 테스트, 레거시	프로덕션 사용, MCP 연동
토큰 접두어	`ghp_`	`github_pat_`

Fine-grained Token 생성 절차

GitHub 설정 페이지 이동: GitHub에 로그인한 상태에서 우측 상단 프로필 아이콘 → Settings 클릭
개발자 설정 열기: 좌측 사이드바 맨 아래 Developer settings 클릭
토큰 메뉴 진입: Personal access tokens → Fine-grained tokens → Generate new token 클릭
기본 정보 입력:
- Token name: antigravity-mcp (용도를 알 수 있는 이름)
- Expiration: 90일 권장 (보안상 토큰 유효기간은 짧을수록 좋습니다)
- Description: Antigravity MCP GitHub integration
저장소 범위 선택:
- Only select repositories 선택 → MCP로 접근할 저장소만 추가
- 전체 저장소가 필요하면 All repositories (보안 주의)
권한(Permissions) 설정: 아래 표를 참고하여 필요한 권한만 부여
토큰 생성: Generate token 클릭 → 표시된 토큰을 즉시 복사하여 안전한 곳에 저장

⚠ 중요: 토큰은 생성 직후에만 볼 수 있습니다! 페이지를 떠나면 다시 확인할 수 없으므로 반드시 복사해 두세요. 분실 시 토큰을 삭제하고 새로 생성해야 합니다.

권장 권한 설정

MCP 활용 목적에 따라 아래 권한을 설정하세요. 최소 권한 원칙: 필요한 것만 켜세요.

GitHub 토큰 권장 권한 설정
권한 (Permission)	수준	용도	필수 여부
`Contents`	Read and write	파일 읽기/쓰기, 커밋 생성	✅ 필수
`Issues`	Read and write	이슈 조회/생성/수정	✅ 필수
`Pull requests`	Read and write	PR 조회/생성/리뷰	✅ 필수
`Metadata`	Read-only	저장소 기본 정보	✅ 자동 부여
`Workflows`	Read and write	GitHub Actions 관리	선택
`Actions`	Read-only	CI/CD 상태 확인	선택
`Discussions`	Read and write	디스커션 관리	선택

Classic Token을 사용해야 한다면

Fine-grained Token이 지원되지 않는 조직(Organization)에서는 Classic Token을 사용합니다. Personal access tokens → Tokens (classic) → Generate new token에서 생성하세요. 필요한 scope: repo (전체 저장소 접근), read:org (조직 정보 읽기).

Step 2: MCP 설정 파일 작성

토큰을 생성했으면 설정 파일에 GitHub MCP 서버 정보를 추가합니다.

설정 파일 위치

운영체제별 MCP 설정 파일 경로
운영체제	설정 파일 경로
macOS / Linux	`~/.gemini/antigravity/mcp_config.json`
Windows	`%USERPROFILE%\.gemini\antigravity\mcp_config.json`

파일이 없다면? 해당 경로에 파일이 없으면 직접 생성하세요. 먼저 디렉토리를 만들고 빈 JSON 파일을 생성합니다:

      터미널 (macOS/Linux)
      # 디렉토리 생성 (이미 있으면 무시됨)
mkdir -p ~/.gemini/antigravity

# 빈 설정 파일 생성
echo '{ "mcpServers": {} }' > ~/.gemini/antigravity/mcp_config.json
    

GitHub MCP 서버 설정 추가

설정 파일을 열어 아래 내용을 작성합니다. YOUR_TOKEN_HERE 부분을 Step 1에서 복사한 토큰으로 교체하세요.

      ~/.gemini/antigravity/mcp_config.json
      {
  "mcpServers": {
    "github-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}
    

📦 사전 요구사항: 위 설정은 npx 명령으로 MCP 서버를 실행하므로 Node.js가 시스템에 설치되어 있어야 합니다. 설치되어 있지 않다면 nodejs.org에서 LTS 버전을 다운로드하거나, 패키지 매니저(brew install node, winget install OpenJS.NodeJS 등)로 설치하세요. 터미널에서 node --version으로 설치 여부를 확인할 수 있습니다.

⚠ 보안 주의: 토큰이 포함된 설정 파일을 Git에 커밋하거나, 다른 사람과 공유하지 마세요. 이 파일은 .gitignore에 추가하는 것을 권장합니다.

기존 MCP 서버가 있는 경우

이미 다른 MCP 서버를 설정해 둔 경우, mcpServers 안에 "github-mcp-server" 항목을 추가합니다.

      기존 서버와 함께 설정하는 예시
      {
  "mcpServers": {
    "my-existing-server": {
      "command": "npx",
      "args": ["some-other-mcp-server"]
    },
    "github-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}
    

설정 파일 구조 해부

Step 3: 연결 확인 및 테스트

설정 파일을 저장한 후, Antigravity를 재시작하고 GitHub MCP 서버가 정상 연결됐는지 확인합니다.

Antigravity 재시작: 설정 파일은 앱 시작 시 로드되므로, 저장 후 Antigravity를 완전히 종료했다가 다시 실행합니다.
연결 확인 명령: 채팅창에 다음과 같이 입력하세요.

      에이전트에게 요청
      // 연결된 MCP 서버 확인
"현재 연결된 MCP 도구 목록을 보여줘"

// GitHub 연동 테스트
"내 GitHub 프로필 정보를 가져와줘"

// 저장소 목록 확인
"내 GitHub 저장소 목록을 보여줘"
    

연결 성공 시 사용 가능한 도구

GitHub MCP 연결 시 사용 가능한 도구 목록
도구 이름	기능	사용 예시
`create_issue`	이슈 생성	"로그인 버그 이슈를 만들어줘"
`list_issues`	이슈 목록 조회	"열린 이슈를 정리해줘"
`create_pull_request`	PR 생성	"feature 브랜치로 PR 만들어줘"
`search_code`	코드 검색	"handleError 함수를 찾아줘"
`get_file_contents`	파일 내용 읽기	"README.md 내용을 보여줘"
`create_or_update_file`	파일 생성/수정	"설정 파일을 업데이트해줘"
`push_files`	여러 파일 커밋	"변경된 파일들을 커밋해줘"
`create_branch`	브랜치 생성	"fix/login-bug 브랜치를 만들어줘"
`fork_repository`	저장소 포크	"이 저장소를 포크해줘"
`search_repositories`	저장소 검색	"Python MCP 관련 저장소를 찾아줘"

자주 발생하는 오류와 해결 방법

GitHub MCP 자주 발생하는 오류와 해결 방법
증상	원인	해결 방법
"GitHub 도구를 찾을 수 없습니다"	MCP 서버가 로드되지 않음	설정 파일 경로 확인 후 앱 재시작
"401 Unauthorized" 오류	토큰이 유효하지 않음	토큰 만료 여부 확인, 새 토큰 생성
"403 Forbidden" 오류	권한 부족	토큰의 Permission 범위 확인 후 재생성
"npx: command not found"	Node.js 미설치	`node --version`으로 확인, 없으면 Node.js 설치
JSON 파싱 오류	설정 파일 문법 오류	쉼표, 중괄호, 따옴표 확인 (jsonlint.com에서 검증)
특정 저장소에 접근 불가	Fine-grained 토큰 범위 제한	토큰 설정에서 해당 저장소 추가

Node.js 설치 확인

GitHub MCP 서버는 npx를 사용하므로 Node.js 18 이상이 설치되어 있어야 합니다.

      터미널
      # Node.js 버전 확인
node --version     # v18.0.0 이상이어야 함
npx --version      # npx도 함께 설치됨

# Node.js가 없다면 설치
# macOS (Homebrew)
brew install node

# Windows (공식 사이트에서 다운로드)
# https://nodejs.org 에서 LTS 버전을 다운로드하여 설치

# Linux (Ubuntu/Debian)
sudo apt update && sudo apt install nodejs npm
    

⚠️ Windows PowerShell 권한 오류 해결: Windows에서 node --version 또는 npx를 PowerShell에서 실행할 때 다음과 같은 오류가 발생할 수 있습니다.

        PowerShell 오류 예시
        node : 이 시스템에서 스크립트를 실행할 수 없으므로 C:\Users\...\npm.ps1 파일을 로드할 수 없습니다.
자세한 내용은 about_Execution_Policies(https://go.microsoft.com/fwlink/?LinkID=135170)를 참조하십시오.
+ CategoryInfo          : 보안 오류: (:) [], PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess
      

이는 Windows의 기본 실행 정책(ExecutionPolicy)이 PowerShell 스크립트(.ps1) 실행을 제한하기 때문입니다. 다음 절차로 해결할 수 있습니다.

PowerShell을 관리자 권한으로 실행: 시작 메뉴에서 PowerShell을 검색 → 우클릭 → "관리자 권한으로 실행"
현재 사용자에 대해 실행 정책을 RemoteSigned로 변경:
PowerShell (관리자) Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
확인 메시지가 나오면 Y를 입력하고 Enter
PowerShell 창을 새로 열어 node --version 다시 실행

일시적으로만 허용하고 싶다면 (현재 PowerShell 세션에만 적용):

        PowerShell
        Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
      

실행 정책 의미:

Restricted: 모든 스크립트 실행 차단 (Windows 기본값)
RemoteSigned: 로컬 스크립트는 허용, 인터넷에서 받은 스크립트는 디지털 서명 필요 (권장)
Bypass: 모든 스크립트 허용 (보안상 일시 사용만 권장)

대안: PowerShell 대신 명령 프롬프트(cmd.exe)나 Git Bash에서 실행하면 이 오류가 발생하지 않습니다. 공식 안내: about_Execution_Policies (Microsoft Learn)

Step 4: 실전 활용 시나리오

GitHub MCP가 연결되면 다양한 작업을 자연어로 요청할 수 있습니다.

📋 이슈 관리

"이번 주 생성된 버그 이슈를 우선순위별로 정리해줘"

"로그인 페이지 깨짐 현상에 대한 이슈를 만들고 bug 라벨을 붙여줘"

🔀 PR 워크플로우

"feature/auth 브랜치의 변경사항을 설명하는 PR을 만들어줘"

"이 PR의 코드 리뷰 의견을 요약해줘"

🔍 코드 검색

"우리 저장소에서 deprecated된 API를 사용하는 파일을 찾아줘"

"환경변수를 사용하는 모든 설정 파일을 보여줘"

📁 저장소 관리

"README.md에 설치 가이드 섹션을 추가해줘"

".gitignore에 .env 파일을 추가해줘"

실전 예시: 이슈에서 PR까지 한 번에

      에이전트에게 요청하는 흐름
      ① 이슈 확인
"myrepo의 #42번 이슈 내용을 보여줘"

② 브랜치 생성
"fix/issue-42 브랜치를 만들어줘"

③ 코드 수정
"해당 이슈에서 언급된 버그를 수정하고 커밋해줘"

④ PR 생성
"fix/issue-42에서 main으로 PR을 만들고, 이슈 #42를 연결해줘"

💡 또는 한 번에 요청:
"#42번 이슈의 버그를 수정하는 PR을 만들어줘"
    

보안 체크리스트:

☑ 토큰에 필요한 최소 권한만 부여했는지 확인
☑ 토큰 만료일을 90일 이내로 설정했는지 확인
☑ 설정 파일이 .gitignore에 포함되어 있는지 확인
☑ 토큰을 코드나 메시지에 직접 붙여넣지 않았는지 확인
☑ 사용하지 않는 토큰은 GitHub에서 즉시 삭제

지원 MCP 서버 (30+) #

MCP Store에서 연결 가능한 서비스들입니다. "..." 드롭다운 메뉴에서 바로 검색하고 연결하세요.

데이터 분석 추천 서버

데이터 분석에 특히 유용한 MCP 서버: BigQuery (대규모 데이터 쿼리), Cloud SQL (관계형 DB), MongoDB (NoSQL), Supabase (PostgreSQL + API), Looker (BI 대시보드), Dataplex (데이터 거버넌스)

Browser Subagent 공식 문서 #

메인 에이전트가 브라우저와 상호작용해야 할 때 자동으로 호출되는 전문 서브에이전트입니다. Antigravity가 관리하는 브라우저 내에서 페이지를 조작하기 위한 특화 모델로 구동됩니다.

Chrome 필수: Browser Subagent를 사용하려면 Chrome 브라우저와 Antigravity Chrome 확장 프로그램이 설치되어 있어야 합니다.

첫 브라우저 작업 — 최초 설정 흐름

새 워크스페이스에서 처음으로 브라우저 작업을 요청하면 에이전트가 아래 순서로 확장 프로그램 설치를 안내합니다.

새 대화를 시작하고 브라우저 작업 요청 (예: "antigravity.google에 접속해줘")
에이전트가 "Setup" 버튼 클릭 안내 메시지 표시
Chrome이 열리며 확장 프로그램 설치 메시지 표시
제공된 Chrome 웹 스토어 링크 클릭
"Add to Chrome" 클릭하여 확장 프로그램 설치
에이전트 운영을 위한 권한 부여 → 에이전트가 승인 확인 후 탐색 진행

Chrome 확장 프로그램 설치 방법 (3가지)

Chrome 확장 프로그램 설치 진입점 3가지
진입점	방법
① Antigravity 내 Chrome 아이콘	에이전트가 브라우저 작업을 시도할 때 나타나는 Setup 버튼 클릭
② Agent Manager 좌하단 Chrome 아이콘	에이전트 관리자 화면 왼쪽 하단의 Chrome 아이콘 클릭
③ Editor 우상단 Chrome 아이콘	에디터 화면 오른쪽 상단의 Chrome 아이콘 클릭

확장 프로그램 설치 후 Chrome에서 권한을 부여하면 에이전트가 브라우저를 완전히 제어할 수 있습니다.

Browser Subagent 도구 (Tools)

클릭 (Clicking) — 웹 페이지의 버튼, 링크, 요소를 클릭합니다
스크롤 (Scrolling) — 페이지를 위아래로 스크롤합니다
텍스트 입력 (Typing) — 폼 필드에 텍스트를 입력합니다
콘솔 로그 읽기 (Console Logs) — 브라우저 콘솔의 에러/경고/로그를 확인합니다

페이지 읽기 방식

DOM 캡처 — 페이지의 HTML 구조를 직접 분석합니다
스크린샷 — 페이지의 현재 시각적 상태를 이미지로 캡처합니다
마크다운 파싱 — 페이지 내용을 마크다운 텍스트로 변환합니다
비디오 녹화 — 브라우저 조작 과정을 동영상으로 기록합니다

주요 특징

파란색 테두리 오버레이

Browser Subagent가 페이지를 조작 중일 때 파란색 테두리(blue border)가 표시됩니다. 이 동안 해당 페이지의 사용자 인터랙션이 일시적으로 차단됩니다.

비포커스 탭 지원

포커스되지 않은 탭에서도 작업할 수 있습니다. 사용자가 다른 탭에서 작업하는 동안 Browser Subagent가 백그라운드에서 작업을 수행합니다.

4월 업데이트 (v1.22.2) 동작 변화:

JavaScript SPA 초기화 감지 개선 — 대시보드·라우터 기반 SPA에서 페이지가 "로드 완료"된 시점을 더 정확히 감지. 빈 화면에 클릭이 빠지는 사례 감소.
폼 입력과 제출 분리 — 입력 단계와 submit 단계가 별도 도구 호출로 분리되어, 사용자가 중간 값을 검토한 뒤 제출까지 진행할지 결정 가능.
멀티 탭 안정성 — 여러 탭이 동시에 열려도 컨텍스트가 섞이지 않음.
예상 소요 시간 — 단일 조작은 보통 2~5초, 다단계 흐름(로그인→검색→결과 추출)은 1~2분 예산을 잡으면 안전. 그보다 오래 걸리면 페이지가 비정상 응답일 가능성.

데이터 분석 활용

웹 기반 대시보드에서 데이터를 수집하거나, Jupyter Notebook의 실행 결과를 스크린샷으로 기록하거나, 웹 데이터 소스에서 정보를 스크래핑할 때 Browser Subagent가 유용합니다.

Browser Subagent 보안 주의사항:

프롬프트 인젝션: 악성 웹 페이지가 "지금 비밀번호를 삭제해줘"와 같은 명령을 페이지 본문에 숨겨놓을 수 있습니다. Browser Subagent는 페이지 내용을 그대로 에이전트에게 전달하므로, 신뢰하지 않는 사이트에서는 특히 주의하세요.
로그인 세션 주의: Browser Subagent는 Chrome의 현재 로그인 세션을 사용합니다. 금융 사이트, 회사 내부 시스템 등에서 에이전트 자동화를 사용할 때는 의도치 않은 작업이 실행될 수 있으므로 검토 요청 모드를 사용하세요.
브라우저 URL 허용 목록 사용: settings.json의 browserTool.allowedDomains에 접근 허용 도메인을 명시적으로 지정하면 의도치 않은 사이트 접근을 차단할 수 있습니다. (Harness Engineering 보안 레이어 참고)

Separate Chrome Profile — 개인 브라우징과 격리 공식 문서

Browser Subagent는 사용자의 일반 Chrome과 별도의 프로파일에서 동작합니다. 개인 브라우징 쿠키·로그인 정보가 에이전트에 노출되지 않고, 반대로 에이전트의 자동 로그인 상태도 개인 브라우징과 섞이지 않도록 분리된 영역을 사용합니다.

개인 Chrome vs Antigravity 프로파일 비교
관점	개인 Chrome	Antigravity 프로파일
사용 주체	본인	Browser Subagent (에이전트)
쿠키·세션	개인 로그인 그대로	에이전트 작업용 별도 세션. 첫 사용 시 빈 상태
지속성	일상 사용 계속 유지	한 번 로그인하면 다음 에이전트 세션에 그대로 이어짐
이력·자동완성	본인 검색 이력	에이전트가 방문한 페이지만 누적

실전 권장 사항

민감 계정은 분리 — 회사 메일·금융·관리자 콘솔처럼 자동 로그인이 위험한 사이트는 Antigravity 프로파일에 로그인하지 않습니다.
테스트용 계정 사용 — 에이전트가 자동 조작할 사이트는 테스트 전용 계정을 만들어 그 계정으로만 Antigravity 프로파일에서 로그인합니다.
프로파일 초기화 방법 — 에이전트 세션을 깨끗하게 만들고 싶다면 Browser Subagent 설정에서 프로파일 재설정 옵션을 사용합니다 (정확한 위치는 공식 문서 확인).

Browser Subagent View — 에이전트가 보고 있는 화면 공식 문서

Browser Subagent가 작업하는 동안 Antigravity는 해당 페이지의 실시간 화면을 별도 View에 표시합니다. 사용자는 에이전트가 어떤 요소를 클릭하고 어떤 입력을 하는지 보고 직접 개입하거나 중단할 수 있습니다.

View에서 확인할 수 있는 정보

현재 화면 스냅샷 — 에이전트가 보고 있는 페이지 상태
마우스·키보드 동작 표시 — 어떤 요소를 클릭·어떤 입력을 했는지 시각화 (커서 위치 강조, 입력 텍스트 표시)
액션 로그 — 시간 순으로 어떤 도구 호출이 일어났는지 한 줄씩 누적
개입 버튼 — Pause / Resume / Take Control / Cancel. 위험해 보이는 동작은 즉시 멈추고 사용자가 수동 조작

활용 팁: 처음 자동화를 만들 때는 View를 띄워두고 에이전트 동작을 관찰하세요. 무엇이 잘못되고 있는지 즉시 파악할 수 있고, "이 단계에서 더 명확한 지시가 필요하다"는 패턴을 발견하면 Rules·Workflows를 보강할 단서가 됩니다.

파란색 테두리 vs View — 차이

위에서 다룬 파란색 테두리 오버레이는 "지금 에이전트가 조작 중이니 사용자 입력을 막는다"는 시각 신호입니다. 반면 Browser Subagent View는 한 발 떨어져 동작을 모니터링하고 개입할 수 있는 별도 패널입니다. 둘은 함께 동작합니다.

도구 & 연동 (Tools & Integration)

MCP (Model Context Protocol) 공식 문서 #

핵심 기능 (Core Features)

1) Context Resources

2) Custom Tools

MCP 서버 설정 공식 문서 #

설정 파일 경로

설정 구조

사용 가능한 속성

MCP 서버 연결 5단계

MCP 인증 (Authentication) #

Google Credentials (ADC)

OAuth

GitHub MCP 서버 설정 가이드 #

설정 전체 흐름

Step 1: GitHub Personal Access Token (PAT) 생성

토큰 종류 비교

Fine-grained Token 생성 절차

권장 권한 설정

Step 2: MCP 설정 파일 작성

설정 파일 위치

GitHub MCP 서버 설정 추가

기존 MCP 서버가 있는 경우

설정 파일 구조 해부

Step 3: 연결 확인 및 테스트

연결 성공 시 사용 가능한 도구

자주 발생하는 오류와 해결 방법

Node.js 설치 확인

Step 4: 실전 활용 시나리오

📋 이슈 관리

🔀 PR 워크플로우

🔍 코드 검색

📁 저장소 관리

실전 예시: 이슈에서 PR까지 한 번에

지원 MCP 서버 (30+) #

Browser Subagent 공식 문서 #

첫 브라우저 작업 — 최초 설정 흐름

Chrome 확장 프로그램 설치 방법 (3가지)

Browser Subagent 도구 (Tools)

페이지 읽기 방식

주요 특징

파란색 테두리 오버레이

비포커스 탭 지원

Separate Chrome Profile — 개인 브라우징과 격리 공식 문서

실전 권장 사항

Browser Subagent View — 에이전트가 보고 있는 화면 공식 문서

View에서 확인할 수 있는 정보

파란색 테두리 vs View — 차이