透過官方 Heptabase plugin，你可以在 Claude 或 Claude Code 中搜尋、閱讀及整理 Heptabase 的卡片、日誌、白板與標籤資料庫。Plugin 會透過網路連接你的 Heptabase 帳號，不需要安裝 Heptabase CLI，也不需要開著 Heptabase 桌面 app。
安裝並連接 Heptabase
Claude
在 Claude 的個人工作區中連接 Heptabase：
開啟 Claude 網頁版或桌面 app。
開啟 Customize → Plugins → Discover。
搜尋 Heptabase，選擇 plugin，再點選 Add。
連接你的 Heptabase 帳號。依照畫面提示登入，確認要求的權限並完成授權。
開啟新的對話，請 Claude 使用 Heptabase。
如果你使用 Claude Team 或 Enterprise 方案，卻找不到 Heptabase，可以向組織擁有者確認 plugin 是否可用。
介面可能會隨 Claude 更新而改變，最新操作方式請參考 Claude 的 plugin 使用說明。
Claude Code
在 Claude Code 登入同一個 Claude 帳號後，你在 Claude 安裝的 plugin 會同步過來。安裝後請開啟新的 session；如果出現提示，請執行 /reload-plugins 啟用 plugin。
你也可以透過 Heptabase 官方 plugin 儲存庫直接安裝：
在終端機中開啟 Claude Code。
輸入以下指令，加入 Heptabase marketplace：
/plugin marketplace add heptameta/heptabase-agent-plugins
安裝 plugin：
/plugin install heptabase@heptabase-agent-plugins
選擇 Install for you，即可在這台電腦的所有專案中使用。
開啟新的 session，輸入
/mcp，再選擇 Heptabase 連線進行驗證。在瀏覽器中完成 Heptabase 登入與授權，再回到 Claude Code。
驗證方式可以參考 Claude Code 的 MCP 使用說明。
開始使用
直接告訴 Claude 你想在 Heptabase 做什麼。例如：
「找出我在 Heptabase 中關於再生能源的卡片，整理主要想法。」
「把這次討論的重點存成 Heptabase 的新卡片。」
「把這份摘要加到今天的日誌。」
「根據剛才的討論，更新『研究計畫』這張卡片的結論。」
「把這張卡片加入既有的『閱讀』標籤，並放到『研究』白板。」
在 Claude 中找到、建立或編輯卡片後，你也可以請它直接顯示卡片。點選卡片預覽中的 Open in Heptabase，就能回到 Heptabase 繼續使用。Claude Code 的終端機會以文字呈現結果，不會顯示互動卡片預覽。
支援的內容與操作
Heptabase plugin 可以：
搜尋及閱讀卡片、日誌、白板與標籤資料庫。
閱讀圖片與已成功解析的 PDF。
建立及編輯筆記卡片與日誌。
將卡片加入既有標籤，並更新既有屬性值。
將既有卡片及其他支援的內容放到白板上。
目前有以下限制：
不能建立新的標籤、屬性欄位或屬性選項。
不能上傳檔案或建立新的圖片卡片。
放到白板上的內容會自動排列。Plugin 不能精確指定位置或大小，也不能編輯連線。
完整的操作清單與限制可以參考 Heptabase MCP 工具參考。
權限與連線問題
Plugin 可以執行的操作取決於連接時授予的權限。唯讀連線可以搜尋及閱讀內容，但不能建立或編輯內容。如果希望 Claude 修改內容，請重新連接並授予寫入權限。
如果 plugin 沒有正常運作，可以先檢查：
確認連接的是正確的 Heptabase 帳號。
安裝後開啟新的對話或 Claude Code session。
如果 Claude 沒有使用 Heptabase，請在訊息中明確提到 Heptabase。
在 Claude Code 中輸入
/mcp檢查連線，並依提示完成驗證。如果連線失效，請重新連接。
如果問題仍持續，請聯絡 Heptabase 客服，並提供使用的 app 與錯誤訊息。
其他連接方式
如果要手動連接其他支援 MCP 的 AI 服務，請參考 Heptabase MCP。
如果需要更細緻地調整白板版面，可以使用 Heptabase CLI。使用時需要開著 Heptabase 桌面 app。