Common Issues

MCP Server not able to start in Claude/Cursor/VSCode/etc

This may happen if your project path contains spaces.

How to resolve?

1. Copy the res://addons/gdai-mcp-server-godot/gdai_mcp_server.py file to a path that doesn’t contain spaces.
2. Update the MCP json file to point to the new path of the file.

Eg.

Before

{
    "mcpServers": {
        "godot-mcp": {
            "command": "uv",
            "args": ["run", "D:/Projects/My Awesome Game/addons/gdai-mcp-plugin-godot/gdai_mcp_server.py"]
        }
    }
}

After

Copy the gdai_mcp_server.py file to D:/stuff

{
    "mcpServers": {
        "godot-mcp": {
            "command": "uv",
            "args": ["run", "D:/stuff/gdai_mcp_server.py"]
        }
    }
}

MCP Server started but showing no tools in Claude/Cursor/VSCode/etc

This may happen if you open your IDE first before opening your project in the Godot Editor.

How to resolve?

Ensure that your Godot project is running and the GDAI MCP server is active, before you start your IDE like Cursor, Windsurf, etc.

To check if the server is active, open the GDAI MCP tab in the bottom panel of the Godot Editor and see the MCP Server Status.