logo

quickActions

如何在 Zeabur 上使用 Insforge

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

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