OpenCode¶
Prerequisite: complete the Unity package installation.
Install and Authenticate¶
Install the stable OpenCode CLI (opencode) and configure a model provider using the official OpenCode documentation.
Unity Biome MCP does not currently support the separate OpenCode 2.0 beta executable (opencode2). The beta can be installed alongside stable OpenCode and has evolving contracts; see the official V2 migration status.
Restart Unity if the CLI was installed while the Editor was open.
In-Unity Chat¶
- Open MCP > Settings > Chat Settings > OpenCode Settings.
- Confirm that the
opencodebinary is detected. - Open MCP > Chat and select OpenCode.
The relay writes a temporary OpenCode configuration, passes it through OPENCODE_CONFIG, and starts a new opencode run process for each turn. See Chat Backends for current session behavior.
External MCP Client¶
The Unity package does not create a project-local OpenCode file. Do not paste the Setup Wizard's standard mcpServers clipboard JSON into OpenCode. Use the global configuration command with client key opencode so the packaged CLI applies OpenCode's client-specific root and command-array transformation.
The resulting stable configuration follows OpenCode's mcp.<server> local server shape. Run opencode mcp list to confirm that unity-biome-mcp is enabled. See the stable OpenCode MCP guide for client-side controls.
Client-specific Troubleshooting¶
| Symptom | Action |
|---|---|
| OpenCode is not found | Make opencode available on the login-shell PATH, then restart Unity |
| Provider or model is rejected | Verify the provider and model with OpenCode before using the same model ID in Chat |
| External MCP server is absent | Inspect the global config written by the CLI, then run opencode mcp list |
Only opencode2 is installed | Install stable opencode; the V2 beta backend is not currently supported |