在 Codex 連接 NotebookLM
macOS 安裝、登入、驗收與 MakeClass 教材流程
title: "在 Codex 連接 NotebookLM" subtitle: "macOS 安裝、登入、驗收與 MakeClass 教材流程" seal: "教學" notes: "依 2026 年 9 月 16 日查核文件編寫。尚未在本機完成帳號連線實測。" <!-- notes: 本簡報配合教學手冊使用，適用於 macOS 本機 Codex。查核日期為 2026 年 9 月 16 日，目前尚未在本機完成 Google 登入或端到端串接測試。 --> 完成後可以做什麼 {#完成後可以做什麼} 在 Codex 查詢指定 NotebookLM 筆記本。 整理資料，保留可追溯的引用。 產出教學手冊，再建立 mcpost 與 mcslide。 注意：本教學尚未完成實際 Google 登入與端到端連線測試。
<!-- notes: 適用範圍是 macOS 本機 Codex 與一般 NotebookLM 帳號。安裝不代表連線成功，稍後會用真實筆記本驗收。來源：https://github.com/jacob-bd/gemini-notebook-mcp-cli/blob/main/docs/MCPGUIDE.md --> 三個元件各自負責什麼 {#三個元件各自負責什麼}
元件 角色 :--- :--- Codex 接收任務，呼叫工具 本機 MCP Server 把呼叫轉成 NotebookLM 操作 NotebookLM 處理帳號可存取的資料
貼上網址或登入內建瀏覽器，不會自動完成 MCP 設定。
<!-- notes: STDIO 指 Codex 啟動本機子程序並與它通訊。此路線不用架設公開 HTTP 服務。橋接程式有自己的登入狀態，和內建瀏覽器的登入不同。來源：https://developers.openai.com/codex/mcp/ --> 準備工具與帳號 {#準備工具與帳號}
選用第三方套件 notebooklm-mcp-cli。
<!-- notes: 本套件目前的 GitHub 專案名稱是 gemini-notebook-mcp-cli，執行檔仍叫 notebooklm-mcp。上一輪提到的 PleasePrompto 專案已封存。這是第三方整合，使用內部介面，可能隨上游變更失效。來源：https://github.com/jacob-bd/gemini-notebook-mcp-cli ；https://github.com/PleasePrompto/notebooklm-mcp --> 開始前的檢查 {#開始前的檢查} Mac 上可使用 Codex、Homebrew 與 Chrome。 Google 帳號能正常開啟 NotebookLM。 準備一個已知名稱的測試筆記本。 在終端機執行安裝，Google 登入由本人完成。
<!-- notes: 本次本機檢查找到 Codex、Homebrew 與 Chrome，但終端 PATH 找不到 uv、nlm 或 notebooklm-mcp。這是當時環境快照，其他電腦需自行確認。先用公開教材測試。密碼、驗證碼與 cookies 不必貼入對話。 --> 安裝 uv 與橋接套件 {#安裝-uv-與橋接套件}
重開終端機，再執行：
<!-- notes: 安裝前可先執行 uv --version，已安裝則不必重裝。兩個 command -v 應回傳路徑。用 uv tool list 記錄套件版本。來源：https://docs.astral.sh/uv/getting-started/installation/ ；https://docs.astral.sh/uv/guides/tools/ ；https://github.com/jacob-bd/gemini-notebook-mcp-cli/blob/main/docs/GETTINGSTARTED.md --> 登入與帳號驗證 {#登入與帳號驗證}
在開啟的瀏覽器中登入，確認清單包含預期筆記本。 注意：先儲存 Chrome 工作，依登入文件完整結束 Chrome 再開始。
<!-- notes: 依序執行，等待前一步完成。nlm login 建立橋接程式使用的登入狀態，不是要求使用者把 Google 密碼交給 Codex。沒有筆記本時，空清單可能正常。來源：https://github.com/jacob-bd/gemini-notebook-mcp-cli/blob/main/docs/AUTHENTICATION.md --> 連接 Codex {#連接-codex}
註冊 MCP 後，還要重新載入工具。
<!-- notes: 設定存在只是第一個檢查點。接下來還需要伺服器啟動、工具載入與 Google 帳號驗證。此路線的登入指令是 nlm login，codex mcp login 用於支援 OAuth 的 MCP。來源：https://developers.openai.com/codex/mcp/ --> 以 CLI 註冊 MCP {#以-cli-註冊-mcp}
先確認執行檔路徑與既有設定：
路徑存在、沒有同名衝突後，再執行：
<!-- notes: 使用完整路徑降低 App 和終端 PATH 不同造成的失敗。若 command -v 沒輸出，先修正安裝。不要覆寫整份 config.toml。本機 codex mcp add --help 已確認此語法。來源：https://developers.openai.com/codex/mcp/ --> 桌面介面的替代設定 {#桌面介面的替代設定}
設定中的 MCP servers，新增伺服器：
欄位 值 :--- :--- Name gemini-notebook-mcp Transport STDIO Command notebooklm-mcp 的完整路徑 Arguments 留空
CLI 與介面擇一，儲存後重啟 MCP，必要時重開 App。
<!-- notes: 介面名稱可能隨版本或語系不同。Command 應貼入上一頁查到的實際路徑。一般預設帳號不需手動填 cookies。開始新對話後確認工具載入。來源：https://developers.openai.com/codex/mcp/ --> 在對話中驗收 {#在對話中驗收}
第一次指示： 請使用 notebooklist，列出我能存取的筆記本名稱與 ID。
第二次指示： 查詢指定筆記本，整理三個重點並保留引用，資料不足請明說。
設定存在、工具載入、帳號正確、問答成功，都要確認。
<!-- notes: 第二次要提供實際筆記本 ID。codex mcp list 不能單獨證明問答成功。查看引用對應的原始來源，避免把模型生成的合理文字當作資料證據。來源：https://github.com/jacob-bd/gemini-notebook-mcp-cli/blob/main/docs/MCPGUIDE.md --> 常見問題與處理 {#常見問題與處理}
現象 下一步 :--- :--- 指令不存在 檢查安裝與 PATH App 啟動失敗 改用執行檔完整路徑 登入 stale 重新 nlm login 登入 unverified 先查網路與代理 筆記本不符 核對帳號與權限
綜合診斷可使用 nlm doctor。
<!-- notes: 認證無法驗證不一定等於憑證失效。長問答超時可縮小問題，或使用工具支援的非同步查詢。分享診斷記錄前應遮蔽帳號與憑證。來源：https://github.com/jacob-bd/gemini-notebook-mcp-cli/blob/main/docs/AUTHENTICATION.md ；https://github.com/jacob-bd/gemini-notebook-mcp-cli/blob/main/docs/MCPGUIDE.md --> 接回 MakeClass 教材流程 {#接回-makeclass-教材流程} 查詢 NotebookLM，核對引用。 整理為繁體中文 Markdown 手冊。 使用 mcpost 建立文章草稿。 使用 mcslide 建立簡報，連結來源文章。
NotebookLM 與 MakeClass 各自需要登入或權杖。
<!-- notes: mcpost 和 mcslide 使用 MakeClass 權杖，Google 登入不會取代它。先展示預覽，確認後送出不公開草稿。mcslide 以文章 pushId 作為 --source，保留來源鏈。NotebookLM 自製投影片與 MakeClass Slides Markdown 不應視為同一格式。本頁是工作流程建議。 --> 練習：完成第一次資料查詢 {#練習-完成第一次資料查詢}
選一個公開教材筆記本，請 Codex： 列出筆記本並確認 ID。 摘要其中一項概念，附來源。 對照原文，修正一處不完整之處。 整理成一頁可教學的內容。
<!-- notes: 練習目的不是測試最大生成量，而是確認帳號、工具與來源都正確。可先挑一份短教材，再逐步增加來源。若工具尚未載入，回到連線檢查，不要用猜測的答案假裝 NotebookLM 查詢結果。 --> 帶走三句話 {#帶走三句話}
安裝工具後，要完成獨立的 Google 登入。
Codex 看得到 MCP 名稱，還不代表問答成功。
核對資料後，再把成果做成文章與簡報。
<!-- notes: 停用連線可用 codex mcp remove gemini-notebook-mcp，它不刪除 Google 筆記本，也不清除本機登入狀態。日後升級套件，重做一次列出筆記本與問答驗收。來源：https://developers.openai.com/codex/mcp/ ；https://docs.astral.sh/uv/guides/tools/ -->