AI 도구를 여러 개 사용하다 보면 이런 불편함이 생깁니다.
NotebookLM에는 PDF와 기술 문서가 들어 있고, Notion에는 프로젝트 일정과 회의록이 있으며, 개발 작업은 Google Antigravity에서 진행합니다. 그런데 실제 업무를 하려면 세 프로그램을 오가면서 자료를 복사하고 붙여넣어야 합니다.
이 문제를 해결하는 핵심 기술이 **MCP(Model Context Protocol)**입니다.
MCP를 활용하면 AI 개발 환경에서 외부 도구의 데이터와 기능을 호출할 수 있습니다. 예를 들어 Antigravity에서 Notion의 프로젝트 문서를 검색하고, NotebookLM의 연구 자료를 참고해 개발 계획서를 작성하는 워크플로를 설계할 수 있습니다.
다만 중요한 차이가 있습니다. Notion은 공식 MCP 연동 경로를 제공하지만, NotebookLM은 연결 방식과 지원 범위를 별도로 확인해야 합니다. 특히 커뮤니티에서 만든 NotebookLM MCP 서버는 공식 Google 서비스와 동일한 안정성이나 보안 보장을 제공한다고 볼 수 없습니다.
이번 글에서는 이 차이를 분명히 구분하면서 설치, 연결, 테스트, 활용 사례와 보안 주의사항을 정리하겠습니다.
1. 세 가지 도구의 역할부터 이해하자

Google Antigravity :개발 및 자동화 작업을 지휘하는 AI 에이전트 환경

NotebookLM: PDF·문서·웹 자료를 바탕으로 연구하고 분석

