VS Code Copilot

VS Code supports MCP servers through its settings, enabling GitHub Copilot to use GodotIQ tools for spatial analysis, code intelligence, and more.

Running godotiq install-addon automatically creates .github/copilot-instructions.md with development rules for this client. No manual configuration needed.

Setup

1. Install GodotIQ:

   pip install godotiq

2. Add to VS Code settings. Toggle Community or Pro and copy into .vscode/settings.json:

   Community Pro

   ~/.claude/mcp.json or via CLI bash Copy

   claude mcp add godotiq -- env GODOTIQ_PROJECT_ROOT=<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH> uvx godotiq

   ~/.claude/mcp.json or via CLI bash Copy

   claude mcp add godotiq -- env GODOTIQ_PROJECT_ROOT=<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH> GODOTIQ_LICENSE_KEY=GODOTIQ-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX uvx godotiq

   Option A — CLI bash Copy

   codex mcp add godotiq -- env GODOTIQ_PROJECT_ROOT=<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH> uvx godotiq

   Option B — ~/.codex/config.toml toml Copy

   [mcp_servers.godotiq]
   command = "uvx"
   args = ["godotiq"]
   
   [mcp_servers.godotiq.env]
   GODOTIQ_PROJECT_ROOT = "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>"

   Option A — CLI bash Copy

   codex mcp add godotiq -- env GODOTIQ_PROJECT_ROOT=<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH> GODOTIQ_LICENSE_KEY=GODOTIQ-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX uvx godotiq

   Option B — ~/.codex/config.toml toml Copy

   [mcp_servers.godotiq]
   command = "uvx"
   args = ["godotiq"]
   
   [mcp_servers.godotiq.env]
   GODOTIQ_PROJECT_ROOT = "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>"
   GODOTIQ_LICENSE_KEY = "GODOTIQ-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

   .cursor/mcp.json json Copy

   {
     "mcpServers": {
       "godotiq": {
         "command": "uvx",
         "args": ["godotiq"],
         "env": {
           "GODOTIQ_PROJECT_ROOT": "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>"
         }
       }
     }
   }

   .cursor/mcp.json json Copy

   {
     "mcpServers": {
       "godotiq": {
         "command": "uvx",
         "args": ["godotiq"],
         "env": {
           "GODOTIQ_PROJECT_ROOT": "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>",
           "GODOTIQ_LICENSE_KEY": "GODOTIQ-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
         }
       }
     }
   }

   ~/.codeium/windsurf/mcp_config.json json Copy

   {
     "mcpServers": {
       "godotiq": {
         "command": "uvx",
         "args": ["godotiq"],
         "env": {
           "GODOTIQ_PROJECT_ROOT": "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>"
         }
       }
     }
   }

   ~/.codeium/windsurf/mcp_config.json json Copy

   {
     "mcpServers": {
       "godotiq": {
         "command": "uvx",
         "args": ["godotiq"],
         "env": {
           "GODOTIQ_PROJECT_ROOT": "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>",
           "GODOTIQ_LICENSE_KEY": "GODOTIQ-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
         }
       }
     }
   }

   .vscode/settings.json json Copy

   {
     "mcp.servers": {
       "godotiq": {
         "command": "uvx",
         "args": ["godotiq"],
         "env": {
           "GODOTIQ_PROJECT_ROOT": "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>"
         }
       }
     }
   }

   .vscode/settings.json json Copy

   {
     "mcp.servers": {
       "godotiq": {
         "command": "uvx",
         "args": ["godotiq"],
         "env": {
           "GODOTIQ_PROJECT_ROOT": "<REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>",
           "GODOTIQ_LICENSE_KEY": "GODOTIQ-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
         }
       }
     }
   }

   macOS/Linux: pwd · Windows PowerShell: (Get-Location).Path

   Omit GODOTIQ_LICENSE_KEY to use Community. Add your license key to unlock the 14 Pro intelligence tools.

   Swap in your project path (placeholder: <REPLACE_WITH_YOUR_GODOT_PROJECT_PATH>). uvx auto-installs godotiq on first use.

3. Reload VS Code. Copilot will detect the MCP server automatically.

4. Verify: Ask Copilot: “Ping GodotIQ”. It should confirm the connection.

Tip

Use workspace settings (.vscode/settings.json) rather than user settings so the configuration is project-specific and can be committed to version control.

Tips for VS Code

Copilot Chat

Use Copilot Chat (Ctrl+Alt+I / Cmd+Alt+I on macOS) to interact with GodotIQ tools. Copilot will automatically discover and call the appropriate tools based on your questions.

GDScript Extension

Install the Godot Tools extension alongside GodotIQ for the best experience: syntax highlighting, autocompletion, and debugging combined with AI-powered analysis.

Workspace Trust

VS Code may ask you to trust the workspace before MCP servers can run. Accept the trust prompt for your Godot project directory.

Activate Pro

Toggle Pro in the snippet above and paste your license key in place of GODOTIQ-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Save .vscode/settings.json and reload the window.

If activation doesn’t take, see Manage or Troubleshooting.

Advanced Configuration

Bridge Configuration

The addon communicates via WebSocket on port 6007 by default. If that conflicts, update the addon_port in your .godotiq.json and the Godot addon settings to match.

Troubleshooting

Copilot doesn’t use GodotIQ tools

• Ensure GitHub Copilot extension is installed and active
• Check that MCP support is enabled in Copilot settings
• Verify the MCP server configuration in .vscode/settings.json
• Reload the window (Ctrl+Shift+P → “Reload Window”)

Server fails to start

• Check the Output panel (View → Output → select “MCP” from dropdown) for error messages
• Verify godotiq is installed: pip show godotiq
• Ensure the project path exists and contains project.godot

Bought Pro?

1. Toggle Pro in the snippet above and paste your license key.
2. Save .vscode/settings.json and reload the window.
3. Run godotiq auth status — expected: license: pro (active).
4. If activation fails, visit Manage or Troubleshooting. Or email [email protected].

Installation Full installation guide with all client options.

Workflows Common workflow patterns for AI-assisted game development.