# 在 Zeabur 上使用 Insforge 的教學指南

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

我們最近宣佈與 **InsForge** 建立[策略合作夥伴關係](https://zeabur.com/blogs/zeabur-insforge-partnerships)。InsForge 是專為 AI 寫程式 Agent 設計的領先 **Backend-as-a-Service (BaaS)** 平台。

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

**這就是 Zeabur 上的 [Insforge](https://insforge.dev/) 改變遊戲規則的地方。**

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

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

## 前置條件

- 一個 [Zeabur 帳號](https://zeabur.com/)（可免費開始）。
- 一個支援 MCP 的 AI 程式碼編輯器（如 **Cursor** 或 **Antigravity**）。

---

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

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

1. 登入你的 [**Zeabur 控制台**](https://zeabur.com/login)。
2. 建立一個 **New Project**（新專案，或選擇現有專案）。
3. 點擊 **Add Integration**（新增整合）→ **Insforge**。
4. 點擊 **Enable Insforge**。

![Enable Insforge button](https://cdn.zeabur.com/insforge%20partnerships/Enable%20Insforge%20button.png)

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

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

---

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

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

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

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

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

![Insforge Link](https://cdn.zeabur.com/insforge%20partnerships/insforge%20icon.png)

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

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

### 方法 2：整合頁面

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

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

![Zeabur Integration Page](https://cdn.zeabur.com/insforge%20partnerships/Zeabur%20integration%20page%20with%20insforge%20.png)

### 配置 Cursor / Antigravity

**一鍵 MCP 部署：**

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

![one click use insforge](https://cdn.zeabur.com/insforge%20partnerships/one%20click%20use%20insforge.png)

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

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

![Connect Project](https://cdn.zeabur.com/insforge%20partnerships/Connect%20Project.png)

```jsx
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](https://cdn.zeabur.com/insforge%20partnerships/Insforge%20MCP%20JSON.png)

![Zeabur Dashboard MCP JSON](https://cdn.zeabur.com/insforge%20partnerships/Zeabur%20Dashboard%20MCP%20JSON.png)

```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 建立了逐步安裝指南。你可以在我們的[文件](https://www.notion.so/How-to-Use-Insforge-on-Zeabur-2e8a221c948e8044a115ffd8540bdb04?pvs=21)中找到此指南（連結將在可用時更新）。

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

### 取得你的憑證

1. 在 Zeabur 控制台，進入 Insforge 服務的 **Integration** 分頁。
2. 記下你的網域 URL（例如 `https://xxxxx.ap-southeast.insforge.app`）。
    
    ![zeabur dashboard acquire insforge credentials](https://cdn.zeabur.com/insforge%20partnerships/CleanShot%202026-01-15%20at%2016.20.49%402x.png)
    
3. 在你的 Insforge 管理後台，進入 **Project Settings** -> **Connect** 並取得連接字串 (Connection String)。
    
    ![connection strings](https://cdn.zeabur.com/insforge%20partnerships/connection%20strings.png)

---

## 第四步：「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**
<video src="https://cdn-console.zeabur.com/f/brrUV/insforge%20demo.mov" controls />