Kenji 的 AI 工具手冊@kenjishih0829

把 Gemini Notebook(NotebookLM)接上 Claude

發布 2026-11-22|最後確認 2026-11-22
路線 A(claude.ai)✅ 已實測,照做約 14 分鐘接通|路線 B(Claude Code)📄 依官方文件整理,未實測

先看這段:接之前要知道的事

一句話:Claude 負責找資料、塞進筆記本;讀資料、問問題、做摘要還是回 Gemini Notebook 自己做。


兩條路,挑一條

A. claude.ai 網頁/App B. Claude Code(終端機)
狀態 ✅ 已實測 📄 依官方文件,未實測
適合 一般使用者 會開終端機的人
驗證方式 自建 OAuth 用戶端,Google 登入授權 gcloud 取 access token 塞進 header
麻煩的地方 Google Cloud 後台要點幾個畫面 token 大約 1 小時過期,要重取
授權多久過期 約一週,按「重新連接」 約 1 小時,重取 token

兩條路都要先做「共同準備」。


共同準備:建 Google Cloud 專案、開 API

1. 確認有 gcloud

gcloud --version

2. 登入個人帳號

gcloud 原本沒登入、或本來就是個人帳號:

gcloud auth login

gcloud 已經登入公司帳號的人:直接 auth login 會把預設帳號換掉,影響原本的工作。改成開一組獨立設定:

gcloud config configurations create gemini-notebook --no-activate
CLOUDSDK_ACTIVE_CONFIG_NAME=gemini-notebook gcloud auth login

之後每行 gcloud 指令前面都加 CLOUDSDK_ACTIVE_CONFIG_NAME=gemini-notebook,原本的設定完全不受影響。

3. 建專案、開 API

gcloud projects create <你的專案ID> --name="Gemini Notebook MCP"
gcloud services enable notebook.googleapis.com --project=<你的專案ID>

路線 A:claude.ai 自訂連接器 ✅ 已實測

先確認瀏覽器登入的是哪個 Google 帳號。 Google Cloud 後台用的是瀏覽器右上角那個帳號,不是 gcloud 登入的帳號。有多個帳號的人,先切到同一個個人 Gmail。

下面的按鈕名稱以中文介面為主,括號裡是英文介面。

A1. 設定 OAuth 同意畫面(4 步精靈)

打開 https://console.cloud.google.com/auth/overview?project=<你的專案ID>(網址帶專案 ID 就會直接切過去)→ 按「開始」(Get started)。

步驟 要填的 注意
① 應用程式資訊 應用程式名稱:隨便取,例如 Notebook for Claude;使用者支援電子郵件:下拉選你的 Gmail 下拉只會列出瀏覽器登入的帳號
② 目標對象 選「外部」(External) 個人帳號本來就只能選外部
③ 聯絡資訊 電子郵件地址:填你的 Gmail 打完要按 Enter,變成標籤才算數
④ 完成 勾「我同意《Google API 服務:使用者資料政策》」

每一步按「下一步」,最後按「繼續」再按「建立」。

A2. 把自己加成測試使用者

左欄「目標對象」(Audience)→「測試使用者」區塊按「Add users」→ 右邊滑出面板,填你的 Gmail 按 Enter →「儲存」。

完成後會顯示「1 位使用者(1 位測試使用者…)」。

沒加這步,最後授權會出現「Access blocked」。

A3 + A4 一起做(secret 只會顯示一次)

Client secret 只在建立用戶端那一刻顯示,關掉視窗就看不到了。建議先開好 claude.ai 的表單,再回 Google 按建立,複製完直接貼過去。

A3-1. Google:把用戶端表單填好,先不要按建立

左欄「用戶端」(Clients)→「建立用戶端」(Create client):

⚠️ 頁面上有兩個「新增 URI」按鈕,要按的是下面「已授權的重新導向 URI」那一個。

A4-1. claude.ai:開新增連接器的表單

