一句話:Claude 負責找資料、塞進筆記本;讀資料、問問題、做摘要還是回 Gemini Notebook 自己做。
| A. claude.ai 網頁/App | B. Claude Code(終端機) | |
|---|---|---|
| 狀態 | ✅ 已實測 | 📄 依官方文件,未實測 |
| 適合 | 一般使用者 | 會開終端機的人 |
| 驗證方式 | 自建 OAuth 用戶端,Google 登入授權 | gcloud 取 access token 塞進 header |
| 麻煩的地方 | Google Cloud 後台要點幾個畫面 | token 大約 1 小時過期,要重取 |
| 授權多久過期 | 約一週,按「重新連接」 | 約 1 小時,重取 token |
兩條路都要先做「共同準備」。
gcloud --version
brew install --cask google-cloud-sdk,其他系統看 https://cloud.google.com/sdk/docs/installcommand not found:Homebrew 版的 gcloud 常常不在 PATH。重開終端機,或直接用完整路徑 /opt/homebrew/share/google-cloud-sdk/bin/gcloud。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,原本的設定完全不受影響。
gcloud projects create <你的專案ID> --name="Gemini Notebook MCP"
gcloud services enable notebook.googleapis.com --project=<你的專案ID>
finished successfully 就是開好了。兩行加起來大約 20 秒。先確認瀏覽器登入的是哪個 Google 帳號。 Google Cloud 後台用的是瀏覽器右上角那個帳號,不是 gcloud 登入的帳號。有多個帳號的人,先切到同一個個人 Gmail。
下面的按鈕名稱以中文介面為主,括號裡是英文介面。
打開 https://console.cloud.google.com/auth/overview?project=<你的專案ID>(網址帶專案 ID 就會直接切過去)→ 按「開始」(Get started)。
| 步驟 | 要填的 | 注意 |
|---|---|---|
| ① 應用程式資訊 | 應用程式名稱:隨便取,例如 Notebook for Claude;使用者支援電子郵件:下拉選你的 Gmail |
下拉只會列出瀏覽器登入的帳號 |
| ② 目標對象 | 選「外部」(External) | 個人帳號本來就只能選外部 |
| ③ 聯絡資訊 | 電子郵件地址:填你的 Gmail | 打完要按 Enter,變成標籤才算數 |
| ④ 完成 | 勾「我同意《Google API 服務:使用者資料政策》」 |
每一步按「下一步」,最後按「繼續」再按「建立」。
左欄「目標對象」(Audience)→「測試使用者」區塊按「Add users」→ 右邊滑出面板,填你的 Gmail 按 Enter →「儲存」。
完成後會顯示「1 位使用者(1 位測試使用者…)」。
沒加這步,最後授權會出現「Access blocked」。
Client secret 只在建立用戶端那一刻顯示,關掉視窗就看不到了。建議先開好 claude.ai 的表單,再回 Google 按建立,複製完直接貼過去。
左欄「用戶端」(Clients)→「建立用戶端」(Create client):
https://claude.ai/api/mcp/auth_callback⚠️ 頁面上有兩個「新增 URI」按鈕,要按的是下面「已授權的重新導向 URI」那一個。
另開一個分頁到 claude.ai → 設定 → Plugins → Your plugins(舊的「連接器」頁會自動轉到這裡)→ 右上「Add」→「Add custom connector」。
表單分兩段:
Gemini Notebook
- MCP server URL:https://notebook.googleapis.com/mcp
- 按「Continue」,會跑一下「Checking the server…」回 Google 分頁按「建立」→ 跳出視窗顯示用戶端 ID 和用戶端密鑰。
Client secret 是密碼:不要貼到聊天、截圖、存成檔案。不小心關掉視窗就到「用戶端」頁開啟該用戶端,新增一組密鑰。
Google 頁面寫「設定可能需要 5 分鐘至數小時才會生效」。實測建好約 2 分鐘就能授權;如果授權失敗,等幾分鐘再試。
自動跳到 Google 登入頁 → 選 A2 加的那個帳號 → 出現「Google 尚未驗證這個應用程式」→ 按「繼續」(這是你自己建的 App)→ 允許讀寫筆記本 → 繼續。
回到 claude.ai,右下角出現「Connected to Gemini Notebook.」就完成了。
⚠️ 自建的 App 在「測試」狀態,授權大約一週會過期。到時在連接器頁按「重新連接」就好。
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"
auth/notebook 這個 scope,一般的 gcloud auth print-access-token 沒有。print-access-token,再 claude mcp remove gemini-notebook-api 後重新 add。application-default login 改的是整台電腦共用的預設憑證(~/.config/gcloud/application_default_credentials.json),不分 gcloud 設定。之後本機其他用 Google 預設憑證的程式都會變成這個帳號。用完要收回就跑 gcloud auth application-default revoke。連接器詳細頁會列出 7 個工具,分成唯讀和可寫兩類:
| 管筆記本 | 管來源 |
|---|---|
list_notebooks 列出(唯讀) |
list_sources 列出來源(唯讀) |
get_notebook 查看(唯讀) |
get_source 查處理狀態(唯讀) |
create_notebook 建立 |
create_source 加網頁/YouTube/文字 |
update_notebook 改名 |
開一個新對話試兩句:
來源剛加進去時狀態是 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 登入一次 |
| 連接器顯示過期 | 測試模式授權到期(約一週) | 按「重新連接」 |
gcloud projects delete <你的專案ID>(專案會先停用 30 天才真正刪除)gcloud config configurations delete gemini-notebookgcloud auth application-default revoke