透過官方 Heptabase plugin，你可以在 ChatGPT 或 Codex 中搜尋、閱讀、建立及整理 Heptabase 裡的內容。不需要啟用 Developer mode、手動設定 MCP server，也不需要安裝 Heptabase CLI。
安裝並連接 Heptabase
ChatGPT 與 Codex 共用同一個 Plugins Directory：
在 ChatGPT 或 Codex 中開啟 Plugins Directory。
搜尋並安裝 Heptabase。
依照畫面提示登入 Heptabase，確認要求的權限並完成連接。
安裝後開啟新的對話或 Codex task，即可請 AI 使用 Heptabase。你也可以輸入
@Heptabase明確選用 plugin。
使用 Codex CLI 時，請輸入 /plugins 安裝 Heptabase，然後開啟新的 session。
介面可能會隨 OpenAI 更新而改變，最新操作方式請參考 OpenAI 的 plugin 使用說明。
開始使用
不需要記住 MCP 工具名稱，直接描述你想找什麼，以及希望 AI 如何處理即可。例如：
「找出我關於 Mindstorms 的卡片，整理主要想法，並顯示最相關的卡片。」
「把這次討論的重點加到今天的日誌。」
「根據剛才的討論，更新『研究計畫』這張卡片的結論。」
「把這張卡片加入『閱讀』標籤，並放到『Mindstorms』白板。」
「讀取這份 PDF，整理各章節的主要論點。」
找到、建立或編輯卡片後，你也可以請 AI 直接顯示卡片，再透過 Open in Heptabase 回到 Heptabase 繼續使用。
你也可以觀看示範影片，了解如何搜尋及顯示卡片，並將討論摘要存回 Heptabase。
支援的內容與操作
Heptabase plugin 可以：
搜尋及閱讀卡片、日誌、白板與標籤資料庫。
閱讀圖片與已成功解析的 PDF。
建立筆記卡片及日誌。
編輯卡片內容，或將內容附加到日誌。
將卡片加入既有標籤，並更新既有屬性值。
將既有卡片及其他支援的內容放到白板。
在支援的 ChatGPT 或 Codex 介面中顯示卡片。
目前有以下限制：
不能建立新的標籤、屬性欄位或選項。
不能上傳檔案或建立新的圖片卡片。
放到白板上的內容會自動排列，不能精確調整位置、大小或連線。
ChatGPT 中的卡片預覽目前不能直接勾選 todo。請使用 Open in Heptabase 完成勾選。
Codex CLI 等純文字介面不會顯示互動卡片，會改以文字呈現結果。
完整的支援範圍可以參考 Heptabase MCP 工具參考。
權限與連線問題
Plugin 可以執行的操作取決於連接時授予的權限。唯讀連線可以搜尋及閱讀內容，但不能建立或編輯內容。
如果沒有正常運作，可以依序檢查：
安裝 plugin 後，開啟新的對話或 Codex task。
如果 Heptabase 沒有被使用，可以輸入
@Heptabase明確選用。如果可用功能似乎不完整或仍是舊版本，請在 plugin 設定中選擇 Refresh，再開啟新的對話。
如果完全找不到預期內容，請確認連接的是正確的 Heptabase 帳號。
如果連線失效，請重新連接。若問題反覆發生，請聯絡客服並提供使用的 app、發生時間與錯誤訊息。
請勿將密碼、API key 或 authorization token 傳給 Heptabase 客服。
其他連接方式
如果要連接其他支援 MCP 的 AI 服務，請參考 Heptabase MCP。
如果需要終端機工作流程，或要透過執行中的桌面 app 精確操作白板版面，可以使用 Heptabase CLI。
如果仍需要協助，請聯絡 Heptabase 客服。