Setup Instructions — G2 MCP Server

Prerequisites

Node.js 18+ — required to run the proxy via npx.
API key — an IgniteTech-issued X-API-KEY. Request access if you don't have one.
G2 installation (optional) — set the G2_ROOT environment variable to your G2 directory to enable KB export and analysis tools. Without it, documentation search and codebase analysis tools still work.

Choose Your Client

Cursor IDE

Config file: .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)

Configuration — cross-platform

{
  "mcpServers": {
    "g2-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ignitetech/g2-mcp@latest",
        "https://g2mcp.ignitetech.ai/mcp/",
        "--header",
        "X-API-KEY:${G2_MCP_API_KEY}"
      ],
      "env": {
        "G2_MCP_API_KEY": "<YOUR_API_KEY>",
        "G2_ROOT": "/path/to/g2"
      }
    }
  }
}

This config works on macOS, Linux, and Windows — Cursor invokes npx natively on all platforms. Set G2_ROOT to your G2 installation directory, or remove the line if you don't have G2 installed locally.

Claude Code

Config file: ~/.claude.json (user) or .mcp.json (project)

Configuration

{
  "mcpServers": {
    "g2-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ignitetech/g2-mcp@latest",
        "https://g2mcp.ignitetech.ai/mcp/",
        "--header",
        "X-API-KEY:${G2_MCP_API_KEY}"
      ],
      "env": {
        "G2_MCP_API_KEY": "<YOUR_API_KEY>",
        "G2_ROOT": "/path/to/g2"
      }
    }
  }
}

{
  "mcpServers": {
    "g2-mcp": {
      "command": "cmd",
      "args": [
        "/c", "npx", "-y",
        "@ignitetech/g2-mcp@latest",
        "https://g2mcp.ignitetech.ai/mcp/",
        "--header",
        "X-API-KEY:${G2_MCP_API_KEY}"
      ],
      "env": {
        "G2_MCP_API_KEY": "<YOUR_API_KEY>",
        "G2_ROOT": "C:\\path\\to\\g2"
      }
    }
  }
}

On Windows, Claude Code cannot invoke npx directly — the cmd /c wrapper is required.

Set G2_ROOT to your G2 installation directory, or remove the line if you don't have G2 installed locally.

Claude Desktop

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuration

{
  "mcpServers": {
    "g2-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ignitetech/g2-mcp@latest",
        "https://g2mcp.ignitetech.ai/mcp/",
        "--header",
        "X-API-KEY:${G2_MCP_API_KEY}"
      ],
      "env": {
        "G2_MCP_API_KEY": "<YOUR_API_KEY>",
        "G2_ROOT": "/path/to/g2"
      }
    }
  }
}

Config file: %APPDATA%\Claude\claude_desktop_config.json

Configuration

{
  "mcpServers": {
    "g2-mcp": {
      "command": "cmd",
      "args": [
        "/c", "npx", "-y",
        "@ignitetech/g2-mcp@latest",
        "https://g2mcp.ignitetech.ai/mcp/",
        "--header",
        "X-API-KEY:${G2_MCP_API_KEY}"
      ],
      "env": {
        "G2_MCP_API_KEY": "<YOUR_API_KEY>",
        "G2_ROOT": "C:\\path\\to\\g2"
      }
    }
  }
}

On Windows, Claude Desktop cannot invoke npx directly — the cmd /c wrapper is required.

Set G2_ROOT to your G2 installation directory, or remove the line if you don't have G2 installed locally. Restart Claude Desktop after saving the config.

macOS tip: If Claude Desktop reports npx not found, your GUI environment may not include Homebrew or nvm paths. Replace "command": "npx" with the full path, e.g. "command": "/opt/homebrew/bin/npx" or "command": "/usr/local/bin/npx". Run which npx in Terminal to find the correct path.

Key Handling & Security

Do not commit API keys into git. Use environment variables or ${VAR} placeholders in config files.
The proxy's ${G2_MCP_API_KEY} syntax is expanded at runtime from the env block — your key never appears in the args.
If a key has ever been shared outside your machine, contact your IgniteTech admin to have it rotated.

← Back to landing page • Request API access