Antigravity NotebookLM MCP 설치 완벽 가이드 : 나만의 지식 보관소를 AI와 연결하는 법

 

Antigravity NotebookLM MCP 설치 완벽 가이드 : 나만의 지식 보관소를 AI와 연결하는 법

왜 NotebookLM MCP인가?

수집광들의 고질적인 병, '자료는 많은데 활용을 못 한다'는 점이죠. 구글 NotebookLM에 논문, 기사, 아티클을 잔뜩 넣어두고 정작 AI와 대화할 때는 다시 그 내용을 긁어오거나 파일을 찾아 올려야 했습니다.

하지만 이제 MCP(Model Context Protocol)의 시대입니다. 내 로컬 환경의 AI 에이전트(Claude Desktop, Antigravity 등)가 직접 NotebookLM의 문을 열고 들어가 자료를 열람할 수 있다면 어떨까요?

오늘은 그 연결 고리인 NotebookLM MCP Server를 설치하고 설정하는 과정을, 제가 직접 겪은 시행착오까지 포함해 아주 쉽게, A to Z로 알려드리겠습니다. 특히 최신 패키지 매니저인 uv를 활용한 깔끔한 설치법입니다.



1. 설치 전 준비 (실행)

가장 먼저 파이썬 패키지 매니저인 uv가 필요합니다. (물론 pip도 되지만, uv가 훨씬 빠르고 환경 관리가 깔끔합니다.)

터미널을 열고 설치 여부를 확인해 주세요.

uv --version

없다면 brew install uv 등으로 먼저 설치해 주시면 됩니다.

2. 핵심 설치 및 오류 해결 (통찰 & 실행)

많은 분들이 여기서 헤맵니다. 단순히 패키지 이름만 알면 설치될 줄 알았는데, 실행 파일 이름이 달라서 오류가 나곤 하죠.

1. 패키지 설치

uv tool install notebooklm-mcp-server

2. 인증 (가장 중요한 단계)

설치 후 바로 실행하면 오류가 납니다. 인증이 필요하기 때문이죠. 그런데 여기서 주의할 점! notebooklm-mcp-server 패키지는 notebooklm-mcp와 notebooklm-mcp-auth라는 두 개의 실행 파일을 제공합니다. 그냥 실행하면 찾지 못한다는 에러가 뜰 수 있습니다.

✅ 해결 명령어:

uv tool run --from notebooklm-mcp-server notebooklm-mcp-auth

이 명령어를 입력하면 브라우저가 열리고 구글 계정 인증 창이 뜹니다. 권한을 허용해 주세요.

3. 설정 파일 연결 (실행)

이제 문은 열렸으니, AI 에이전트에게 "여기로 들어오면 돼"라고 주소를 알려줘야 합니다. ~/.gemini/antigravity/mcp_config.json 또는 사용하시는 에이전트의 MCP 설정 파일(mcp_config.json)을 엽니다.

{
  "mcpServers": {
    "notebooklm": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "notebooklm-mcp-server",
        "notebooklm-mcp"
      ]
    }
  }
}

위 코드를 mcpServers 항목 안에 추가해 주세요. Antigravity나 다른 에이전트들도 이 설정을 참고하여 NotebookLM과 통신하게 됩니다.

4. 연결 확인 및 활용 (플러스 요소)

설정을 저장하고 에이전트를 재시작한 뒤, 채팅창에 이렇게 물어보세요.

"내 NotebookLM에 어떤 노트북들이 있어?"

에이전트가 내 구글 계정의 노트북 목록을 주르륵 불러온다면 성공입니다! 이제 "00 프로젝트 노트북의 내용을 요약해줘"라고 시키면, 에이전트가 알아서 그 방대한 자료를 읽고 답변을 내놓을 것입니다.

여러분의 제2의 두뇌가 진짜로 '작동'하기 시작하는 순간입니다.
|
지금 바로 터미널을 열고 연결해 보세요!


Antigravity 에서 입력

Install and set up the NotebookLM MCP server for me:
1. Install the notebooklm-mcp-server package using uv (or pip if uv isn't available)
2. Add it to my MCP configuration file (usually at ~/.config/opencode/opencode.json or similar)
3. Run the authentication command (notebooklm-mcp-auth) and open a browser to authorize it
4. Verify the installation is working by listing my NotebookLM notebooks
Make sure to:
• Use the correct installation method for my system
• Configure the MCP server properly in my config file
• Guide me through the browser authentication process
• Confirm everything is working at the end


허용 및 설치


구글 인증


설치 및 인증 후 MCP Servers 


Antigravity 종료 후 다시 실행 ( 클로드가 아니고 antigravity에서 실행하는 거라고 꼭 해야 함 )



오류로그를 다시 antigravity에 수정요청


Refresh를 클릭하면 notebooklm 를 확인할 수 있음



NotebookLM #MCP #Antigravity #AI에이전트 #생산성 #개발자팁 #Mac설정 #uv




다음 이전