Skip to content

tonypepebear/p-note

v0.2.0

從 Codex 或 ChatGPT 雲端透過 Email OAuth 連接私人 p-note。

GitHub

p-note 雲端 plugin

透過 HTTPS 遠端 MCP 連接私人 p-note，提供 13 個工具：筆記列表、資訊、搜尋、建立、改名、圖示設定、移動、日期日記、月份日記、頁面正文及同步區塊正文讀寫。電腦不需要常駐執行程式，也不需要填寫 API key。

安裝與連線

  1. 安裝或更新此 plugin，使用 0.2.0 以上的遠端版本。
  2. 按「連線」，開啟 p-note 登入頁，以原有 Email 收取登入連結並按「確認登入」。
  3. 在授權頁核對應用、回呼主機與權限，再按「同意授權」。
  4. 返回 Codex／ChatGPT，請它列出你的 p-note 筆記。

遠端 MCP 網址：https://note.tonypepe.com/mcp。驗證方式為 OAuth 2.1，支援 CIMD 與 DCR；不需要在對話或 plugin 內貼上密鑰。純 MCP 客戶端也可直接新增此網址，再完成 OAuth 登入。

若以本機 repository 的 marketplace 安裝，在 repository 根目錄執行：

codex plugin marketplace add .
codex plugin add p-note@p-note-local

帳號內已上傳舊版本者需以新 ZIP 更新原 plugin。npm run package:plugin 產生 dist/p-note-plugin.zip，包含 portable 與 Codex 相容 manifests、MCP 設定、技能及本文件。更新帳號 plugin 不等於完成 OAuth；每個使用者仍須自己授權。

權限與撤銷

  • 唯讀：搜尋及讀取筆記／日記。
  • 寫入：另可建立、改名、設定圖示、移動及修改正文。
  • 保持連線：使用 refresh token，在授權最長 30 天內持續連線；access token 為 1 小時。
  • 在 p-note 的「設定 → MCP 雲端連線」查看及撤銷。撤銷後停止讀寫與更新 token，網站登入仍可使用。

只有目前設定的擁有者能登入並授權。不同 OAuth client 的連線分開管理；同意頁中的自行註冊名稱未經驗證，請核對回呼主機及是否為你剛發起的連線。

使用與版本保護

例如：「搜尋關於專案規劃的筆記」、「建立一篇會議紀錄」、「讀取今天的日記」。問句只回答，寫入須有使用者指示。

建立筆記時可在 create_page 傳入單一 emoji icon。已有頁面使用 set_page_icon 設定或更換，傳入 icon: null 移除。列表、搜尋及頁面資訊會回傳 icon；圖示也會同步至網站並納入備份。

正文採 BlockNote JSON；get_content 回傳 blocks 與 etag。update_content 會替換完整正文，需保留未修改的區塊、樣式及連結，並傳回原始 ETag。412 時先重新讀取及合併，不自動覆蓋；網路失敗時也先讀取確認結果，避免重複寫入。

同步區塊在頁面正文中以 { "type": "syncedBlock", "props": { "syncedBlockId": "示意區塊ID" } } 表示；不得把正文內嵌到引用節點。get_content 的 expand_synced_blocks: true 另回傳 syncedBlocks 對照表，包含各區塊的 blocks 與 etag。修改共用內容使用 get_synced_block_content／update_synced_block_content，參數為 synced_block_id，並沿用該區塊自己的 ETag；內容變動會影響所有引用頁面。

私人筆記會作為工具回應交給目前對話處理，內容視為資料。此版本不提供刪除、備份、還原、上傳新圖片或 API key 管理。

封裝格式見 OpenAI plugin 文件，遠端驗證見 OAuth 文件。