Notion: 업무 결과, 프로젝트 일정 및 지식을 체계적으로 저장
세 도구를 한 문장으로 정리하면 Antigravity는 실행하고, NotebookLM은 자료를 연구하며, Notion은 결과를 관리합니다.
MCP는 이 세 기능을 연결하는 통신 규약입니다. MCP 서버가 제공하는 도구를 AI 에이전트가 호출하는 구조이므로, 사용자가 매번 자료를 복사할 필요가 줄어듭니다.
2. 전체 시스템 아키텍처
사용자
“기술 자료를 정리하고 개발 계획서를 만들어 줘”
Google Antigravity
MCP 클라이언트 · AI 에이전트 · 개발 작업
NotebookLM MCP
커뮤니티 연결
자료 검색 · 노트북 질의 · 소스 관리
Notion MCP
공식 연결
문서 검색 · 페이지 생성 · 업무 업데이트
개발 문서 · 분석 결과 · 프로젝트 업무 관리
이 구조에서 Antigravity는 MCP 클라이언트 역할을 합니다. Notion과 NotebookLM 측은 각각의 MCP 서버를 통해 도구 기능을 제공합니다.
다만 NotebookLM의 연결에는 두 가지 다른 선택지가 존재합니다.
| 구분 | NotebookLM 커뮤니티 MCP | Google Gemini Notebook 공식 MCP |
|---|---|---|
| 제공 주체 | 외부 오픈소스 개발자 | |
| 인증 | 구현에 따라 브라우저 로그인·세션 사용 | Google OAuth |
| NotebookLM 채팅 질의 | 구현에 따라 지원 | 현재 공개된 도구 목록에는 없음 |
| 노트북·소스 관리 | 구현에 따라 지원 | 공식 지원 |
| 안정성 | 비공식 인터페이스 변경에 영향 | 공식 Public Preview |
| 권장 용도 | 기존 NotebookLM 연구 내용 활용 | 공식 API 기반 노트북·소스 자동화 |
중요한 최신 변화: Google은 별도로 Gemini Notebook API 및 공식 MCP 서버를 공개했습니다. 공식 엔드포인트는 https://notebook.googleapis.com/mcp입니다. 다만 현재 제공하는 기능은 노트북 생성·조회와 소스 추가·조회 중심이며, 일반 NotebookLM의 대화 기능 전체를 MCP로 제공하는 것은 아닙니다. 현재 Public Preview이고 개인 Google 계정 중심으로 제공됩니다. Google for Developers+1
따라서 이 글에서는 기존 NotebookLM 노트북을 AI가 직접 질의하는 방법은 커뮤니티 MCP, 공식적으로 노트북과 자료를 관리하는 방법은 Google의 MCP로 나누어 설명합니다.
3. Google Antigravity에서 MCP 설정하기
Antigravity는 MCP 서버를 추가할 수 있는 기능을 기본 제공합니다.
Antigravity IDE를 사용하는 경우 다음 순서로 접근합니다.
- Antigravity를 실행하고 Agent 패널을 엽니다.
- 상단의
…메뉴에서 MCP Servers를 선택합니다. - Manage MCP Servers로 이동합니다.
- View raw config를 선택합니다.
- MCP 서버 설정을 추가하고 연결 상태를 확인합니다.
공식 문서에 따르면 전역 설정 파일은 다음 경로입니다. Google Antigravity Docs
~/.gemini/config/mcp_config.json
프로젝트별 설정 파일은 다음과 같습니다.
<프로젝트 폴더>/.agents/mcp_config.json
Windows 환경에서도 사용자 홈 디렉터리 아래의 해당 설정 경로를 사용합니다.
Antigravity App에서는 Settings → Customizations → Installed MCP Servers에서 서버를 관리할 수 있습니다. IDE와 App 버전에 따라 메뉴 위치는 조금 다를 수 있습니다.
MCP 설정 파일의 기본 구조
{
"mcpServers": {
"server-name": {
"serverUrl": "https://example.com/mcp"
}
}
}
로컬 MCP 서버는 command와 args를 사용하고, 원격 MCP 서버는 serverUrl을 사용합니다.
4. Notion 공식 MCP 연결하기
먼저 비교적 간단한 Notion부터 연결해 보겠습니다.
Notion은 공식 원격 MCP 서버를 제공합니다.
Notion 공식 MCP 엔드포인트
Notion 공식 MCP는 Streamable HTTP와 OAuth 인증을 사용합니다. 사용자가 접근 권한을 가진 Notion 콘텐츠를 검색하고, 읽고, 생성하거나 수정할 수 있습니다. GitHub
4-1. MCP 설정 파일 작성
Antigravity의 mcp_config.json에 다음을 추가합니다.
{
"mcpServers": {
"notion": {
"serverUrl": "https://mcp.notion.com/mcp"
}
}
}
기존에 다른 MCP 서버가 있다면 mcpServers 내부에 notion 항목만 추가해야 합니다. 기존 설정을 덮어쓰지 않도록 주의합니다.
4-2. Notion 인증
설정을 저장한 뒤 MCP 서버 목록을 새로고침합니다.
Notion 서버가 나타나면 인증을 진행합니다.
Antigravity의 인증 메뉴에서 Authenticate를 선택하고 브라우저에 표시되는 Notion 로그인 및 권한 승인 절차를 완료합니다.
Antigravity 공식 문서는 OAuth 인증 시 브라우저에서 발급되는 인증 코드를 IDE에 입력하는 절차를 안내합니다. Google Antigravity Docs
4-3. 연결 테스트
Antigravity의 Agent 창에서 다음과 같이 요청합니다.
“Notion에서 내가 접근할 수 있는 프로젝트 관련 페이지를 검색해 줘. 아직 어떤 페이지도 수정하지 마.”
검색 결과가 반환되면 기본 읽기 연결을 확인할 수 있습니다.
다음 단계로 테스트 페이지를 하나 생성해 볼 수 있습니다.
“Notion의 테스트용 페이지 아래에 ‘Antigravity MCP 연결 테스트’라는 새 페이지를 만들어 줘. 내용에는 오늘 연결 테스트가 완료되었다고 기록해 줘. 생성 전에 대상 위치를 확인해 줘.”
이렇게 하면 읽기와 쓰기 기능을 구분해서 검증할 수 있습니다.
5. NotebookLM MCP 연결하기 — 커뮤니티 오픈소스 방식
이번에는 기존 NotebookLM에 저장한 노트북과 자료를 Antigravity에서 활용하는 방법입니다.
이 기능을 위해 사용할 수 있는 커뮤니티 프로젝트 중 하나는 **notebooklm-py**입니다. 해당 프로젝트는 NotebookLM CLI와 실험적인 MCP 서버를 제공하며, 노트북·소스 관리, 노트북에 대한 질문, 일부 생성 결과물 관리 기능을 문서화하고 있습니다. GitHub
이 프로젝트는 Google의 공식 NotebookLM API가 아닙니다. 브라우저 로그인 세션과 비공식 인터페이스에 의존할 수 있으므로 변경에 취약하며, 계정 보안과 서비스 정책을 검토해야 합니다.
5-1. 사전 준비
Ubuntu를 기준으로 설명하겠습니다.
sudo apt update
sudo apt install -y \
python3 \
python3-venv \
python3-pip \
curl
Python 패키지 실행을 편리하게 관리하려면 uv를 사용할 수 있습니다.
공식 설치 안내를 참고해 uv를 설치한 뒤 다음 명령으로 확인합니다.
uvx --version
uvx는 Python 기반 도구를 격리된 환경에서 실행하는 명령입니다.
5-2. NotebookLM MCP 패키지 확인
커뮤니티 프로젝트는 다음 GitHub 저장소에서 확인할 수 있습니다.NotebookLM 커뮤니티 MCP 프로젝트 및 사용 설명서
설치 전에 README, 최근 업데이트, 인증 방식, 의존성 및 보안 이슈를 검토합니다.
프로젝트 문서에서 안내하는 MCP 실행 명령은 다음과 같습니다.
uvx --from "notebooklm-py[mcp]" \
notebooklm-mcp --help
직접 Python 환경에 설치하는 방식도 있습니다.
python3 -m venv ~/venvs/notebooklm
source ~/venvs/notebooklm/bin/activate
python -m pip install \
"notebooklm-py[mcp]"
설치 후 로그인합니다.
notebooklm login
이 과정에서 브라우저를 이용한 Google 계정 인증이 필요할 수 있습니다.
인증 데이터는 로컬 사용자 프로필에 저장됩니다. 인증 파일이나 브라우저 세션을 다른 사람에게 전달해서는 안 됩니다.
5-3. Antigravity MCP 설정
설정 파일을 열어 다음 항목을 추가합니다.
{
"mcpServers": {
"notebooklm": {
"command": "uvx",
"args": [
"--from",
"notebooklm-py[mcp]",
"notebooklm-mcp"
]
}
}
}
Antigravity는 로컬 프로세스를 stdio 방식으로 실행해 MCP 서버와 통신합니다.
이 예시는 uvx가 실행 경로에 등록되어 있고, 해당 사용자 계정에서 NotebookLM 인증이 완료되었다는 전제입니다.
환경에 따라 실행 파일의 절대 경로를 지정해야 할 수도 있습니다.
which uvx
예를 들어 /home/user/.local/bin/uvx가 출력되었다면 command에 해당 경로를 지정할 수 있습니다.
5-4. NotebookLM 연결 테스트
Antigravity의 MCP 서버 목록에서 NotebookLM 서버가 연결됐는지 확인합니다.
그다음 Agent에게 다음과 같이 요청합니다.
“NotebookLM MCP에서 사용할 수 있는 도구 목록을 확인하고, 내가 접근할 수 있는 노트북 목록을 보여 줘. 내용을 수정하지는 마.”
연결된 서버의 실제 도구 이름과 사용 가능한 기능은 설치한 프로젝트 버전에 따라 다를 수 있습니다.
노트북 목록이 정상적으로 표시되면 다음 단계로 진행합니다.
“NotebookLM의 ‘AI 로봇 기술 조사’ 노트북을 찾아 주요 자료를 요약해 줘. 확인되지 않은 내용은 추측하지 말고, 가능하면 원본 자료를 표시해 줘.”
이 과정에서 Antigravity가 NotebookLM MCP 도구를 호출하고, 반환된 결과를 바탕으로 답변을 생성하도록 구성할 수 있습니다.
단, AI가 작성한 요약에 원문 출처가 정확히 반영되었는지는 반드시 확인해야 합니다.
6. Google 공식 Gemini Notebook MCP 연결하기
기업이나 장기 운영 환경에서는 공식 API 사용 여부가 중요합니다.
Google은 Gemini Notebook API와 원격 MCP 서버를 공개했습니다. 현재 공식 문서에서 안내하는 서버 주소는 다음과 같습니다.
https://notebook.googleapis.com/mcp
현재 공개된 주요 도구는 다음과 같습니다. Google for Developers
| 도구 | 기능 |
|---|---|
create_notebook | 새 노트북 생성 |
list_notebooks | 노트북 목록 조회 |
get_notebook | 노트북 정보 조회 |
update_notebook | 노트북 이름 변경 |
create_source | 웹·YouTube·텍스트·Markdown 자료 추가 |
list_sources | 노트북 소스 목록 조회 |
get_source | 소스 정보 및 처리 상태 조회 |
현재 문서화된 범위에는 기존 NotebookLM의 자유로운 질의응답 기능이나 오디오 개요 생성 기능이 포함되어 있지 않습니다.
6-1. Google Cloud 설정
Google Cloud CLI가 설치되어 있다고 가정하겠습니다.
프로젝트 ID를 지정합니다.
export PROJECT_ID="your-google-cloud-project"
API를 활성화합니다.
gcloud services enable notebook.googleapis.com \
--project="$PROJECT_ID"
이어서 필요한 OAuth 범위로 로그인합니다.
gcloud auth application-default login \
--scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/notebook"
공식 문서에 따르면 현재 Preview에서는 개인 Google 계정이 필요하며, 해당 계정으로 Gemini Notebook에 한 번 이상 로그인한 상태여야 합니다. Google Workspace 계정은 아직 지원 대상이 아닙니다. Google for Developers
6-2. 액세스 토큰 발급
ACCESS_TOKEN=$(
gcloud auth application-default print-access-token
)
발급한 토큰은 일반적으로 약 1시간 후 만료되므로 장기 운영에서는 토큰 갱신을 고려해야 합니다.
6-3. Antigravity에 등록
다음은 공식 Google Notebook MCP의 기본 연결 구조입니다.
{
"mcpServers": {
"gemini-notebook-api": {
"serverUrl": "https://notebook.googleapis.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"x-goog-user-project": "YOUR_PROJECT_ID"
}
}
}
}
실제 설정 시 YOUR_ACCESS_TOKEN과 YOUR_PROJECT_ID를 자신의 값으로 변경합니다.
이 예시는 연결 구조를 확인하기 위한 단기 테스트 설정입니다. 액세스 토큰을 설정 파일에 영구적으로 기록하거나 Git에 올리는 것은 권장하지 않습니다.
장기 운영 시에는 인증 갱신을 지원하는 클라이언트 또는 별도의 안전한 토큰 관리 방식을 사용해야 합니다.
공식 Google 문서는 해당 MCP 서버가 Streamable HTTP 방식으로 동작하며 Authorization과 x-goog-user-project 헤더를 사용한다고 안내합니다. Google for Developers
7. 세 가지 도구를 하나의 MCP 설정으로 통합하기
이제 Notion과 NotebookLM을 하나의 Antigravity 환경에 연결해 보겠습니다.
기존 NotebookLM 노트북에 질문해야 한다면 커뮤니티 MCP를 사용하고, Notion은 공식 MCP를 사용합니다.
다음은 통합 설정 예시입니다.
{
"mcpServers": {
"notion": {
"serverUrl": "https://mcp.notion.com/mcp"
},
"notebooklm": {
"command": "uvx",
"args": [
"--from",
"notebooklm-py[mcp]",
"notebooklm-mcp"
]
}
}
}
설정 경로:
~/.gemini/config/mcp_config.json
또는 프로젝트별로:
프로젝트/.agents/mcp_config.json
설정을 저장한 후 Antigravity의 MCP 관리 화면에서 서버를 새로고침합니다.
정상적인 구성이라면 두 서버의 연결 상태와 도구 목록을 확인할 수 있습니다.
연결 점검 순서
설정 검증
0/6Notion MCP 서버가 표시되는지 확인Notion OAuth 인증 완료Notion 페이지 읽기 테스트NotebookLM 로컬 MCP 프로세스 실행 확인NotebookLM 노트북 목록 조회두 서비스의 결과를 한 요청에서 함께 활용
연결이 확인되었다면 실제 업무 자동화를 시작할 수 있습니다.
8. 실무 활용 사례 — 기술 자료 분석부터 Notion 보고서 작성까지
예를 들어 자동차 부품 제조업체에서 AI 기반 고무제품 외관검사 시스템을 검토한다고 가정하겠습니다.
NotebookLM에는 YOLO 관련 논문, 카메라 사양서, 조명 기술 문서, 검사 기준서 등을 정리해 두었습니다.
Notion에는 프로젝트 일정, 담당자, 개발 이력, 검토 결과를 관리합니다.
Antigravity는 이 두 시스템을 연결해 개발 작업을 진행합니다.
NotebookLM — 기술 자료 저장소
논문 · 사양서 · 검사 기준 · 연구 자료
Antigravity — AI 개발 에이전트
자료 분석 · 설계서 작성 · 코드 생성 · 테스트
Notion — 프로젝트 관리
요구사항 · 업무 일정 · 개발 결과 · 개선 이력
활용 사례 A. NotebookLM 자료로 개발 요구사항 작성
Antigravity에 다음 프롬프트를 입력합니다.
실습 프롬프트 ①
NotebookLM의 ‘고무제품 AI 외관검사’ 노트북을 검색해 줘.
1. 사용된 카메라와 조명 기술을 정리해.
2. YOLO 기반 결함 검출의 장단점을 비교해.
3. 실제 제조 현장에서 고려해야 할 문제를 분석해.
4. 기능 요구사항과 비기능 요구사항을 작성해.
5. 확인된 자료와 AI의 제안을 구분해.
아직 Notion에는 저장하지 말고 결과를 먼저 보여 줘.
프롬프트 복사
이렇게 하면 자료 조사와 요구사항 분석을 연결할 수 있습니다.
활용 사례 B. 분석 결과를 Notion에 저장
요구사항 검토가 끝났다면 다음 단계로 넘어갑니다.
실습 프롬프트 ②
방금 작성한 요구사항 분석 결과를
Notion의 ‘AI 외관검사 프로젝트’ 페이지 아래에
‘기술 요구사항 분석’이라는 새 페이지로 저장해 줘.
다음 구조를 사용해.
– 프로젝트 개요
– 핵심 기술 요구사항
– 시스템 아키텍처
– 주요 위험요소
– 검증이 필요한 항목
– 참고 자료
새 페이지의 위치와 저장할 내용을
먼저 보여 주고 내 승인을 받은 후 생성해.
프롬프트 복사
이 방식에서는 Antigravity가 NotebookLM에서 받은 결과를 정리한 뒤 Notion MCP를 호출해 페이지를 생성합니다.
단, Notion에서 실제 페이지를 생성하려면 연결된 계정에 해당 위치의 편집 권한이 있어야 합니다.
활용 사례 C. Notion의 개발 과제를 코드로 연결
Notion에 다음과 같은 프로젝트 업무가 있다고 가정하겠습니다.
| 작업 | 담당 | 상태 |
|---|---|---|
| 카메라 이미지 수집 | 개발팀 | 진행 중 |
| YOLO 학습 데이터 정리 | AI팀 | 대기 |
| 결함 검출 API 개발 | 개발팀 | 대기 |
| MES 인터페이스 개발 | IT팀 | 대기 |
| 성능 검증 | 품질팀 | 대기 |
Antigravity에 다음과 같이 요청할 수 있습니다.
“Notion의 AI 외관검사 프로젝트에서 ‘결함 검출 API 개발’ 작업을 확인하고, 요구사항을 읽은 다음 Python FastAPI 기반의 개발 계획과 기본 프로젝트 구조를 만들어 줘. 기존 파일을 덮어쓰지 말고 변경 계획을 먼저 보여 줘.”
이런 방식으로 문서와 개발 작업 사이의 단절을 줄일 수 있습니다.
9. MCP 연결 시 가장 중요한 보안 문제
세 도구를 연결하면 편리하지만, AI 에이전트가 접근할 수 있는 정보와 실행할 수 있는 작업의 범위가 넓어집니다.
특히 다음 위험을 고려해야 합니다.
| 위험 | 대응 방법 |
|---|---|
| Notion 문서의 의도치 않은 수정 | 변경 전 승인, 테스트 공간 사용 |
| NotebookLM 인증 세션 유출 | 인증 파일 접근 권한 제한 |
| 외부 문서의 악성 지시문 | 문서 내용과 사용자 명령을 분리 |
| 과도한 데이터 접근 | 필요한 작업공간과 자료만 연결 |
| 비공식 MCP의 호환성 문제 | 버전 고정, 업데이트 전 테스트 |
| AI의 부정확한 요약 | 원문 대조 및 사람의 검토 |
특히 NotebookLM 커뮤니티 MCP는 브라우저 세션이나 비공식 API에 의존할 수 있으므로 기업 기밀자료를 연결하기 전에 조직의 보안 정책을 확인해야 합니다.
Notion MCP 역시 인증한 사용자가 접근할 수 있는 범위에서 동작하므로, 민감한 작업공간에 접근 권한을 가진 계정을 무분별하게 연결하는 것은 피해야 합니다.
10. 연결 오류 해결하기
| 문제 | 원인 및 해결 방향 |
|---|---|
| MCP 서버가 보이지 않음 | JSON 문법, 설정 파일 위치, 새로고침 확인 |
| Notion 인증 실패 | OAuth 재인증, 브라우저 로그인 및 권한 확인 |
| Notion 검색 결과 없음 | 접근 가능한 페이지와 작업공간 확인 |
| NotebookLM 서버 실행 실패 | uvx 실행 경로와 패키지 설치 상태 확인 |
| NotebookLM 로그인 만료 | 커뮤니티 도구의 인증 갱신 절차 확인 |
| NotebookLM 기능 일부 실패 | 비공식 인터페이스 변경 또는 버전 호환성 확인 |
| Google 공식 Notebook MCP 401 오류 | OAuth 토큰 및 필요한 인증 범위 확인 |
| Google 공식 Notebook MCP 403 오류 | 프로젝트 API 활성화, 계정 및 권한 확인 |
특히 mcp_config.json의 JSON 문법 오류는 흔한 문제입니다.
다음 명령으로 확인할 수 있습니다.
python3 -m json.tool \
~/.gemini/config/mcp_config.json
오류가 없다면 정상적인 JSON 구조입니다.
11. 어떤 연결 방법을 선택해야 할까?
목적별 MCP 연결 방식 선택
기존 NotebookLM의 자료에 질문하고 분석하고 싶다Google 공식 API를 이용해 노트북과 소스를 관리하고 싶다Notion의 프로젝트와 업무를 자동 관리하고 싶다세 도구를 연결해 개발 업무를 자동화하고 싶다
추천: 커뮤니티 NotebookLM MCP
기존 NotebookLM 노트북의 질의응답을 활용할 수 있는 구현을 검토하세요. 비공식 연결이라는 점과 인증 위험을 고려해 개인 테스트 환경에서 먼저 검증하는 것이 좋습니다.
마무리 — AI 도구를 연결하면 업무 흐름이 달라진다
Antigravity, NotebookLM, Notion은 각각 독립적으로 사용해도 유용한 도구입니다.
하지만 MCP로 연결하면 역할이 달라집니다.
NotebookLM은 기술 자료를 분석하고, Antigravity는 그 내용을 바탕으로 코드를 작성하거나 개발 업무를 수행하며, Notion은 프로젝트의 진행 상황과 결과를 기록합니다.
기존에는 사람이 각 프로그램을 오가며 정보를 옮겼다면, MCP 기반 환경에서는 AI 에이전트가 필요한 정보를 요청하고 정리할 수 있습니다.
다만 세 서비스를 연결했다고 해서 완전한 무인 자동화가 보장되는 것은 아닙니다. 서비스별 API 범위, 계정 권한, MCP 서버 안정성, AI의 판단 정확도에 따라 실제 자동화 가능 범위가 달라집니다.
개인적으로는 처음부터 복잡한 자동화를 구현하기보다 다음 순서가 효과적이라고 생각합니다.
Notion 공식 MCP 연결 → NotebookLM 자료 조회 → Antigravity에서 분석 결과 작성 → Notion에 검토 후 저장 → 반복 업무 자동화
이렇게 접근하면 AI를 단순한 질문·답변 도구가 아니라 연구, 개발, 프로젝트 관리를 연결하는 업무 플랫폼으로 발전시킬 수 있습니다.
