Docs / Building Your Site / MCP Server Setup
Back to FastMode

MCP Server Setup

What is the MCP Server?

The Fast Mode MCP (Model Context Protocol) Server connects AI coding assistants directly to Fast Mode. This means your AI can:

  • Build websites that work perfectly with Fast Mode
  • Manage your CMS content (create, update, delete items)
  • Create collections and fields automatically
  • Deploy websites directly to your projects
  • Validate templates and manifests as it works

Prerequisites

  • Node.js 18+ installed on your computer
  • An MCP-compatible AI tool (see below)
  • A Fast Mode account

Quick Reference

All IDEs use the same configuration - just add it to the appropriate settings file:

{
  "mcpServers": {
    "fastmode": {
      "command": "npx",
      "args": ["-y", "fastmode-mcp"]
    }
  }
}

Cursor

Step 1: Open MCP Settings

  1. Open Cursor
  2. Go to Settings (gear icon or Cmd/Ctrl + ,)
  3. Navigate to Features → MCP Servers
  4. Click Add new MCP server

Step 2: Add Configuration

Enter the following:

  • Name: fastmode
  • Type: command
  • Command: npx -y fastmode-mcp

Or edit ~/.cursor/mcp.json directly:

{
  "mcpServers": {
    "fastmode": {
      "command": "npx",
      "args": ["-y", "fastmode-mcp"]
    }
  }
}

Step 3: Restart Cursor

Close and reopen Cursor for the changes to take effect.

Claude Desktop

Step 1: Open Config File

The config file location depends on your operating system:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Step 2: Add Configuration

Add the Fast Mode server configuration:

{
  "mcpServers": {
    "fastmode": {
      "command": "npx",
      "args": ["-y", "fastmode-mcp"]
    }
  }
}

Step 3: Restart Claude Desktop

Fully quit and reopen Claude Desktop.

VS Code with Claude Code Extension

Step 1: Install Claude Code

Install the Claude Code extension from the VS Code marketplace.

Step 2: Open Settings

  1. Open Command Palette (Cmd/Ctrl + Shift + P)
  2. Search for "Claude Code: Open Settings"
  3. Navigate to MCP Servers

Step 3: Add Configuration

Add the configuration to your VS Code settings or ~/.claude/settings.json:

{
  "mcpServers": {
    "fastmode": {
      "command": "npx",
      "args": ["-y", "fastmode-mcp"]
    }
  }
}

VS Code with Continue.dev

Step 1: Install Continue

Install the Continue extension from the VS Code marketplace.

Step 2: Open Config

  1. Open Command Palette (Cmd/Ctrl + Shift + P)
  2. Search for "Continue: Open config.json"

Step 3: Add MCP Configuration

Add the experimental.modelContextProtocolServers section:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "fastmode-mcp"]
        }
      }
    ]
  }
}

Windsurf (Codeium)

Step 1: Open Config File

Edit the MCP configuration file:

  • macOS/Linux: ~/.codeium/windsurf/mcp_config.json
  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Step 2: Add Configuration

{
  "mcpServers": {
    "fastmode": {
      "command": "npx",
      "args": ["-y", "fastmode-mcp"]
    }
  }
}

Step 3: Restart Windsurf

Restart Windsurf for the changes to take effect.

Antigravity IDE

Important: Antigravity IDE requires the shell wrapper method because it doesn't load your shell's PATH.

Step 1: Open Config File

Edit the MCP configuration file:

  • macOS/Linux: ~/.gemini/antigravity/mcp_config.json
  • Windows: %USERPROFILE%\.gemini\antigravity\mcp_config.json

Step 2: Add Configuration (Shell Wrapper Required)

macOS/Linux:

