Heptabase MCP 和 Heptabase CLI 都能讓你在其他 AI 工具裡使用 Heptabase：搜尋、閱讀、撰寫及整理你的卡片、日誌與白板。兩者能做的事大致相同，差別主要在怎麼連接。
用 ChatGPT、Claude 這類聊天 app，或其他支援 MCP 的 AI 工具，請用 MCP。官方 Heptabase plugin 就是透過 MCP 連接，請參考在 ChatGPT 與 Codex 中使用 Heptabase或在 Claude 與 Claude Code 中使用 Heptabase。
AI 工具在終端機裡工作，而且和 Heptabase 桌面 app 在同一台電腦上，可以用 CLI。需要讀取 AI Tutor 課程，或要讓 AI 直接處理電腦上的檔案時，CLI 比較方便。
基本差別
MCP | CLI | |
怎麼連接 | 透過 Heptabase 的伺服器連接你的帳號 | 在你的電腦上，透過 Heptabase 桌面 app 連接 |
需要設定什麼 | 安裝官方 Heptabase plugin，或在 AI 工具裡加入 MCP 伺服器網址，再登入 Heptabase 授權 | 在桌面 app 的 Settings → AI Features → CLI 開啟 CLI，並安裝 Heptabase CLI Skills |
需要開著 Heptabase 嗎 | 大部分操作不需要。編輯白板等少數操作需要開著桌面 app 或網頁版* | 一定要開著桌面 app。heptabase start 可以幫你打開 |
可以在哪些 AI 工具使用 | ChatGPT、Claude、Codex、Claude Code、Cursor，以及其他支援遠端 MCP 伺服器的 AI 工具 | 能在你的電腦上執行指令的 AI 工具，例如 Claude Code 和 Codex |
可以操作哪個工作區 | 你自己的工作區，別人分享給你的工作區無法操作 | 同左 |
電腦上的檔案 | 無法直接讀寫。能執行指令的 AI 工具可以把檔案上傳到 Heptabase，或用下載連結取得檔案 | 可以直接匯入電腦上的檔案（最大 2,000 MB），也能把 Heptabase 裡的原始檔案匯出到電腦上的資料夾 |
訂閱 | Pro、Premium、Premium+ 訂閱或有效試用 | 同左 |
* 進行這些操作時，請開著 Heptabase 桌面 app 或網頁版，並登入同一個帳號。在 ChatGPT、Claude、Codex，以及 Claude 桌面 app 裡的 Claude Code，AI 也可以直接在對話裡打開 Heptabase 來完成。行動版 app 無法執行這些操作。
能做的事
✓ 表示可以，✕ 表示不行。
MCP | CLI | |
搜尋與閱讀 | ||
搜尋，以及列出卡片和白板 | ✓ | ✓ |
閱讀卡片、日誌、白板與劃記 | ✓ | ✓ |
讀取反向連結 | ✓* | ✓ |
筆記與日誌 | ||
建立及編輯筆記卡片與日誌 | ✓ | ✓ |
一次讀取一段日期範圍內的日誌 | ✓ | ✓ |
把卡片移到垃圾桶及還原 | ✓ | ✓ |
重新命名白板、區塊與媒體卡片 | ✓* | ✓ |
白板 | ||
把卡片放到白板上 | ✓ | ✓ |
建立及移動白板 | ✓* | ✓ |
移動、排列、對齊、縮放、變更顏色或移除物件 | ✓* | ✓ |
建立區塊、連線與心智圖 | ✓* | ✓ |
檢查排版及匯出示意截圖 | ✓* | ✓ |
標籤資料庫 | ||
列出標籤，讀取標籤資料庫 | ✓ | ✓ |
建立標籤資料庫與標籤群組，移動標籤 | ✓ | ✓ |
編輯及查詢標籤資料庫 | ✓* | ✓ |
替卡片加上標籤，設定屬性值 | ✓ | ✓ |
替卡片移除標籤 | ✓* | ✓ |
檔案與媒體 | ||
存下網頁與 YouTube 影片 | ✓ | ✓ |
從檔案建立 PDF、圖片、音訊與影片卡片 | ✓¹ | ✓ |
閱讀 PDF 與影音逐字稿 | ✓ | ✓ |
看圖片的內容 | ✓ | ✓² |
取出原始檔案 | 取得下載連結 | 匯出到電腦上的資料夾 |
Inbox 與 Space Instructions | ||
讀取及整理 Inbox | ✓ | ✓ |
讀取及設定 Space Instructions | ✓ | ✓ |
只有一邊能做的事 | ||
在對話裡顯示卡片 | ✓³ | ✕ |
在對話裡打開白板並編輯 | ✓⁴ | ✕ |
讀取 AI Tutor 的課程、單元與對話紀錄 | ✕ | ✓ |
* 需要開著 Heptabase 桌面 app 或網頁版，或在對話裡打開 Heptabase，見上方說明。
¹ 網路上的檔案可以直接用網址匯入。電腦上的檔案需要由能執行指令的 AI 工具上傳，例如 Claude Code 和 Codex；在其他 AI 工具裡，請先把檔案加入 Heptabase。
² CLI 會先把圖片匯出到電腦上，再由 AI 工具用自己的方式開啟。
³ 只在支援的 AI 工具裡顯示，其他工具會改用文字回覆。
⁴ 適用於 ChatGPT、Claude、Codex，以及 Claude 桌面 app 裡的 Claude Code，並且要透過這些 app 加入的 Heptabase plugin 或 connector 連接。
跟 Heptabase 內建 AI Agent 的差別
Heptabase app 裡也有內建的 AI Agent。它和 MCP、CLI 的差別：
在哪裡工作：AI Agent 在 Heptabase 裡運作，知道你正在看哪張卡片、哪個白板，以及選取了哪些物件，並在你目前所在的工作區工作，別人分享給你的工作區也可以。MCP 和 CLI 從其他 AI 工具連進來，只能操作你自己的工作區。
用量：AI Agent 使用 Heptabase 的 AI credits，也可以使用你自己的 API key 或登入 Codex。透過 MCP 或 CLI 時，回答你的是那個 AI 工具的模型，用的是那個工具的方案，不會用到 Heptabase 的 AI credits。
AI Tutor：學習課程只能在 Heptabase 裡進行。
想了解 AI Agent 會讀取哪些內容，請參考AI Agent 可以讀取哪些 Space 內容？；AI credits 請參考方案與價格。