[Antigravity] 구글 IDE에 내 '두뇌'를 심다: NotebookLM을 MCP 서버로 연결하는 법 (feat. uv)

 

최근 제 개발 환경의 가장 큰 화두는 단연 **'에이전트(Agent)'**입니다. 과거에는 VS Code에 코파일럿(Copilot) 하나 띄워두고 코드를 추천받는 수준이었다면, 구글이 작정하고 내놓은 **Agent-First IDE, 'Antigravity'**는 차원이 다릅니다. 이 녀석은 단순한 자동완성 도구가 아니라, 프로젝트의 맥락을 이해하고 주도적으로 제안하는 '파트너'에 가깝기 때문입니다.

하지만 아무리 똑똑한 AI라도, **'내 머릿속에 있는 기획'**이나 **'내가 모아둔 참고 자료'**까지 알 수는 없습니다. 그래서 우리는 매번 프롬프트 창에 긴 문서를 복사해서 붙여넣느라 시간을 허비하곤 했죠.

오늘 소개할 방법은 이 문제를 완벽하게 해결해 줍니다. 바로 Antigravity의 핵심인 **MCP(Model Context Protocol)**를 통해, 구글의 NotebookLM을 IDE와 뇌신경처럼 연결하는 것입니다. 이제 IDE가 내 노트북 속 자료를 직접 읽고 코딩하는, 진정한 '개인화 개발 환경'을 구축해 봅시다.

---

1. 왜 'NotebookLM'과 연결해야 할까요? (운영자의 시선)

많은 분들이 "그냥 챗GPT나 제미나이한테 물어보면 되지 않나요?"라고 묻습니다. 하지만 제가 직접 써본 경험상, 범용 LLM과 NotebookLM이 연결된 에이전트는 질적으로 다릅니다.

• RAG(검색 증강 생성)의 끝판왕: NotebookLM은 내가 업로드한 PDF, 문서, 웹사이트 링크만을 기반으로 답변합니다. 즉, 인터넷의 불필요한 정보(환각)를 배제하고, 오직 **'내 기획 의도'**에 맞춰 코드를 짜줍니다.
• 복사-붙여넣기 해방: 예전에는 '호텔 에이전트 기획안.pdf' 내용을 AI에게 먹이기 위해 텍스트를 긁어오느라 고생했습니다. 하지만 MCP로 연결하면, Antigravity 채팅창에서 "@notebooklm 호텔 기획안 참고해서 클래스 구조 잡아줘" 한마디면 끝납니다.
• 보안과 맥락: 내 로컬 자료가 외부로 유출될 걱정 없이, 구글의 보안 환경 안에서 안전하게 맥락을 유지할 수 있습니다.

---

2. 시작 전 준비사항 (준비물)

성공적인 연결을 위해 딱 3가지가 필요합니다.

1. Antigravity IDE: 최신 버전(v1.15.6 이상)을 권장합니다. 에이전트 기능이 계속 업데이트되고 있기 때문입니다.
2. uv (필수 권장): 이전 포스팅에서도 강조했듯, 파이썬 패키지 관리는 uv가 답입니다. 이번 연동에서도 복잡한 설치 없이 uv tool run 기능을 활용해 서버를 띄울 것입니다.
3. Google Cookie 값: 현재 NotebookLM MCP 서버는 비공식 오픈소스를 활용하므로, 본인 계정 인증을 위한 쿠키 값이 필요합니다.
   • 추출법: 크롬에서 NotebookLM 사이트 접속 → F12 (개발자 도구) → Application 탭 → Cookies → https://notebooklm.google.com 선택 → __Secure-1PSID 항목의 값을 복사해 두세요.

---

3. 연결 방법 1: UI로 간편하게 (초보자 추천)

Antigravity는 사용자 친화적인 UI를 제공합니다. 복잡한 코드가 두려우신 분들은 이 방법을 쓰세요.

1. Antigravity 에디터를 열고 좌측(또는 우측)의 **Agent 패널(채팅창)**을 엽니다.
2. 채팅 입력창 상단의 입력 도구 중 ... (더 보기) 아이콘을 클릭합니다.
3. Manage MCP Servers 또는 Configure MCP 메뉴를 선택합니다.
4. 설정 편집 창이 뜨면, 아래에 소개할 JSON 설정 코드를 입력하고 저장하면 됩니다.

---

4. 연결 방법 2: 프로젝트 설정 파일 직접 수정 (운영자 추천)

저는 프로젝트마다 다른 MCP 서버를 쓰는 것을 선호해서, 설정 파일을 직접 만지는 방법을 더 즐겨 씁니다. Antigravity는 .idx라는 숨겨진 폴더에서 설정을 관리합니다.

• 파일 경로: 프로젝트 루트 폴더 안의 .idx/mcp.json (파일이 없다면 새로 만드세요)