另開一個分頁到 claude.ai → 設定 → Plugins → Your plugins(舊的「連接器」頁會自動轉到這裡)→ 右上「Add」→「Add custom connector」。

表單分兩段:

  1. 第一段: - Name:Gemini Notebook - MCP server URL:https://notebook.googleapis.com/mcp - 按「Continue」,會跑一下「Checking the server…」
  2. 第二段會自動偵測好,不用改: - Authentication:「Sign in now」(標 Detected) - OAuth client:「Use your own OAuth client」(標 Detected) - 下面出現 OAuth client ID 和 OAuth client secret (optional) 兩個空欄位。停在這裡。

A3-2. Google:按「建立」,複製 ID 和 secret

回 Google 分頁按「建立」→ 跳出視窗顯示用戶端 ID 和用戶端密鑰。

A4-2. claude.ai:貼上,按 Add

Client secret 是密碼:不要貼到聊天、截圖、存成檔案。不小心關掉視窗就到「用戶端」頁開啟該用戶端,新增一組密鑰。

Google 頁面寫「設定可能需要 5 分鐘至數小時才會生效」。實測建好約 2 分鐘就能授權;如果授權失敗,等幾分鐘再試。

A5. Google 授權

自動跳到 Google 登入頁 → 選 A2 加的那個帳號 → 出現「Google 尚未驗證這個應用程式」→ 按「繼續」(這是你自己建的 App)→ 允許讀寫筆記本 → 繼續。

回到 claude.ai,右下角出現「Connected to Gemini Notebook.」就完成了。

⚠️ 自建的 App 在「測試」狀態,授權大約一週會過期。到時在連接器頁按「重新連接」就好。


路線 B:Claude Code 📄 依官方文件,未實測

export PROJECT_ID=<你的專案ID>

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/notebook"

export ACCESS_TOKEN=$(gcloud auth application-default print-access-token)

claude mcp add gemini-notebook-api \
  --transport http https://notebook.googleapis.com/mcp \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "x-goog-user-project: $PROJECT_ID"

確認接好了

連接器詳細頁會列出 7 個工具,分成唯讀和可寫兩類:

管筆記本 管來源
list_notebooks 列出(唯讀) list_sources 列出來源(唯讀)
get_notebook 查看(唯讀) get_source 查處理狀態(唯讀)
create_notebook 建立 create_source 加網頁/YouTube/文字
update_notebook 改名

開一個新對話試兩句:

  1. 「列出我的 Gemini Notebook 筆記本」→ 有回清單就成功。筆記本很多的話會分頁(每頁 50 本),Claude 會自己翻頁。
  2. 「幫我開一本筆記本叫〈XXX〉,找 3 篇相關的官方資料加進去」

來源剛加進去時狀態是 PROCESSING,過一下會變 ACTIVE。到 notebook.google.com 打開筆記本,看到來源都勾好、自動產生摘要,就是處理完成了。


額度(預覽期間)

方案 筆記本上限 每本來源上限
免費 100 50
Plus 200 100
Pro 500 300
Ultra 500 600

卡住了?

狀況 原因 怎麼辦
gcloud: command not found 沒裝,或不在 PATH 看「共同準備 1」
403 WORKSPACE_ACCOUNT_NOT_SUPPORTED 用了公司帳號 換個人 Gmail
Access blocked 帳號不在測試使用者 回 A2 加
redirect_uri_mismatch 回傳網址打錯,或填到「JavaScript 來源」那格 回 A3-1 改,等幾分鐘生效
secret 視窗關掉了 Google 不會再顯示 「用戶端」頁開啟該用戶端,新增一組密鑰
找不到筆記本/權限錯誤 帳號沒登入過 Gemini Notebook 先開 notebook.google.com 登入一次
連接器顯示過期 測試模式授權到期(約一週) 按「重新連接」

不用了,怎麼收


官方來源