logo

quickActions

在 Zeabur 上使用 Insforge 的教學指南

為您的 AI Agent 提供生產就緒後端的最簡單教學指南。

Kyle ChungKyle Chung

我們最近宣佈與 InsForge 建立策略合作夥伴關係。InsForge 是專為 AI 寫程式 Agent 設計的領先 Backend-as-a-Service (BaaS) 平台。

你可以在幾秒鐘內生成一個漂亮的 React 前端，但如果你要求 AI「設置一個安全的資料庫、配置身份驗證並部署 API」，往往會得到一堆混亂的 Dockerfile 和損壞的設定檔。這會打斷你的心流（Flow）。

這就是 Zeabur 上的 Insforge 改變遊戲規則的地方。

Insforge 是一個 AI 原生的後端，旨在由 Agent（透過 MCP）進行管理；而 Zeabur 是處理基礎設施的 AI 原生部署平台。兩者的結合讓你無需離開編輯器，就能從「想法」直接跨越到「全端部署」。

在本指南中，我們將展示如何在 Zeabur 上一鍵部署 Insforge，並將其連接到你的 AI 程式碼編輯器。

前置條件

  • 一個 Zeabur 帳號（可免費開始）。
  • 一個支援 MCP 的 AI 程式碼編輯器（如 Cursor 或 Antigravity）。

第一步：從 Zeabur 整合市集部署

後端開發最大的痛點是初始設置。Zeabur 透過預配置的 Integration（整合）消除了這一痛點。

  1. 登入你的 Zeabur 控制台。
  2. 建立一個 New Project（新專案，或選擇現有專案）。
  3. 點擊 Add Integration（新增整合）→ Insforge。
  4. 點擊 Enable Insforge。

Enable Insforge button

這就是「更好的開發者體驗 (DX)」所在： 當你點擊安裝時，Zeabur 不僅僅是部署 Insforge 容器。它會自動建立一個全新的 PostgreSQL 服務 並在內部將其連結到 Insforge。你不需要手動複製連接字串或配置網路埠。Zeabur 為你處理了一切編排工作。

等待幾秒鐘，直到服務變綠（Running）。

第二步：連接你的 AI Agent (MCP 設置)

Insforge 服務部署完成後，你需要連接詳細資訊將其連結到你的 AI 編輯器 (MCP) 或前端應用程式。Zeabur 為此建立了一個專用資訊頁面。

有兩種簡單的方法可以存取此資訊：

方法 1：直接服務連結（推薦）

在你的 Zeabur 專案視圖中，找到位於「Add Service」按鈕正下方的 Insforge 圖示。

Insforge Link

點擊此圖示將重新導向到一個專用的 Insforge 資訊頁面。這個頁面是你的指揮中心，包含：

  • 專案資訊： 你的實例狀態和基本詳細資訊。
  • MCP 連接指南： 你需要複製貼上到 Cursor 或 Windsurf 中的確切指令。
  • 連接字串： 前端的資料庫 URL 和 API 端點。

方法 2：整合頁面

或者，你可以透過服務設定存取這些詳細資訊：

  1. 在專案地圖中點擊 Insforge 服務。
  2. 導航到 Integrations 分頁（或 Instructions 頁面，取決於模板版本）。
  3. 在這裡你會找到同一組憑證和連接指南。

Zeabur Integration Page

配置 Cursor / Antigravity

一鍵 MCP 部署：

對於 Cursor：點擊 Add to Cursor 按鈕。

one click use insforge

手動配置： → 打開你的編輯器設定。

  • 對於 Cursor： 前往 Cursor Settings > Features > MCP Servers > + Add New。
  • 對於 Antigravity： 前往終端機並插入指令（你可以在 Insforge Dashboard 中找到此頁面）。

Connect Project

npx @insforge/install 
--client antigravity 
--env API_KEY=ik_xxxxxxxxxxxxxx
--env API_BASE_URL=https://xxxxx.ap-southeast.insforge.app`.

根據你的喜好選擇 "SSE" (Server-Sent Events) 或指令模式，但最簡單的連接方式是使用 Insforge 提供的 npx 橋接。

將此配置添加到你的 MCP 設定檔中：

你可以在 Insforge Dashboard 或 Zeabur Insforge Integration 頁面找到此內容。

Insforge MCP JSON

Zeabur Dashboard MCP JSON

{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": [
        "-y",
        "@insforge/mcp@latest"
      ],
      "env": {
        "API_KEY": "你的_insforge_api_key",
        "API_BASE_URL": "https://API_BASE_URL.insforge.app"
      }
    }
  }
}

請將 URL 和 API Key 替換為你實際的 Zeabur 部署詳情。

為什麼這能提升開發者體驗： Zeabur 直接在這些頁面上展示 MCP 安裝指令。你不需要手動構建 JSON 配置或猜測 URL——只需複製螢幕上提供的指令即可。

第三步：存取連接詳情和憑證（可選）

這是神奇的一步。標準後端要求你閱讀文件並編寫 SQL。Insforge 暴露了一個 Model Context Protocol (MCP) 伺服器，允許你的 AI 編輯器 (Cursor/Windsurf) 直接與資料庫「對話」。

