# 如何在 Zeabur 上使用 Insforge

> 为你的 AI 智能体提供生产就绪后端的最简单方式。

我们最近宣布与 **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 />