{
  "mcpServers": {
    "fastmode": {
      "command": "/bin/zsh",
      "args": ["-l", "-c", "npx -y fastmode-mcp"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "fastmode": {
      "command": "cmd",
      "args": ["/c", "npx -y fastmode-mcp"]
    }
  }
}

Step 3: Restart Antigravity

Restart Antigravity IDE for the changes to take effect.

Zed

Step 1: Open Settings

  1. Open Zed
  2. Go to Settings (Cmd + , on macOS)
  3. Click Open Settings to edit settings.json

Step 2: Add MCP Configuration

Add the context servers configuration:

{
  "context_servers": {
    "fastmode": {
      "command": {
        "path": "npx",
        "args": ["-y", "fastmode-mcp"]
      }
    }
  }
}

Step 3: Restart Zed

Restart Zed for the changes to take effect.

Claude Code CLI

For the Claude Code command-line interface:

Option 1: Use the claude command

claude mcp add fastmode -- npx -y fastmode-mcp

Option 2: Edit settings directly

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "fastmode": {
      "command": "npx",
      "args": ["-y", "fastmode-mcp"]
    }
  }
}

Other IDEs

If your IDE isn't listed above, find your MCP config file and use the shell wrapper method:

macOS/Linux:

{
  "mcpServers": {
    "fastmode": {
      "command": "/bin/zsh",
      "args": ["-l", "-c", "npx -y fastmode-mcp"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "fastmode": {
      "command": "cmd",
      "args": ["/c", "npx -y fastmode-mcp"]
    }
  }
}

Common config file locations:

  • ~/.config/your-ide/mcp.json
  • ~/.your-ide/mcp_config.json
  • %APPDATA%\your-ide\mcp_config.json (Windows)

Alternative Installation Methods

If npx doesn't work (common with nvm, volta, or homebrew Node.js installations), try these alternatives:

Method 1: Shell Wrapper (Recommended)

This works with any Node.js installation:

{
  "mcpServers": {
    "fastmode": {
      "command": "/bin/zsh",
      "args": ["-l", "-c", "npx -y fastmode-mcp"]
    }
  }
}

Method 2: Global Install with Full Path

  1. Install globally: 
    npm install -g fastmode-mcp
  2. Find the installation path: 
    which fastmode-mcp
  3. Use the full path in your config: 
    {
  "mcpServers": {
    "fastmode": {
      "command": "/Users/yourname/.nvm/versions/node/v20.10.0/bin/fastmode-mcp"
    }
  }
}

Method 3: Use Node Directly

  1. Install in a known location: 
    npm install fastmode-mcp --prefix ~/.fastmode-mcp
  2. Reference in config: 
    {
  "mcpServers": {
    "fastmode": {
      "command": "node",
      "args": ["~/.fastmode-mcp/node_modules/fastmode-mcp/dist/index.js"]
    }
  }
}

Method 4: Use Absolute Node Path

If Node.js isn't in the system PATH:

{
  "mcpServers": {
    "fastmode": {
      "command": "/usr/local/bin/node",
      "args": ["/usr/local/lib/node_modules/fastmode-mcp/dist/index.js"]
    }
  }
}

Platform-Specific Notes

macOS

  • If using Homebrew Node.js, the path is typically /opt/homebrew/bin/node (Apple Silicon) or /usr/local/bin/node (Intel)
  • If using nvm, the path is ~/.nvm/versions/node/vX.X.X/bin/node

Windows

  • Use backslashes or forward slashes in paths
  • Node.js is typically at C:\Program Files\nodejs\node.exe
  • Use where node to find your Node.js path
  • Example config: 
    {
  "mcpServers": {
    "fastmode": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": ["-y", "fastmode-mcp"]
    }
  }
}

Linux

  • Node.js is typically at /usr/bin/node or /usr/local/bin/node
  • Use which node to find your installation

First-Time Authentication

The first time your AI uses a Fast Mode tool, you'll need to authenticate:

What Happens

  1. Your browser opens to app.fastmode.ai/device
  2. A code appears in your AI tool (like "ABCD-1234")
  3. Sign in to Fast Mode (if not already)
  4. Enter the code and click Authorize
  5. Done! Your AI is now connected

Where Credentials Are Stored

After authentication, your credentials are saved to:

~/.fastmode/credentials.json

These refresh automatically, so you won't need to re-authenticate for 90 days.

Verify It's Working

Ask your AI assistant:

"What Fast Mode projects do I have access to?"

If the MCP server is working, it will list your projects. If you see an authentication prompt, follow the steps above.

Next Steps

Built in Fast Mode