Configuration

The RoCodex installer auto-configures your selected coding agents during setup. This page covers how the configuration works and how to adjust it manually if needed.

How Auto-Configuration Works

When you run the installer, it asks which coding agents you use. It then writes the correct MCP server entry into each agent's config file:

ClientConfig File
Cursor~/.cursor/mcp.json
Claude Desktop%APPDATA%\Claude\claude_desktop_config.json
OpenCode~/.config/opencode/opencode.json
Windsurf~/.codeium/windsurf/mcp_config.json
Codex CLI~/.codex/config.toml

Manual Configuration

If you need to add RoCodex to a client manually, use this entry format:

{
  "mcpServers": {
    "rocodex": {
      "command": "~/.rocodex/bin/rocodex",
      "args": []
    }
  }
}

Replace ~/.rocodex/bin/rocodex with the full path to your RoCodex binary. On Windows this is typically %USERPROFILE%\.rocodex\bin\rocodex.exe.

Roblox Studio Plugin

The RoCodex plugin is installed automatically into your Roblox Studio plugins folder. It requires:

  • HTTP Requests enabled — Go to Game Settings > Security > Allow HTTP Requests
  • Plugin enabled — Check Plugins > Manage Plugins

Local Bridge Settings

SettingDefault
Local port48123
Poll endpointhttp://localhost:48123/poll
Result endpointhttp://localhost:48123/result

Important: Point your MCP client at the RoCodex binary, not at the localhost bridge. The binary handles the Studio connection internally.

License Management

Your license key is stored at:

%USERPROFILE%\.rocodex\license.json

To change your license key, delete this file and re-run the installer.