ChatGPT 或 Claude 等工具可以找到筆記、日誌、標籤、白板、圖片及已解析的 PDF,再使用相關內容進行研究、摘要、檢視或更新。
連接 AI 服務
選擇你的 AI 服務:ChatGPT · Claude Code · Cursor · Antigravity CLI · 其他服務
ChatGPT
目前必須在 ChatGPT 網頁版設定自訂 MCP 應用程式。ChatGPT 桌面版或行動版沒有這些設定選項。
Developer mode 是否可用,也取決於 ChatGPT 方案或工作區。如果網頁版沒有顯示 Developer mode,目前的方案或工作區可能不支援自訂 MCP 應用程式。
在瀏覽器開啟 ChatGPT 網頁版並登入。設定時不要使用桌面版或行動版。
開啟 Settings → Apps → Advanced Settings。
啟用 Developer mode。
返回 Apps,選擇建立自訂應用程式的選項。如果沒有此選項,請確認已啟用 Developer mode,且方案或工作區支援自訂 MCP 應用程式。
填入以下欄位:
Name:自訂名稱,例如 Heptabase。
MCP Server URL:
https://api.heptabase.com/mcpAuthentication:
OAuthIcon(選填):可在這裡下載 Heptabase 標誌。
繼續前往 Heptabase 授權頁面。必要時先登入,再點擊 Allow。
返回 ChatGPT 網頁版,想讓 ChatGPT 使用 Heptabase MCP 連線時,選取 Heptabase 應用程式。
可以試著問 ChatGPT:「找出我關於 X 的筆記,摘要最相關的幾篇」,或「顯示與專案 Y 相關的白板」。
Claude Code
開啟終端機
指令:
claude mcp add --transport http heptabase-mcp https://api.heptabase.com/mcp登入 Claude Code,輸入 /mcp,再進入 heptabase-mcp 完成驗證。
Cursor
開啟
~/.cursor/mcp.json(若檔案不存在,請建立)。加入以下遠端伺服器設定:
{
"mcpServers": {
"heptabase-mcp": {
"url": "https://api.heptabase.com/mcp"
}
}
}儲存檔案、重新整理 Cursor,並完成授權流程。
Antigravity CLI
將以下遠端伺服器設定加入
~/.gemini/antigravity-cli/mcp_config.json,或工作區中的.agents/mcp_config.json:{
"mcpServers": {
"heptabase-mcp": {
"serverUrl": "https://api.heptabase.com/mcp"
}
}
}Antigravity CLI 直接透過
serverUrl連接,不需要mcp-remote。如果授權開始前就顯示
Unauthorized,請提供 Antigravity CLI 版本與錯誤截圖並聯絡我們。
其他 MCP 服務
你可以將 Heptabase MCP 連接至任何支援 Model Context Protocol(MCP) 的第三方 AI 服務,例如 ChatGPT 或 Claude。
在外部 AI 服務中,找到新增或連接 MCP 伺服器的選項。
輸入 Heptabase MCP 端點網址:
https://api.heptabase.com/mcp
頁面會自動導向 Heptabase,接著:
登入帳戶(如果尚未登入)
授權連線
授權後會回到外部 AI 服務,連線即建立完成。
現在就能直接在該服務中使用 Heptabase MCP 工具。
試試你的第一個任務
大部分情況下,不需要記住工具名稱。描述想讓 AI 找到、閱讀或更新的內容,它就能選擇適合的 Heptabase MCP 工具。
想做什麼 | 可以這樣問 |
找出相關筆記 | 找出我關於再生能源的筆記,摘要最相關的幾篇。 |
閱讀與整理 | 閱讀這張卡片,整理主要論點與待釐清的問題。 |
更新日誌 | 將這段摘要附加到今天的日誌。 |
在支援 MCP Apps 的用戶端中,也可以請助理顯示找到的卡片。更新內容需要寫入權限。
權限與支援範圍
連線可用的工具取決於授權時授予的權限。唯讀連線可以瀏覽及閱讀內容,但工具清單不會出現寫入工具。如果助理無法建立或編輯內容,請檢查連線權限,並在需要啟用這些操作時授予寫入權限。
Heptabase 的 MCP(Model Context Protocol)讓外部 AI 服務能列出、搜尋、閱讀、建立、編輯及整理 Heptabase 工作區的內容。在相容的應用程式中,也能以互動檢視顯示選定卡片。
工具參考
若想更精確控制,可以明確指定工具。例如:
「使用
search_by_keyword找出包含這個確切片語的筆記。」「使用
search_by_semantic找出與這個想法相關的筆記,即使用詞不同也要找到。」「使用
read_object閱讀這張卡片的完整內容。」