아래 코드를 복사해서 붙여넣습니다. 여기서 uv의 진가가 발휘됩니다.

JSON

 

{
  "mcpServers": {
    "notebooklm": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "notebooklm-mcp-server" // 설치 없이 즉시 실행!
      ],
      "env": {
        "GOOGLE_COOKIE": "여기에_아까_복사한_Secure-1PSID_값을_넣으세요"
      }
    }
  }
}

💡 운영자의 Tip: 왜 uv 인가요?

만약 uv를 안 쓴다면 어떻게 될까요? 먼저 터미널에서 pip install notebooklm-mcp-server를 입력해 패키지를 설치해야 하고, command 항목에는 복잡한 파이썬 실행 경로(/usr/bin/python3 등)를, args에는 스크립트 파일의 절대 경로를 적어야 합니다.

하지만 uv를 쓰면 위 설정처럼 "uv", "tool", "run" 딱 세 단어로 끝납니다. **"이 서버를 내 컴퓨터에 영구 설치하지 말고, IDE가 켜질 때만 잠시 실행해 줘"**라는 의미죠. 의존성 꼬임 없이 깔끔 그 자체입니다.

---

5. 연결 확인 및 실전 활용 가이드

설정 파일을 저장했다면, Antigravity 창을 한 번 Reload(새로고침, Ctrl+R / Cmd+R) 해주세요. 서버가 재시작되면서 NotebookLM과 연결을 시도합니다.

이제 에이전트 채팅창으로 가서 테스트해 봅시다.

1) 연결 확인 (@ 멘션) 채팅창에 @를 입력해 보세요. 목록에 NotebookLM이 뜬다면 성공입니다!

2) 실전 사용 예시 (호텔 에이전트 프로젝트) 제가 최근 기획 중인 '호텔 예약 자동화 에이전트'를 예로 들어보겠습니다. 저는 이미 NotebookLM에 호텔 관련 API 문서와 기획안 PDF를 올려두었습니다.

• 질문: "@notebooklm 내 노트북에 있는 '호텔 API 명세서'를 참고해서, 예약 가능 여부를 확인하는 파이썬 함수를 짜줘."
• 결과: 놀랍게도 Antigravity는 일반적인 코드가 아니라, 제 PDF 문서에 적힌 특정 필드명(예: room_availability_status)을 정확히 사용해서 코드를 작성해 줍니다.

---

6. 운영자(JUN)의 솔직한 사용 후기와 해석

처음 이 환경을 구축하고 느낀 감정은 **'전율'**이었습니다.

지금까지 우리는 코딩을 할 때 '코드'와 '문서'가 분리되어 있었습니다. 모니터 왼쪽에는 PDF를 띄우고, 오른쪽에는 코드를 띄우고 눈으로 번갈아 보며 작업했죠. 하지만 Antigravity와 NotebookLM이 MCP로 연결되는 순간, IDE가 문서를 '읽고' 이해하는 상태가 됩니다.

제가 느낀 장단점은 명확합니다.

👍 장점:

1. 압도적인 생산성: 내가 만든 기획 의도를 AI에게 설명할 필요가 없습니다. "기획안대로 해줘" 한마디면 됩니다.
2. uv와의 환상적인 궁합: uv tool run 덕분에 무거운 서버 프로그램을 내 컴퓨터에 깔지 않고도 가볍게 연동할 수 있습니다. 60대인 제 컴퓨터도 쌩쌩하게 돌아갑니다.

👎 단점 및 주의사항:

1. 쿠키 만료 문제: 구글 로그인이 풀리면 쿠키 값도 바뀝니다. 갑자기 연결이 안 되면 십중팔구 쿠키 문제입니다. 귀찮더라도 값을 갱신해줘야 합니다. (비공식의 한계입니다.)
2. 속도: 로컬 자료를 검색(Retrieval)해서 가져오는 과정 때문에, 일반적인 챗봇보다 답변이 1~2초 정도 느릴 수 있습니다. 하지만 그 기다림은 '정확성'으로 보상받습니다.

---

🛠 마치며: 트러블슈팅 요약

혹시 따라 하시다가 막히시나요? 가장 흔한 원인 2가지만 기억하세요.

1. 연결 실패: GOOGLE_COOKIE 값이 만료되었을 확률 99%입니다. 시크릿 모드에서 다시 로그인해서 __Secure-1PSID 값을 새로 받아보세요.
2. 명령어 오류: 터미널에서 uv --version을 쳤을 때 버전이 나오는지 확인하세요. uv가 없다면 아무것도 실행되지 않습니다.

Antigravity라는 이름처럼, 여러분의 코딩 생산성이 중력을 거슬러 날아오르길 바랍니다. NotebookLM이라는 든든한 '두뇌'를 장착하고 말이죠!

---