跳至主要內容

Heptabase MCP 工具參考

依任務瀏覽 MCP 工具,並查看哪些工具需要開著 Heptabase。

本頁依任務分類,列出 Heptabase MCP 的所有工具。提出要求時不需要點名工具,AI 助理會自己選擇。若要連接 AI 助理,請參考 Heptabase MCP。

​

標示 需要開著 Heptabase 的工具會在 Heptabase app 裡執行。請開著桌面 app 或網頁版,並登入同一個帳號。透過 ChatGPT 或 Claude 連接時,AI 助理也可以直接在對話裡打開 Heptabase。其他工具都不需要開著 app。

​

​

​

瀏覽與搜尋

  • list_cards:依類型、標籤、白板或時間列出卡片,不讀取內容。

  • list_tags:列出標籤的階層與卡片數量。

  • list_whiteboards:列出白板與白板階層。

  • search_by_keyword:用精確的關鍵字或短語搜尋。PDF、影片與音訊卡片只比對標題。

  • search_by_semantic:依語意搜尋,用詞不同也找得到。

  • search_object_content:在一張卡片、一篇日誌或一份已解析的 PDF 裡搜尋文字。

​

​

閱讀

  • read_object:讀取卡片、日誌或其他物件。長篇內容可以分段讀取。

  • read_journal_range:讀取一段日期範圍內的日誌,每次最多 185 天。

  • read_whiteboard:讀取白板的結構,或白板上物件的內容。

  • read_pdf:讀取已解析 PDF 卡片的頁面。

  • read_image:讀取圖片,包含從 PDF 解析出的圖片。

  • read_card_highlights:讀取筆記卡片或 PDF 卡片上的劃記與劃記筆記。

  • read_backlinks:找出連結、提及或放置某個物件的卡片、日誌與白板。需要開著 Heptabase。

  • read_database:讀取標籤資料庫的屬性、選項與檢視。

  • query_database:用篩選與排序條件查詢標籤資料庫裡的卡片。需要開著 Heptabase。

  • get_file_download_url:下載原始的 PDF、圖片、音訊、影片或附件。

​

​

撰寫筆記與日誌

  • create_object:建立筆記卡片,或替還沒有日誌的日期建立日誌。

  • edit_note_card_content:只修改筆記卡片的一部分,不必整張重寫:取代指定的文字、在最後加入內容,或改寫整張卡片。同一次呼叫裡的修改會一起儲存,有一處失敗就都不儲存。

  • edit_journal_content:用同樣的方式編輯日誌;那天還沒有日誌時會一併建立。

這三個工具都能加入圖片、影片、音訊與附件,來源可以是 Heptabase 裡的檔案或網址。

​

​

​

把檔案與連結存成卡片

  • import_file_from_url:從公開網址匯入檔案,最大 50 MB。

  • get_file_upload_url、import_file_from_upload:從電腦上傳檔案,最大 2,000 MB。AI 助理需要能執行指令,例如 Codex 或 Claude Code。

  • create_pdf_card_from_file、create_image_card_from_file、create_audio_card_from_file、create_video_card_from_file:用匯入的檔案建立卡片。

  • parse_pdf:解析 PDF 卡片,之後才能讀取頁面內容。較長的 PDF 可能需要幾分鐘。

  • create_web_card_from_url:把網頁存成網頁卡片。

  • create_video_card_from_url:把 YouTube 影片存成影片卡片,並以影片字幕作為逐字稿。

如果連結已經存成卡片,會沿用原本的卡片,不會重複建立;卡片在垃圾桶裡時會一併還原。

​

​

​

整理卡片與標籤

  • edit_card_properties:設定標籤資料庫中卡片的屬性值。

  • update_database_card_membership:把卡片加入標籤資料庫,或從資料庫移出,卡片本身不會被刪除。移出卡片需要開著 Heptabase。

  • create_database:建立標籤資料庫。

  • edit_database:重新命名標籤資料庫,並編輯屬性、選項與檢視。需要開著 Heptabase。

  • create_tag_group:在 Tags 側邊欄建立標籤群組。

  • move_tags:把標籤移到另一個標籤底下、移進標籤群組,或移到最上層。

  • trash_cards:把卡片移到垃圾桶。移除前,卡片會留在原本的白板上。

  • restore_cards:從垃圾桶還原卡片,卡片會回到原本的位置。

  • rename_object:重新命名白板、區塊,或 PDF、網頁、圖片、影片、音訊卡片。需要開著 Heptabase。

