hucompany

주요 기능

Related MCP server: NotebookLM MCP Server

중요 고지 사항

이 MCP는 다음과 같은 내부 API를 사용합니다:

• 문서화되지 않았으며 예고 없이 변경될 수 있습니다.

• 브라우저에서 쿠키 추출이 필요합니다.

개인적/실험적 목적으로만 사용해 주십시오.

설치 방법

선호하는 Python 패키지 관리자(uv, pip, pipx 등)를 사용하여 PyPI에서 notebooklm-mcp-server를 설치할 수 있습니다.

소스 코드에서 직접 설치하는 방법도 지원합니다.

업데이트 방법

패키지 관리자의 업그레이드 명령어를 사용하여 최신 버전으로 업데이트하세요.

업데이트 후에는 AI 도구를 재시작하여 연결을 갱신해야 합니다:

• Claude Code: 애플리케이션을 재시작하거나 재연결 명령을 사용

• Cursor: 애플리케이션 재시작

• Gemini CLI: CLI 세션 재시작

제거 방법

MCP를 완전히 제거하려면 패키지 관리자의 제거 명령어를 사용하세요. 선택적으로 캐시된 인증 토큰이나 AI 도구의 설정 파일에서도 제거할 수 있습니다.

인증

MCP를 사용하기 전에 NotebookLM 인증이 필요합니다.

자동 모드를 권장합니다. 전용 Chrome 프로필을 실행하여 구글에 로그인하면 쿠키가 자동으로 추출됩니다. 로그인 정보는 추후 인증 갱신을 위해 저장됩니다.

만약 자동 모드가 작동하지 않는다면, 파일 모드를 통해 Chrome 개발자 도구에서 수동으로 쿠키를 추출하여 저장할 수 있습니다.

인증 성공 후에는 MCP를 AI 도구에 추가하고 재시작하세요.

자세한 내용과 문제 해결 방법은 **docs/AUTHENTICATION.md**를 참고하세요.

MCP 설정

⚠️ 문맥 창(Context Window) 주의: 이 MCP는 31개의 도구를 제공하므로 문맥 창을 많이 차지할 수 있습니다. NotebookLM을 적극적으로 사용하지 않을 때는 MCP를 비활성화하여 다른 작업의 문맥을 확보하는 것이 좋습니다.

CLI 옵션

명령줄 인수를 사용하여 서버를 설정할 수 있습니다. 전송 프로토콜(stdio, http, sse), 포트, 호스트, 디버그 모드, 쿼리 타임아웃 등을 설정할 수 있습니다.

환경 변수

환경 변수를 통해서도 설정이 가능합니다. (NOTEBOOKLM_MCP_TRANSPORT, NOTEBOOKLM_MCP_PORT 등)

AI 도구 연결 (Claude Code, Gemini CLI, IDE 등)

Claude Code나 Gemini CLI와 같은 도구는 내장된 명령어를 통해 MCP 서버를 쉽게 추가할 수 있습니다.

Cursor, VS Code, Claude Desktop 등 JSON 설정 파일을 사용하는 도구의 경우, 설치된 notebooklm-mcp의 경로를 찾아 설정 파일의 mcpServers 항목에 추가해야 합니다.

활용 예시

Claude Code, Cursor, Gemini CLI 등의 AI 도구와 자연어로 대화하며 다음과 같이 활용할 수 있습니다.

조사 및 탐색

• "내 모든 NotebookLM 노트북 목록을 보여줘"

• "'AI 전략 연구'라는 새 노트북을 만들어줘"

• "'기업 AI ROI 지표'에 대해 웹 조사를 시작하고 찾은 소스를 보여줘"

• "'클라우드 마켓플레이스 트렌드'에 대해 심층 조사를 수행하고 상위 10개 소스를 가져와줘"

• "내 구글 드라이브에서 '제품 로드맵' 관련 문서를 검색해서 노트북을 만들어줘"

콘텐츠 추가

• "이 URL을 내 노트북에 추가해줘: https://example.com/article"

• "쿠버네티스에 관한 이 유튜브 영상을 노트북에 추가해줘"

• "내 회의 노트를 텍스트 소스로 이 노트북에 추가해줘"

• "이 구글 문서를 내 연구 노트북으로 가져와줘"

AI 기반 분석

• "이 노트북의 핵심 발견 사항은 뭐야?"

• "이 모든 소스들의 주요 주장을 요약해줘"

• "이 소스에서 보안 모범 사례에 대해 뭐라고 해?"

• "이 노트북이 무엇에 관한 것인지 AI 요약을 해줘"

• "채팅 설정을 학습 가이드 스타일로 변경하고 답변을 길게 해줘"

콘텐츠 생성

• "이 노트북을 심층 분석 형식의 오디오 팟캐스트 오버뷰로 만들어줘"

• "클래식 비주얼 스타일로 비디오 설명 영상을 생성해줘"

• "이 소스들을 바탕으로 브리핑 문서를 만들어줘"

• "공부용 플래시카드를 만들어줘, 난이도는 중간으로"

• "가로 방향 인포그래픽을 생성해줘"

• "내 연구 소스들로 마인드맵을 그려줘"

• "이 노트북으로 프레젠테이션 슬라이드 덱을 만들어줘"

스마트 관리

• "업데이트가 필요한 구글 드라이브 소스를 확인하고 동기화해줘"

• "이 노트북의 모든 소스와 최신 상태 여부를 보여줘"

• "노트북에서 이 소스를 삭제해줘"

• "내 오디오 오버뷰 생성 상태를 확인해줘"

인증 수명 주기

• 쿠키: 약 2~4주 유지 (저장된 프로필이 있으면 헤드리스 Chrome을 통해 자동 갱신)

• CSRF 토큰: 약 수분 유지 (요청 실패 시 자동 갱신)

• 세션 ID: MCP 세션당 유지 (MCP 시작 시 자동 추출)

v0.1.9+: 서버가 토큰 만료를 자동으로 처리합니다.

1. 만료 시 즉시 CSRF 토큰 갱신

2. 외부에서 업데이트된 경우 디스크에서 쿠키 다시 로드

3. 저장된 로그인 프로필이 있는 경우 헤드리스 Chrome 인증 실행

자동 갱신이 실패하면(구글 로그인이 완전히 만료된 경우), 다시 인증 도구를 실행해야 합니다.

문제 해결

업데이트가 제대로 되지 않는 경우

패키지 관리자의 캐시 문제나 버전 제약으로 인해 최신 버전이 설치되지 않을 수 있습니다. 이 경우 강제 재설치 옵션을 사용하여 해결할 수 있습니다.

Chrome DevTools MCP가 작동하지 않는 경우 (Cursor/Gemini CLI)

Chrome DevTools MCP가 "도구가 없음"으로 표시되거나 시작되지 않는 경우, 알려진 npx 버그일 수 있습니다. 이 경우 pnpm을 사용하여 실행하도록 설정을 변경하면 해결될 수 있습니다.

제한 사항

• 속도 제한: 무료 계층은 하루 약 50회 쿼리로 제한됩니다.

• 공식 지원 없음: API는 예고 없이 변경될 수 있습니다.

• 쿠키 만료: 몇 주마다 쿠키를 다시 추출해야 할 수 있습니다.

기여하기

API 문서 및 새로운 기능 추가 방법은 CLAUDE.md를 참고하세요.

라이선스

MIT License