Set up MCP for Cursor, Claude, Windsurf, and more

Overview

The InsForge MCP server gives your AI coding assistant direct access to your backend: database queries, schema management, storage, and more. Follow the instructions below for your AI client. Don’t see your tool? Browse the agent directory for the full list of tested integrations.

Prerequisites

An AI coding assistant (Cursor, Claude Code, GitHub Copilot, etc.)
An InsForge project - create one here if you haven’t already

Local MCP configuration (recommended)

If you prefer to configure MCP locally, select your AI coding assistant below:

Cursor

Installation

You can one-click install the MCP server in Cursor by clicking the “Add to Cursor” button in the screenshot below:

Alternatively, you can install the InsForge MCP server manually:

Open Cursor Settings
Go to Tools & MCP
Click New MCP Server (Add a Custom MCP Server)

Paste the MCP JSON from your InsForge project
Save the configuration file
You should see a green dot, indicating InsForge is installed successfully

Verify installation

To verify the connection, start a new chat session in Cursor and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the Connected status indicator on your InsForge dashboard (top right corner).

Claude Code

Installation

Add the InsForge MCP server to your Claude Code:

Select Claude Code in the dropdown list
Copy and paste the following installation command in your terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Claude Code and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

GitHub Copilot

Installation

Add the InsForge MCP server to your GitHub Copilot:

Select Copilot in the dropdown list
Open the terminal and paste the following installation command in your GitHub Copilot terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Copilot and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Google Antigravity

Installation

Add the InsForge MCP server to your Antigravity:

Select Antigravity in the dropdown list
Copy and paste the following installation command in your Antigravity terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Antigravity and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Kiro

Installation

Add the InsForge MCP server to your Kiro:

Select Kiro in the dropdown list
Copy and paste the following installation command in your Kiro terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Kiro and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Codex

Installation

Add the InsForge MCP server to your Codex:

Select Codex in the dropdown list
Copy and paste the following installation command in your terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Codex and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Cline

Installation

Add the InsForge MCP server to your Cline:

Select Cline in the dropdown list
Copy and paste the following installation command in your Cline terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Cline and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Windsurf

Installation

Add the InsForge MCP server to your Windsurf:

Select Windsurf in the dropdown list
Copy and paste the following installation command in your Windsurf terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Windsurf and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Trae

Installation

Add the InsForge MCP server to your Trae:

Select Trae in the dropdown list
Copy and paste the following installation command in your Trae terminal
Run the command

Alternatively, Trae offers a first-party integration with InsForge, allowing you to install InsForge directly from Trae’s official MCP marketplace:

Open Trae’s Settings → navigate to MCP
Click on Add and then select Add from Marketplace
Search “InsForge” and add it from the marketplace
For required credentials API_KEY and API_BASE_URL, you can find them in your InsForge Settings, under the Connect tab.

Verify installation

To verify the connection, start a new chat in Trae and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Qoder

Installation

Add the InsForge MCP server to your Qoder:

Select Qoder in the dropdown list
Copy and paste the following installation command in your Qoder terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Qoder and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Roo Code

Installation

Add the InsForge MCP server to your Roo Code:

Select Roo Code in the dropdown list
Copy and paste the following installation command in your Roo Code terminal
Run the command

Verify installation

To verify the connection, start a new chat session in Roo Code and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

OpenCode

Installation

Add the InsForge MCP server to your OpenCode:

Select OpenCode in the dropdown list
Copy and paste the following installation command in your terminal
Run the command

Verify installation

To verify the connection, start a new chat session in OpenCode and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

MCP JSON

Installation

Add the InsForge MCP server to your coding agent with MCP JSON:

Select MCP JSON in the dropdown list
Copy and paste the following MCP JSON configuration in your agent

Verify installation

To verify the connection, start a new chat session and send this prompt to your agent:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Remote MCP

The fastest way to get started is with Remote MCP. A single command attempts installation and tries to handle authentication and project binding. The command may still prompt you for manual steps if the automatic flow cannot complete. Run the following command in your terminal:

npx add-mcp https://mcp.insforge.dev/mcp

