​
What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to interact with external tools and databases. Insforge provides an MCP server that gives your AI direct access to:
  • Database Management: Create/modify/delete tables, view schemas, manage table relationships
  • Storage Buckets: Create/list/delete storage buckets for file uploads
  • Backend Metadata: Get API keys, backend configuration, and system information
  • SDK Documentation: Access SDK usage instructions for database, auth, and storage, AI Integration operations

​
Quick Installation

The easiest way to install MCP for your AI tool:
Insforge Dashboard Connect
1

Create or select your project

Visit https://insforge.dev and either:
  • Create a new project, or
  • Select an existing project
2

Click Connect

Click the Connect button to integrate with Agents
3

Install the MCP

Insforge Connect DialogSelect your AI tool tab and use the Copy button to copy the command, then run it in your terminal.The command includes your API key and base URL automatically:
npx @insforge/install --client cursor \
  --env API_KEY=ik_d02a35cfd8056c18e9e59b34bf8bf773 \
  --env API_BASE_URL=https://trqnn5z3.us-east.insforge.app
The Copy button provides a ready-to-run command with your API key and base URL already configured for your specific project
Replace [your-tool] with one of: cursor, claude, windsurf, cline, roo-code

​
Manual Installation

For tools that support direct MCP configuration:

​
Step 1: Install the MCP server

npm install -g @insforge/mcp-server

​
Step 2: Configure your AI tool

Edit your Claude configuration file:macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "insforge": {
      "command": "npx",
      "args": ["-y", "@insforge/mcp-server"],
      "env": {
        "API_KEY": "your-api-key",
        "API_BASE_URL": "https://your-app.us-east.insforge.app"
      }
    }
  }
}
  1. Install the Cline extension in VS Code
  2. Open Cline settings (Cmd/Ctrl + Shift + P → “Cline: Open Settings”)
  3. Go to MCP Servers section
  4. Add new server:
{
  "insforge": {
    "command": "npx",
    "args": ["-y", "@insforge/mcp-server"],
    "env": {
      "API_KEY": "your-api-key",
      "API_BASE_URL": "https://your-app.us-east.insforge.app"
    }
  }
}
Cursor uses a composer file. Run the installer:
npx @insforge/install --client cursor \
  --env API_KEY=your-api-key \
  --env API_BASE_URL=https://your-app.us-east.insforge.app
Or manually add to .cursorrules in your project:
You have access to Insforge backend at https://your-app.us-east.insforge.app
Use the MCP tools to interact with the database, auth, and storage.

​
Verify Installation

Test your MCP connection by asking your AI assistant: 
"Using Insforge MCP, show me what database tables exist"
Or for a more comprehensive test: 
"Create a new table called 'test_mcp' with id and name fields"
Your AI should be able to:
  • List existing tables
  • Create new tables
  • Query data
  • Manage authentication
  • Handle file uploads

​
Available MCP Tools

Once connected, your AI assistant has access to these tool categories:

Database Tools

Create, modify, and manage database tables and schemas

Storage Tools

Manage storage buckets for file uploads and organization

Metadata Tools

Access backend configuration and system information

Documentation Tools

Retrieve API documentation and implementation guides

​
Troubleshooting

  1. Restart your AI tool after configuration
  2. Check the configuration file path is correct
  3. Verify your API key is valid
  4. Ensure the API_BASE_URL is accessible
  • Verify your API key in the dashboard
  • Check that the API_BASE_URL matches your backend
  • For local development, ensure Docker is running
  • For cloud: Check your internet connection
  • For local: Verify Docker is running with docker ps
  • Test the backend directly: curl [API_BASE_URL]/health

​
Next Steps

AI Tools Setup

Detailed setup for each AI tool

Database Overview

Learn about database operations

Quick Start

Build your first app

API Reference

Explore all available APIs