透過官方 Heptabase plugin，你可以在 Claude 或 Claude Code 中操作 Heptabase 的卡片、日誌、白板與標籤資料庫。Plugin 會透過網路連接你的 Heptabase 帳號，不需要安裝 Heptabase CLI。
安裝並連接 Heptabase
Claude
開啟 Claude 網頁版或桌面 app。
開啟 Customize → Plugins → Discover。
搜尋 Heptabase，選擇 plugin，再點選 Add。
登入 Heptabase，確認權限並完成連接。
開啟新的對話，請 Claude 使用 Heptabase。
如果你使用 Team 或 Enterprise 工作區卻找不到 Heptabase，請向工作區擁有者確認是否開放 plugin。介面可能會隨 Claude 更新而改變，最新操作方式請參考 Claude 的 plugin 使用說明。
Claude Code
在 Claude Code 登入同一個 Claude 帳號後，你在 Claude 安裝的 plugin 會同步過來。安裝後請開啟新的 session；如果出現提示，請執行 /reload-plugins。
你也可以從 Heptabase 官方 plugin 儲存庫安裝。在 Claude Code 中執行：
/plugin marketplace add heptameta/heptabase-agent-plugins
/plugin install heptabase@heptabase-agent-plugins
選擇 Install for you，即可在所有專案中使用。接著開啟新的 session，輸入 /mcp，選擇 Heptabase 連線，並在瀏覽器中登入 Heptabase。登入的更多說明，請參考 Claude Code 的 MCP 說明。
開始使用
告訴 Claude 你想在 Heptabase 做什麼。例如：
「找出我在 Heptabase 中關於再生能源的卡片，整理主要想法。」
「把這次討論的重點存成一張新的 Heptabase 卡片。」
「把這篇論文存成 PDF 卡片，並整理第一節的重點：https://arxiv.org/pdf/1706.03762」
「打開我的『研究』白板，把卡片依主題分成幾個區塊。」
在 Claude 中，你也可以請 Claude 顯示它找到、建立或編輯的卡片。點選卡片預覽中的 Open in Heptabase，即可回到 app 繼續。Claude Code 的終端機會以文字呈現結果。
在 Claude 與 Claude Code 裡打開白板
在 Claude 中，Claude 可以直接在對話裡打開你的白板。你可以在對話裡瀏覽和編輯白板，Claude 修改時也會即時出現在白板上。例如：「打開我的『研究』白板。」你隨時可以切換白板或打開卡片；當你說「這個白板」或「這張卡片」時，Claude 會先確認你目前打開的是哪一個。
Claude 桌面 app 裡的 Claude Code，使用你在 Claude 裡加入的 Heptabase plugin 或 connector 時，也能這樣做。如果你是在 Claude Code 裡用 /plugin 安裝 plugin，或在終端機、IDE 裡使用 Claude Code，Claude 無法在對話裡打開白板，請改為開著 Heptabase 桌面 app 或網頁版。
Plugin 可以做什麼
搜尋及閱讀卡片、日誌、白板、標籤資料庫、PDF、圖片、劃記與反向連結。
建立及編輯筆記卡片與日誌，可以加入圖片、影片、音訊與附件。
從檔案或連結建立 PDF、圖片、音訊、影片、網頁與 YouTube 卡片。
建立及編輯標籤資料庫、把卡片加入或移出資料庫、設定卡片屬性、整理標籤，以及把卡片移到垃圾桶或還原。
讀取及整理 Inbox，以及讀取或設定 Space Instructions。
建立白板、區塊、連線與心智圖，並排列白板上的物件。
在對話中顯示卡片，以及在 Claude 和 Claude 桌面 app 裡的 Claude Code 打開白板。
編輯白板等少數操作需要在 Heptabase app 裡執行。在 Claude，以及 Claude 桌面 app 裡的 Claude Code 中，Claude 會在需要時直接在對話裡打開 Heptabase。其他情況請開著 Heptabase 桌面 app 或網頁版，並登入同一個帳號。
從電腦上傳檔案需要能執行指令的 Claude Code。在 Claude 中，Claude 可以從連結存下檔案。
所有支援的操作，請參考 Heptabase MCP 工具參考。
權限與連線問題
Claude 能做哪些事，取決於連接時你授予的權限。唯讀連線可以搜尋和閱讀，但無法建立或編輯內容。若要讓 Claude 修改內容，請重新連接並授予寫入權限。
如果 plugin 沒有正常運作：
確認連接的是正確的 Heptabase 帳號。
安裝後開啟新的對話或 Claude Code session。
如果 Claude 沒有使用 Heptabase，請在要求中提到 Heptabase。
在 Claude Code 中輸入
/mcp檢查連線，必要時重新登入。如果連線已過期，請重新連接。
如果問題持續，請聯絡 Heptabase 客服，並提供你使用的 app 與錯誤訊息。
其他連接方式
若要連接其他 AI 服務，請參考 Heptabase MCP。如果你用的是在終端機裡工作的 coding agent，而且它和 Heptabase 桌面 app 在同一台電腦上，請參考 Heptabase CLI。