透過官方 Heptabase 插件，你可以在 ChatGPT 或 Codex 裡搜尋、閱讀、建立及整理 Heptabase 卡片，不需要手動設定自訂 MCP 伺服器或安裝 Heptabase CLI。
在 ChatGPT 中連接
開啟 ChatGPT 的插件商店。依介面不同，入口可能顯示為 Plugins 或 Apps。
搜尋 Heptabase，開啟插件頁面，選擇安裝或連接。
依畫面指示完成授權。登入存有你知識庫的 Heptabase 帳號，確認要求的權限後允許連接。
回到對話，透過介面提供的插件選單或 @ 提及選取 Heptabase。
在 Codex 中連接
在 Codex app 開啟插件商店，搜尋 Heptabase。
安裝插件，並依提示完成 Heptabase 帳號授權。
在支援的任務介面中，開啟 Sources → Use plugins，選取 Heptabase。
插件的可用性與操作選項可能因帳號、介面及工作區設定而不同。如果你的介面不同，可參考 OpenAI 的插件教學。這裡介紹的是官方插件，並非 Heptabase CLI 的設定方式。
找出並閱讀你的卡片
先試著詢問一個你已經存過資料的主題：
找出我關於 Mindstorms 的筆記，整理主要想法，並顯示相關卡片。
AI 可以搜尋和閱讀支援的卡片、日記、白板及標籤資料庫，也能閱讀圖片和已成功解析的 PDF 頁面。在 ChatGPT 中，它可以把選出的卡片直接顯示在對話裡，讓你閱讀原文、繼續提問。建立或編輯卡片後，也可以請它顯示結果。
這些卡片仍然存在 Heptabase 裡，在 ChatGPT 中顯示不會把卡片移出你的知識庫。你可以點擊卡片檢視中的 Open in Heptabase，回到 Heptabase 繼續使用。
觀看示範影片，了解如何在手機上搜尋、顯示卡片，並把對話摘要存回 Heptabase。
儲存與整理討論內容
直接說明想記下什麼，以及要放在哪裡。例如：
「把這段摘要存成新卡片，並加入我的 Mindstorms 白板。」
「把這次討論的重點加到今天的日記。」
「把這張卡片加到既有的『閱讀』標籤，並將『狀態』屬性設為已存在的『已讀』選項。」
「根據剛才的討論，更新我原本那張卡片的結論。」
請使用你自己的白板、標籤、屬性及選項名稱。插件可以將卡片加入既有的標籤資料庫，並更新支援的屬性值，但不會建立新的標籤、屬性欄位或選項；這些設定請先在 Heptabase 裡建立。放到白板的卡片會自動排列，不支援精確的版面編輯。
從手機接著用到電腦
出門時，你可以在手機上的 ChatGPT 使用插件找筆記、記下想法，也可以從顯示的卡片跳到 Heptabase 手機版瀏覽。Heptabase 會跨裝置即時同步，因此裝置連線並完成同步後，儲存的內容也會出現在電腦上。請在各裝置使用同一個 Heptabase 帳號。
常見問題
為什麼可以讀取卡片，卻不能編輯？
建立或編輯內容需要寫入權限。請檢查 Heptabase 連線的權限，必要時重新連接並授予寫入權限。ChatGPT 或 Codex 的工作區限制與操作核准設定，也可能影響可執行的操作。
為什麼找不到我的卡片？
請確認連接的是存有這些卡片的 Heptabase 帳號，而且卡片已完成同步。可以先請 AI 搜尋一個確切的卡片標題。如果連錯帳號，請中斷 Heptabase 連線，再用正確的帳號重新登入。
為什麼只有文字回答，沒有顯示卡片？
可以明確請 AI 顯示相關的 Heptabase 卡片。互動卡片檢視需要支援的介面，例如 ChatGPT 或 Codex app；終端機用戶端可能只會回傳文字。
如何中斷連線？
在 ChatGPT 開啟 Settings → Apps 或 Plugins，選取 Heptabase，再從連線或已連接帳號的選單中中斷連線。最新操作可參考 OpenAI 的帳號連接教學。在 Codex 中，可透過插件設定管理 Heptabase 連線。
什麼時候需要 MCP 或 CLI？
如果要手動連接其他相容的 AI 服務，可以使用 Heptabase MCP。如果需要透過執行中的桌面 app 操作終端機工作流程，或進行詳細的白板版面編輯，可以使用 Heptabase CLI。完整支援範圍請參考 MCP 工具參考。
需要協助時，請聯絡 Heptabase 客服，提供使用的 app、嘗試的操作與錯誤訊息，請勿附上密碼或授權 token。