# ZeaburでInsforgeを使う方法

> AIエージェントに本番環境対応のバックエンドを最も簡単に提供する方法。

先日、AIコーディングエージェント向けに設計された主要な**Backend-as-a-Service (BaaS)** である **InsForge** との[戦略的パートナーシップ](https://zeabur.com/blogs/zeabur-insforge-partnerships)を発表しました。

美しいReactフロントエンドは数秒で生成できても、AIに「安全なデータベースのセットアップ、認証設定、APIのデプロイ」を依頼すると、Dockerfileや設定ファイルが壊れてしまい、収拾がつかなくなることがよくあります。これでは開発のフロー（流れ）が止まってしまいます。

**ここで、Zeabur上の [Insforge](https://insforge.dev/) がゲームチェンジャーとなります。**

Insforgeは、エージェント（MCP経由）が管理するように設計されたAIネイティブなバックエンドであり、Zeaburはインフラストラクチャを処理するAIネイティブなデプロイメントプラットフォームです。この2つを組み合わせることで、エディタを離れることなく「アイデア」から「フルスタックデプロイ」まで実現できます。

このガイドでは、ZeaburにInsforgeをワンクリックでデプロイし、AIコードエディタに接続する方法を紹介します。

## 前提条件

- [Zeaburアカウント](https://zeabur.com/)（無料で開始できます）。
- MCPをサポートするAIコードエディタ（**Cursor** や **Antigravity** など）。

---

## ステップ 1: Zeaburインテグレーションからデプロイ

バックエンド開発における最大の課題は初期設定です。Zeaburは、事前設定済みのインテグレーション機能でこれを排除します。

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）になるまで数秒待ちます。

---

## ステップ 2: AIエージェントを接続する (MCP設定)

Insforgeサービスがデプロイされたら、AIエディタ（MCP）やフロントエンドアプリにリンクするための接続詳細が必要です。Zeaburはこのための専用情報ページを作成します。

この情報にアクセスするには、2つの簡単な方法があります：

### 方法 1: 直接サービスリンク（推奨）

Zeaburプロジェクトビューで、「Add Service」ボタンのすぐ下にある **Insforgeアイコン** を探してください。

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

このアイコンをクリックすると、専用の **Insforge Information Page** にリダイレクトされます。このページはコマンドセンターであり、以下が含まれます：

- **プロジェクト情報:** インスタンスのステータスと基本詳細。
- **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キーは、実際のZeaburデプロイメントの詳細に置き換えてください。*

**なぜこれが開発者体験を向上させるのか:**
Zeaburは **MCPインストールコマンド** をページ上に直接表示します。JSON設定を手動で構築したり、URLを推測したりする必要はありません。画面に表示されたコマンドをコピーするだけです。

---

## ステップ 3: 接続詳細と認証情報の取得（オプション）

ここが魔法のステップです。標準的なバックエンドではドキュメントを読み、SQLを書く必要があります。Insforgeは **Model Context Protocol (MCP)** サーバーを公開しており、AIエディタ（Cursor/Windsurf）がデータベースと直接「会話」することを可能にします。

**推奨される方法：ステップバイステップガイドに従う**

プロセスを簡素化するために、各AIエージェントに合わせたインストールガイドを作成しました。このガイドは[ドキュメント](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)

---

## ステップ 4: 「Hello World」テスト

エージェントがZeaburインフラストラクチャに接続されたので、接続をテストしましょう。Insforgeの強みは、AIが自分でマニュアルを読める点にあります。

AIチャット（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.  **コンテキストの取り込み:** AIはZeaburインスタンスから直接Insforgeのドキュメントをダウンロードして読み込み、テーブルの作成方法、認証管理、データ処理の方法を正確に学習します。
3.  **確認:** AIはInsforge APIを理解し、構築の準備ができたことを確認します。

これであなたは「Vibe Coding（バイブコーディング）」状態です。エージェントがあなたの代わりにドキュメントを読みました。あとは *"Create a 'Todos' table"*（ToDoテーブルを作成して）のようなコマンドを続けるだけで、Zeaburデータベース上で正確に実行する方法をAIが理解します。

---

## なぜZeaburがInsforgeに最適な場所なのか

「なぜローカルで実行しないのか？」「なぜZeaburなのか？」と思うかもしれません。

1.  **手間いらずのバックエンド統合:** InsforgeをZeaburに接続することで、バックエンド全体が処理されます。AIコーディングエージェントがフルスタックビルダーになります。
2.  **プロンプトひとつでアイデアからローンチまで:** Zeaburはサイトのデプロイを含め、すべてを処理します。手動介入ゼロで「アイデアからローンチ」を実現します。
3.  **ゼロコンフィグ・ネットワーキング:** Zeabur上では、InsforgeとPostgres間の通信は **プライベート内部ネットワーク** 上で行われます。安全で超高速、設定は不要です。
4.  **永続性とスケーラビリティ:** Localhostはプロトタイプには良いですが、共有できません。Zeaburにデプロイすることで、AIエージェントは初日から *本番環境* のインフラ上で構築を行います。
5.  **コスト効率:** Zeaburの使用量ベースの価格設定により、実際に使用したCPU/メモリ分のみを支払います。
6.  **DevOpsの頭痛の種なし:** サーバーがダウンしてもZeaburが再起動します。システム管理者ではなく、開発者のままでいられます。

### **よくある質問 (FAQ)**

**1. InsforgeはSupabaseやFirebaseとどう違いますか？**
**Insforgeは「エージェントファースト」です。** 一般的なバックエンドは人間向けに設計されていますが、Insforgeは **MCP** を核として設計されており、AIエージェントが自律的にデータベーススキーマを理解し、タスクを実行できます。

**2. Zeaburでの実行コストは？**
Zeaburは **使用量ベースの課金モデル** を採用しています。InsforgeとPostgreSQLを使用する典型的なスタータープロジェクトの場合、コストは非常に低く（多くの場合、月額数ドル）済みます。

**3. データベースに直接接続できますか？**
**はい。** Zeaburダッシュボードで外部接続文字列を見つけ、**TablePlus、DBeaver、Prisma** などのツールを使用して接続できます。

**4. Insforgeを使用するにはAIエディタが必要ですか？**
**いいえ。** Insforgeには完全な **管理ダッシュボードGUI** が付属しています。ブラウザから手動でテーブル作成やユーザー管理が可能です。

**5. データは安全ですか？**
はい。Zeaburはサービスをプライベートネットワーク内に隔離します。InsforgeとPostgreSQL間の通信はZeabur内部で行われます。

**6. 後でデータを移行できますか？**
もちろんです。標準的なPostgreSQLデータベースが提供されるため、いつでも `pg_dump` を実行してデータをエクスポートできます。

## 結論

**Insforge**（AIネイティブ・バックエンド）と **Zeabur**（AIネイティブ・デプロイメント）の組み合わせは、現代のアプリ開発から摩擦を取り除きます。

このガイドに従うことで、以下の環境が整いました：
- **Zeabur** がサーバーを管理。
- **Insforge** がデータベースロジックを管理。
- **あなたのAIエージェント** がコードを書く。

これで、素晴らしいプロダクトを作ることに完全に集中できます。

**Zeaburで今すぐInsforgeをデプロイ**
<video src="https://cdn-console.zeabur.com/f/brrUV/insforge%20demo.mov" controls />