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.

Setup

1. Install GodotIQ:

   pip install godotiq

2. Add to VS Code settings:

   Add the following to your workspace settings (.vscode/settings.json):

   .vscode/settings.json

   {
     "mcp": {
       "servers": {
         "godotiq": {
           "command": "godotiq",
           "args": ["--project", "/path/to/your/godot/project"]
         }
       }
     }
   }

   Replace the path with your Godot project root. Alternatively, use uv and set GODOTIQ_PROJECT_ROOT — see Installation for details.

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.

Advanced Configuration

Custom Python Path

If godotiq isn’t on your PATH:

.vscode/settings.json

{
  "mcp": {
    "servers": {
      "godotiq": {
        "command": "/path/to/venv/bin/godotiq",
        "args": ["--project", "/path/to/your/godot/project"]
      }
    }
  }
}

Bridge Configuration

For Pro addon users:

.vscode/settings.json

{
  "mcp": {
    "servers": {
      "godotiq": {
        "command": "godotiq",
        "args": [
          "--project", "/path/to/your/godot/project",
          "--bridge-port", "6551"
        ]
      }
    }
  }
}

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

Installation Full installation guide with all client options.

Workflows Common workflow patterns for AI-assisted game development.