使用 ChatGPT 或 Codex？建議先使用官方 Heptabase 插件，安裝並連接帳號即可，不需要 Developer mode、手動設定自訂 MCP 或安裝 Heptabase CLI。下方保留的是自訂應用程式及其他相容服務的手動 MCP 設定方式。

Heptabase 的 MCP（Model Context Protocol）讓外部 AI 服務能列出、搜尋、閱讀、建立、編輯及整理 Heptabase 工作區的內容。在相容的應用程式中，也能以互動檢視顯示選定卡片。

ChatGPT 或 Claude 等工具可以找到筆記、日誌、標籤、白板、圖片及已解析的 PDF，再使用相關內容進行研究、摘要、檢視或更新。

連接 AI 服務

ChatGPT：手動設定自訂 MCP 應用程式

若要使用較簡單的官方插件設定方式，請參考在 ChatGPT 與 Codex 中使用 Heptabase。下方 Developer mode 與僅限網頁版設定的要求適用於自訂 MCP 應用程式，不是官方插件的安裝要求。

目前必須在 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/mcp
- Authentication：OAuth
- Icon（選填）：可在這裡下載 Heptabase 標誌。
繼續前往 Heptabase 授權頁面。必要時先登入，再點擊 Allow。
返回 ChatGPT 網頁版，想讓 ChatGPT 使用 Heptabase MCP 連線時，選取 Heptabase 應用程式。
可以試著問 ChatGPT：「找出我關於 X 的筆記，摘要最相關的幾篇」，或「顯示與專案 Y 相關的白板」。

執行以下指令：

claude mcp add --transport http heptabase-mcp https://api.heptabase.com/mcp

加入以下遠端伺服器設定：

{
    "mcpServers": {
        "heptabase-mcp": {
            "url": "https://api.heptabase.com/mcp"
        }
    }
}

將以下遠端伺服器設定加入 ~/.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 版本與錯誤截圖並聯絡我們。

你可以將 Heptabase MCP 連接至任何支援 Model Context Protocol（MCP） 的第三方 AI 服務，例如 ChatGPT 或 Claude。

大部分情況下，不需要記住工具名稱。描述想讓 AI 找到、閱讀或更新的內容，它就能選擇適合的 Heptabase MCP 工具。

在支援 MCP Apps 的用戶端中，也可以請助理顯示找到的卡片。更新內容需要寫入權限。

連線可用的工具取決於授權時授予的權限。唯讀連線可以瀏覽及閱讀內容，但工具清單不會出現寫入工具。如果助理無法建立或編輯內容，請檢查連線權限，並在需要啟用這些操作時授予寫入權限。

若想更精確控制，可以明確指定工具。例如：