Connect AI IDE

InsForge uses the MCP (Model Context Protocol) to let your AI coding agent interact with your backend. This guide covers how to connect various supported AI IDEs.

You must first enable InsForge in your Zeabur project before connecting an AI IDE.

Navigate to your project’s InsForge integration page in the Zeabur dashboard
Click Use in AI IDE
Select your AI IDE from the dropdown

Cursor

Cursor supports one-click installation via deeplink.

Select Cursor from the agent dropdown in the connection modal
Click Add to Cursor
Cursor will open automatically and prompt you to confirm the MCP server installation

Claude Code

Select Claude Code from the agent dropdown
Copy and run the terminal command:

npx @insforge/install --client claude-code --env API_KEY=YOUR_API_KEY --env API_BASE_URL=YOUR_API_ENDPOINT

Trae

Select Trae from the agent dropdown
Copy and run the terminal command:

npx @insforge/install --client trae --env API_KEY=YOUR_API_KEY --env API_BASE_URL=YOUR_API_ENDPOINT

Cline

Select Cline from the agent dropdown
Copy and run the terminal command:

npx @insforge/install --client cline --env API_KEY=YOUR_API_KEY --env API_BASE_URL=YOUR_API_ENDPOINT

Windsurf

Select Windsurf from the agent dropdown
Copy and run the terminal command:

npx @insforge/install --client windsurf --env API_KEY=YOUR_API_KEY --env API_BASE_URL=YOUR_API_ENDPOINT

Roo Code

Select Roo Code from the agent dropdown
Copy and run the terminal command:

npx @insforge/install --client roocode --env API_KEY=YOUR_API_KEY --env API_BASE_URL=YOUR_API_ENDPOINT

Manual MCP JSON Configuration

For other MCP-compatible tools, you can manually configure the MCP server.

macOS / Linux

{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": ["-y", "@insforge/mcp@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY",
        "API_BASE_URL": "YOUR_API_ENDPOINT"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "insforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@insforge/mcp@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY",
        "API_BASE_URL": "YOUR_API_ENDPOINT"
      }
    }
  }
}

Verifying the Connection

After installation, send the following prompt in your AI agent’s chat to verify the connection:

I'm using InsForge as my backend platform, fetch InsForge instruction doc to learn more about InsForge

The installation completes automatically when InsForge receives the first MCP call from your agent.

Troubleshooting

Connection not working? Make sure you’ve correctly copied the API_KEY and API_BASE_URL from the InsForge integration page.
Command fails on Windows? Ensure you’re using the Windows-specific configuration with cmd as the command.
Need help? Visit the Zeabur Forum for support.

Quick Start Usage & Billing