Quick Usage (Already Configured)

OpenWork UI uses the OpenCode SDK for runtime MCP calls and events.
MCP config lives in opencode.json under mcp; OpenWork server only reads/writes config for remote clients.
MCP auth tokens are managed by OpenCode and stored outside the repo.
Remote UI traffic hits the OpenWork server at /opencode/*, which proxies to OpenCode.
The OpenWork server must include the workspace directory (via x-opencode-directory or directory query) so OpenCode loads the correct config.

Confirm the MCP entry type and required fields (local needs command[], remote needs url).
If refresh tokens are invalid, re-auth via OpenCode and reload the engine after config edits.
Avoid editing token files directly; use OpenCode commands or endpoints.
If the UI says "does not support OAuth", verify the directory matches the on-disk opencode.json path.
In remote mode, OpenWork approval gates apply for mcp.add and engine.reload unless auto-approve is explicitly enabled.

mcp-arch