Configuration

Available in v0.2.7-dev2

To configure GDAI MCP’s server port, runtime port, etc there are 2 main steps:

1. Create and update properties in the gdai_mcp_project_config.json
2. Add the env section to your MCP server config

Create gdai_mcp_project_config.json

1. Open the Godot Editor and goto the GDAI MCP tab at the bottom
2. On the right side, click the Override Config button, this will create a gdai_mcp_project_config.json and open it in the file explorer.
3. Now open the gdai_mcp_project_config.json file and update the properties you want. See the below section for a detailed list of available properties.
4. After update the config, make sure to Restart the Godot Editor.
5. Now copy the updated mcp server config shown in the GDAI MCP tab and paste that in your MCP Client’s server config.

Note: If you have any JSON syntax errors in the config file, the errors will be printed in Godot Editor’s Output tab.

gdai_mcp_project_config.json file reference

Below are details for each property that can be set in the gdai_mcp_project_config.json file.

• GDAI_MCP_SERVER_PORT: (optional) Port to use for the MCP server (default is 3571)
• GDAI_RUNTIME_SERVER_PORT: (optional) Port to use for the runtime server. This is used by some tools like simulate_input (default is 3572)

{
  "GDAI_MCP_SERVER_PORT": "3571",
  "GDAI_RUNTIME_SERVER_PORT": "3572"
}

Adding env section to your MCP server config json

Once you’ve updated the gdai_mcp_project_config.json file, copy the contents of that file and paste it under the env section of your MCP server config json.

Example if you want to change the MCP server and runtime port to 5010 and 5011 respectively. First update the gdai_mcp_project_config.json as mentioned above.

Then for Claude Desktop the MCP server config file is claude_desktop_config.json. Update it as below adding the env section.

File: claude_desktop_config.json

{
  "mcpServers": {
    "gdai-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        ".... existing path here"
-      ]
+      ],
+      "env": {
+        "GDAI_MCP_SERVER_PORT": "5010",
+        "GDAI_RUNTIME_SERVER_PORT": "5011"
+      }
    }
  }
}