​

​

處理 Inbox

  • list_inbox_items:列出 Inbox 裡的項目:你加入的卡片和訊息,以及提及、回覆、引用與邀請。

  • add_cards_to_inbox:把卡片加入 Inbox,可以指定之後提醒你的日期。

  • update_inbox_items:把項目標成完成、已讀或未讀,或設定、清除提醒日期。

  • remove_inbox_items:把你加入的卡片和訊息從 Inbox 移除,卡片和訊息本身不會被刪除。提及、回覆、引用與邀請只能標成完成。

如果是 AI 助理自己挑出要變更或移除的項目,它會先列出清單,等你確認。

​

​

操作白板

除了 place_whiteboard_objects,這一類的工具都需要開著 Heptabase。沒有開著 app 時,place_whiteboard_objects 只能把卡片放在既有內容的右側。

  • create_whiteboard:建立白板或子白板。

  • move_whiteboard:把白板移到階層中的其他位置。

  • create_whiteboard_shortcut:在另一個白板上放置白板捷徑。

  • place_whiteboard_objects:把既有的卡片與日誌放到白板上。

  • move_whiteboard_objects:在白板內移動物件。

  • move_whiteboard_objects_across_whiteboards:把物件移到另一個白板,並保留原本的排列。

  • arrange_whiteboard_objects:把物件排成一列、一欄或格狀。

  • align_whiteboard_objects:依邊緣或中心對齊物件。

  • resize_whiteboard_objects:調整物件大小,或收合、展開物件。

  • update_whiteboard_objects_color:變更物件與連線的顏色。

  • remove_whiteboard_objects:從白板移除物件,不會刪除卡片。

  • create_section:在物件周圍建立區塊。

  • create_connections:在物件之間建立連線,可以加上標籤文字。

  • update_connection:變更連線的路徑或顏色。

  • create_mind_map:用文字、卡片與劃記建立心智圖。

  • update_mind_map:新增、編輯、移動或刪除心智圖節點,並調整版面配置。

  • read_whiteboard_layout:讀取每個物件的位置與大小。

  • lint_whiteboard:檢查白板上是否有物件重疊或連線交錯。

  • screenshot_whiteboard:擷取簡化的白板畫面,讓 AI 助理檢查排版。

​

​

在對話中顯示

  • render_cards:在 ChatGPT、Claude 與 Codex 中以互動檢視顯示卡片。

  • open_heptabase:在對話裡打開白板,你可以直接編輯,AI 助理的修改也會即時出現。

  • navigate_heptabase:切換對話裡打開的白板,或在旁邊打開卡片。

  • read_heptabase_view:確認你在對話裡打開的是哪個白板和哪張卡片。

open_heptabase 與後面兩個工具,只有在 ChatGPT 或 Claude 裡設定的連線才能使用,例如透過官方 plugin 連接。Codex 與 Claude 桌面 app 裡的 Claude Code 使用這個連線時,也能在對話裡打開白板。Codex 或 Claude Code 自己建立的連線,以及在終端機或 IDE 裡的 Codex CLI、Claude Code,都無法在對話裡打開 Heptabase。

​

​

​

遵循 Space Instructions

  • read_space_instructions:讀取 Space Instructions,也就是你為 AI 在這個空間怎麼工作所訂的規則。AI 助理開始工作前會先讀取並遵守。

  • set_space_instructions:把一張既有的筆記卡片設為 Space Instructions。之後要新增規則時,AI 助理會編輯那張卡片。

​

​

​

參考頁面

read_system_manual_page 提供 Heptabase 為這些工具撰寫的使用指南,內容包含核心概念、Space Instructions、整理知識庫、處理 Inbox、存下外部資料、筆記的格式語法、標籤資料庫的屬性值,以及白板和心智圖的排版方式。AI 助理需要時會自己讀取。

是否回答了您的問題?