The add-mcp command works for most coding agents, but not all. Currently it supports: Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Goose, GitHub Copilot, OpenCode, VS Code, Zed.

After running the command, the system will automatically generate a configuration file for your coding agent.

Connect and bind project

Some MCP clients automatically prompt you to log in during setup. Others may require manual authentication or project binding steps if the automatic flow cannot complete. Either way, authentication opens a browser window where you can log in to your InsForge account and grant organization/project access to the MCP client.

Cursor

You can find the configuration file in .cursor/mcp.json as below:

{
  "mcpServers": {
    "insforge": {
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

In menu Preferences → Cursor Settings → Tools & MCP, you should see InsForge MCP server is added successfully. If the InsForge MCP server shows the status “Needs authentication”, click the connect button to authenticate.

Claude Code

After installation, you will find the configuration file in .mcp.json as below:

{
  "mcpServers": {
    "insforge": {
      "type": "http",
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

Then in a regular terminal (not the IDE extension) run:

claude /mcp

Select the “insforge” server, then “Authenticate” to begin the authentication flow.

GitHub Copilot

After installation, you will find the configuration file in .vscode/mcp.json as below:

{
  "servers": {
    "insforge": {
      "type": "http",
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

Google Antigravity

Add this configuration to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "insforge": {
      "serverUrl": "https://mcp.insforge.dev/mcp"
    }
  }
}

Then restart Antigravity. It will auto-authenticate.

Gemini

After installation, you will find the configuration file in .gemini/settings.json as below:

{
  "mcpServers": {
    "insforge": {
      "type": "http",
      "url": "https://mcp.insforge.dev/mcp"
    }
  }
}

Start the Gemini CLI and run the following command to authenticate the server:

/mcp auth insforge

Codex

If you are using Codex for the first time, you may need to enable the rmcp feature. To do so, add the following into your ~/.codex/config.toml file:

[beta]
rmcp = true

After installation, you will find the configuration file in .codex/config.toml as below:

[mcp_servers.insforge]
type = "http"
url = "https://mcp.insforge.dev/mcp"

Then authenticate:

codex mcp login insforge

Finally, run /mcp inside Codex to verify authentication.Alternatively, you can run the following command to install the MCP server:

codex mcp add insforge --url https://mcp.insforge.dev/mcp

Cline

You can install the InsForge MCP server to your Cline by running the following command in your terminal:

npx -y @smithery/cli mcp add devel/insforge --client cline

Alternatively, you can follow the official Cline documentation to add the InsForge MCP server with parameters:

Server Name: insforge
Server URL: https://mcp.insforge.dev/mcp
Transport Type: Streamable HTTP

After adding the server, you’ll see an error message asking to authenticate. Click the “Authenticate” button that appears to authenticate.

Windsurf

Add this configuration to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.insforge.dev/mcp"
      ]
    }
  }
}

Windsurf does not currently support remote MCP servers over HTTP transport. You need to use the mcp-remote package as a proxy.

Roo Code

You can install the InsForge MCP server to your Roo Code by running the following command in your terminal:

npx -y @smithery/cli mcp add devel/insforge --client roocode

OpenCode

After installation, you will find the configuration file in ./opencode.json as below:

{
  "mcp": {
    "insforge": {
      "type": "remote",
      "url": "https://mcp.insforge.dev/mcp",
      "enabled": true
    }
  }
}

Then run the following command to authenticate:

opencode mcp auth insforge

This will open your browser to complete the OAuth authentication flow.

Verify installation

To verify the connection, start a new chat session in your AI coding assistant and send this prompt:

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to
learn about InsForge instructions.

If the connection is successful, you will see the MCP Connected status indicator on your InsForge dashboard (top right corner).

Troubleshooting

Changes not taking effect

Most AI clients require a full restart after MCP config changes. Close and reopen the application.

​Overview

​Prerequisites

​Local MCP configuration (recommended)

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Installation

​Verify installation

​Remote MCP

​Connect and bind project

​Verify installation

​Troubleshooting

Overview

Prerequisites

Local MCP configuration (recommended)

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Installation

Verify installation

Remote MCP

Connect and bind project

Verify installation

Troubleshooting