透過官方 Heptabase plugin，你可以在 ChatGPT 或 Codex 中操作 Heptabase 的卡片、日誌、白板與標籤資料庫。不需要啟用 Developer mode、設定 MCP server，也不需要安裝 Heptabase CLI。
安裝並連接 Heptabase
ChatGPT 與 Codex 共用同一個 Plugins Directory：
在 ChatGPT 或 Codex 中開啟 Plugins Directory。
搜尋 Heptabase 並安裝 plugin。
登入 Heptabase，確認權限並完成連接。
開啟新的對話或 Codex task，請 AI 使用 Heptabase，或輸入 @Heptabase 選用 plugin。
使用 Codex CLI 時，請輸入 /plugins 安裝 Heptabase，然後開啟新的 session。
介面可能會隨 OpenAI 更新而改變，最新操作方式請參考 OpenAI 的 plugin 使用說明。
開始使用
直接描述你想做的事，AI 就會使用 Heptabase。例如：
「找出我關於 Mindstorms 的卡片，整理主要想法，並顯示最相關的卡片。」
「把這次討論的重點加到今天的日誌。」
「把這篇論文存成 PDF 卡片，並整理第一節的重點：https://arxiv.org/pdf/1706.03762」
「打開我的『Mindstorms』白板，把卡片依主題分成幾個區塊。」
AI 找到、建立或編輯卡片後，你可以請它顯示卡片。點選卡片預覽即可開啟，再點選 Open in Heptabase 回到 app 繼續。也可以觀看示範影片。
在 ChatGPT 與 Codex 裡打開白板
在 ChatGPT 與 Codex app 中，AI 可以直接在對話裡打開你的白板。你可以在對話裡瀏覽和編輯白板，AI 修改時也會即時出現在白板上。例如：「打開我的『Mindstorms』白板。」你隨時可以切換白板或打開卡片；當你說「這個白板」或「這張卡片」時，AI 會先確認你目前打開的是哪一個。
Plugin 可以做什麼
搜尋及閱讀卡片、日誌、白板、標籤資料庫、PDF、圖片、劃記與反向連結。
建立及編輯筆記卡片與日誌，可以加入圖片、影片、音訊與附件。
從檔案或連結建立 PDF、圖片、音訊、影片、網頁與 YouTube 卡片。
建立及編輯標籤資料庫、把卡片加入或移出資料庫、設定卡片屬性、整理標籤，以及把卡片移到垃圾桶或還原。
讀取及整理 Inbox，以及讀取或設定 Space Instructions。
建立白板、區塊、連線與心智圖，並排列白板上的物件。
在對話中顯示卡片，以及在 ChatGPT 與 Codex app 裡打開白板。
編輯白板等少數操作需要在 Heptabase app 裡執行。在 ChatGPT 與 Codex app 中，AI 會在需要時直接在對話裡打開 Heptabase。在 Codex CLI 中，請開著 Heptabase 桌面 app 或網頁版，並登入同一個帳號。
從電腦上傳檔案需要能執行指令的 AI，例如 Codex。在 ChatGPT 中，AI 可以從連結存下檔案。Codex CLI 會以文字呈現結果，不會顯示互動預覽。
所有支援的操作，請參考 Heptabase MCP 工具參考。
權限與連線問題
AI 能做哪些事，取決於連接時你授予的權限。唯讀連線可以搜尋和閱讀，但無法建立或編輯內容。
如果 plugin 沒有正常運作：
安裝 plugin 後，請開啟新的對話或 Codex task。
如果 AI 沒有使用 Heptabase，請輸入 @Heptabase 選用 plugin。
如果可用的操作看起來不完整或過時，請在 plugin 設定中點選 Refresh，再開啟新的對話。
如果 AI 找不到你的內容，請確認連接的是正確的 Heptabase 帳號。
如果連線已過期，請重新連接。若一直發生，請聯絡客服，並提供你使用的 app、發生時間與錯誤訊息。
請勿把密碼、API key 或授權 token 傳給 Heptabase 客服。
其他連接方式
若要連接其他 AI 服務，請參考 Heptabase MCP。如果你用的是在終端機裡工作的 coding agent，而且它和 Heptabase 桌面 app 在同一台電腦上，請參考 Heptabase CLI。
如果仍需要協助，請聯絡 Heptabase 客服。