[TIP]Antigravity MCP 설정 가이드

Antigravity AI Agent는 Cursor, Claude Code와 유사한 AI 코딩 에이전트로, MCP(Model Context Protocol)를 통해 외부 도구와 서버를 연동할 수 있습니다.

"AI 에이전트의 가능성을 무한대로 확장하세요"

MCP를 통해 Antigravity AI Agent는 문서 검색(Context7), 복잡한 분석(Sequential Thinking), 브라우저 자동화(Playwright), UI 컴포넌트 생성(Shadcn) 등 다양한 기능을 활용할 수 있습니다.

---

🔄 MCP 설정 방식

Antigravity AI Agent에서 MCP를 추가하는 방법은 두 가지가 있습니다:

방식	장점	사용 경우
UI 설정	간편하고 빠름	공식 MCP Store에 있는 서버
JSON 설정	완전한 커스터마이징	커스텀 MCP, 특정 버전 필요

---

📖 상세 가이드

방법 1: UI 기반 MCP Store 설치

Antigravity AI Agent에서 제공하는 MCP Store를 통해 간편하게 설치할 수 있습니다.

Step 1: MCP Servers 메뉴 열기

1. Antigravity AI Agent 우측 상단 … 버튼 클릭
2. MCP Servers 클릭

Step 2: MCP Store에서 설치

MCP Store에 있는 Antigravity에서 공식 지원하는 MCP 서버를 바로 설치할 수 있습니다.

MCP 서버	기능
Context7	공식 라이브러리 문서 검색
Sequential Thinking	복잡한 다단계 분석
Playwright	브라우저 자동화 및 테스트
Shadcn	UI 컴포넌트 생성
Chrome DevTools	브라우저 개발자 도구 연동

---

방법 2: JSON 설정 파일 통한 커스텀 MCP 추가

Cursor, Claude Code처럼 직접 JSON 형식으로 원하는 MCP를 추가할 수 있습니다.

Step 1: Manage MCP Servers 클릭

1. Antigravity AI Agent 우측 상단 … 버튼 클릭
2. Manage MCP Servers 클릭

Step 2: View raw config 클릭

설정 편집 모드로 진입합니다.

Step 3: JSON 형식으로 MCP 추가

기존에 Cursor 및 Claude Code에서 사용하던 JSON 형식과 동일하게 MCP 서버를 추가할 수 있습니다.

MCP 설정 JSON 예시:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    },
    "shadcn": {
      "command": "npx",
      "args": [
        "shadcn@latest",
        "mcp"
      ]
    },
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest"
      ]
    }
  }
}

Step 4: 저장 및 확인

JSON을 추가하면 즉시 MCP 서버가 활성화됩니다.

---

방법 3: 프로젝트별 MCP 설정

프로젝트마다 다른 MCP 설정을 적용하고 싶다면 프로젝트 루트 폴더에 mcp_config.json 파일을 생성하세요.

프로젝트별 설정 파일:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "project-specific-mcp": {
      "command": "node",
      "args": ["./scripts/custom-mcp.js"]
    }
  }
}

---

📊 MCP 서버 참조

MCP 서버	명령어	주요 기능
Context7	npx -y @upstash/context7-mcp@latest	라이브러리 문서 검색
Sequential Thinking	npx -y @modelcontextprotocol/server-sequential-thinking	복잡한 문제 분석
Playwright	npx @playwright/mcp@latest	브라우저 자동화
Shadcn	npx shadcn@latest mcp	UI 컴포넌트 생성
Chrome DevTools	npx -y chrome-devtools-mcp@latest	브라우저 개발자 도구

---

✨ 활용 팁

1. 버전 고정: 프로덕션 환경에서는 @latest 대신 특정 버전을 지정하세요

   "args": ["-y", "@upstash/context7-mcp@1.2.3"]
   

2. 프로젝트별 설정: 팀 프로젝트에서는 mcp_config.json을 Git으로 관리하세요

3. MCP 순서: 자주 사용하는 MCP를 상단에 배치하여 로딩 속도 최적화

4. 디버깅: MCP가 로드되지 않으면 npx 명령어를 터미널에서 직접 테스트해보세요

---

🛠️ Troubleshooting

문제	원인	해결 방법
MCP가 로드되지 않음	npx 실행 권한 문제	터미널에서 직접 npx 명령어 테스트
특정 MCP만 작동 안 함	버전 충돌	해당 MCP만 특정 버전으로 고정
프로젝트 설정이 안 됨	파일 위치 오류	mcp_config.json이 프로젝트 루트에 있는지 확인
JSON 문법 오류	콤나나 괄호 누락	JSON validator로 문법 확인

---

📚 추가 리소스

• Antigravity AI Agent 공식 문서 - MCP 설정 가이드
• Model Context Protocol 사양 - MCP 표준 문서
• Upstash Context7 - Context7 문서
• MCP Servers Hub - 공식 MCP 서버 목록

---

★ Insight ─────────────────────────────────────

• MCP(Model Context Protocol): AI 에이전트와 외부 도구 간의 표준 통신 프로토콜로, 플랫폼 독립적인 확장성 제공
• npx -y 플래그: 확인 프롬프트 건너뛰기로 CI/CD 파이프라인이나 자동화 스크립트에 필수
• 프로젝트별 설정: mcp_config.json을 통한 설정 분리는 팀 협업 시 일관된 MCP 환경 보장
  ─────────────────────────────────────────────────

---

⚠️ 면책 조항

본 가이드를 따르면서 발생하는 모든 결과에 대한 책임은 전적으로 사용자 본인에게 있습니다. 이 문서는 참고용으로 제공되며, 작성자는 어떠한 손해나 문제에 대해 책임지지 않습니다.

금지 사항:

• 본 내용을 악의적인 목적으로 사용하는 것을 엄격히 금지합니다.
• 타인의 권리를 침해하거나 불법적인 활동에 사용하는 것을 금지합니다.
• 상업적 목적의 무단 복제나 재배포를 금지합니다.

본 가이드의 내용은 학습 및 교육 목적으로만 사용해야 합니다.