Godot MCP Setup

When to Use This Skill

• User explicitly requests MCP-based scene building
• User wants programmatic scene creation/modification
• User asks about scene automation tools

• User expresses interest in MCP functionality
• Alternative manual methods insufficient

Available Scripts

mcp_config_generator.gd

NEVER Do in MCP Setup

• NEVER suggest MCP for simple scene edits — MCP is for automation/batch operations. Single node addition? Use manual editor. MCP overhead (config + restart) wastes time.
• NEVER skip JSON syntax validation — Invalid JSON in

  claude_desktop_config.json

  = silent MCP failure. ALWAYS validate with

  ConvertFrom-Json

  before saving.
• NEVER forget to remind user to restart Claude Desktop — MCP changes require full app restart, NOT just new conversation. This is #1 user mistake.
• NEVER use global npm install without user permission —

  npm install -g

  modifies system. ALWAYS prefer

  npx

  (on-demand) unless user specifically wants global.
• NEVER assume Node.js is installed — Check

  node --version

  BEFORE attempting npx. Missing Node = cryptic "command not found" errors.

Installation Workflow

Step 1: Check if MCP is Already Installed

# Check if the Godot MCP server is configured
$mcpConfigPath = "$env:APPDATA\Claude\claude_desktop_config.json"
if (Test-Path $mcpConfigPath) {
    $config = Get-Content $mcpConfigPath | ConvertFrom-Json
    if ($config.mcpServers.godot) {
        Write-Host "Godot MCP server is already configured."
    }
}

Step 2: Install Godot MCP Server

# Install globally
npm install -g @modelcontextprotocol/server-godot

# OR use npx for on-demand execution
npx @modelcontextprotocol/server-godot

Step 3: Configure Claude Desktop

• Windows:

  %APPDATA%\Claude\claude_desktop_config.json

• macOS:

  ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux:

  ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-godot"]
    }
  }
}

Step 4: Restart Claude Desktop

Verification

mcp_godot_*

Common Issues

• Solution: Verify the JSON syntax in

  claude_desktop_config.json

• Solution: Check that Node.js and npm are installed

• Solution: Run PowerShell as Administrator on Windows

Reference

• Godot MCP Server: GitHub Repository
• MCP Protocol: Official Documentation

Related

• Master Skill: godot-master