推薦方式：按照我們的逐步指南操作

為了簡化流程，我們為每個 AI Agent 建立了逐步安裝指南。你可以在我們的文件中找到此指南（連結將在可用時更新）。

請持續關注我們 Discord 社群的更新！

取得你的憑證

  1. 在 Zeabur 控制台，進入 Insforge 服務的 Integration 分頁。

  2. 記下你的網域 URL（例如 https://xxxxx.ap-southeast.insforge.app）。

    zeabur dashboard acquire insforge credentials

  3. 在你的 Insforge 管理後台，進入 Project Settings -> Connect 並取得連接字串 (Connection String)。

    connection strings

第四步：「Hello World」 測試

現在你的 Agent 已連接到 Zeabur 基礎設施，讓我們測試一下連接。Insforge 的強大之處在於你的 AI 可以自己閱讀手冊。

打開你的 AI Chat (Command+L / Ctrl+L) 並輸入：

"I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions."

觀察發生了什麼：

  1. 工具啟用： AI 將驗證它是否有權存取 insforge MCP 伺服器並觸發 fetch-docs 工具。
  2. 上下文攝取： 它將直接從你的 Zeabur 實例下載並閱讀 Insforge 文件，確切地學習如何建立資料表、管理身份驗證和處理資料。
  3. 確認： AI 將確認它理解 Insforge API 並準備好構建。

你現在正處於 "Vibe Coding" 狀態。你的 Agent 已經為你閱讀了文件。你現在可以繼續輸入諸如 「建立一個 'Todos' 表」 之類的指令，它將確切知道如何在 Zeabur 資料庫上執行該操作。

為什麼 Zeabur 是 Insforge 的最佳歸宿

你可能會問，「為什麼不直接在本地執行？」或「為什麼要用 Zeabur？」

  1. 毫不費力的後端整合： 透過將 Insforge 連接到 Zeabur，整個後端都為你處理好了。你的 AI 寫程式 Agent 變成了全端構建者。
  2. 一個 Prompt 從想法到上線： Zeabur 負責一切，包括網站部署。這是一種真正的「從想法到發布」的體驗，無需手動干預。
  3. 零配置網路： Insforge 需要資料庫。在 Zeabur 上，Insforge 和 Postgres 之間的通訊透過 私有內部網路 進行。它安全、超快，並且需要零設定。
  4. 持久且可擴展： Localhost 適合原型設計，但你無法分享。透過立即部署在 Zeabur 上，你的 AI Agent 從第一天起就在 生產級 基礎設施上構建。
  5. 成本效益： Zeabur 基於使用量的定價意味著你不需要為了測試一個想法每月支付 20 美元的 VPS 費用。你只需為你實際使用的 CPU/記憶體付費。
  6. 沒有 DevOps 頭痛： 如果伺服器當機，Zeabur 會重啟它。如果你需要更新 Insforge，只需重新部署。你只需做開發者，而不是系統管理員。

常見問題解答 (FAQ)

1. Insforge 與 Supabase 或 Firebase 有何不同？ 雖然 Supabase 和 Firebase 很棒，但 Insforge 是「Agent-First」（Agent 優先）的。 標準後端是為人設計的。Insforge 以 MCP 為核心設計，允許 AI Agent 自主理解資料庫架構並執行任務。

2. 在 Zeabur 上執行需要多少錢？ Zeabur 使用 按量付費模型。對於執行 Insforge 和 PostgreSQL 的典型入門專案，成本非常低（通常每月只需幾美元）。

3. 我可以直接連接到資料庫嗎？ 可以。 當你在 Zeabur 上部署 Insforge 時，你配置的是一個標準 PostgreSQL 資料庫。你可以在 Zeabur 控制台中找到外部連接字串，並使用 TablePlus、DBeaver 或 Prisma 等工具進行連接。

4. 我需要使用 AI 編輯器才能使用 Insforge 嗎？ 不需要。 Insforge 附帶完整的 管理後台 GUI。你可以像使用任何其他 CMS 或 BaaS 一樣，透過瀏覽器手動建立資料表和管理使用者。

5. 我的資料安全嗎？ 是的。Zeabur 將你的服務隔離在私有網路中。Insforge 和 PostgreSQL 之間的通訊在 Zeabur 內部進行。

6. 我以後可以遷移資料嗎？ 當然。由於 Zeabur 為你提供標準的 PostgreSQL 資料庫，你不會被鎖定。你可以隨時執行標準的 pg_dump 來匯出資料。

結論

Insforge（AI 原生後端）和 Zeabur（AI 原生部署）的結合消除了現代應用程式開發的摩擦。

透過遵循本指南，你建立了一個技術堆疊，其中：

  • Zeabur 管理伺服器。
  • Insforge 管理資料庫邏輯。
  • 你的 AI Agent 撰寫程式碼。

現在你可以完全專注於構建出色的產品。

立即在 Zeabur 上部署 Insforge

return Blogs