OpenCode
OpenCode starts Ark from its saved MCP configuration. Let its coding agent choose the format supported by the version you have installed.
Recommended Setup
Section titled “Recommended Setup”- Send the guided setup request to an OpenCode session with terminal and file-editing access.
- Approve the setup changes and enter keys in the private editor.
- Review the
ark-seedconnection and tool permissions in OpenCode.
The classic and V2 configuration shapes below are alternatives for manual setup. You do not need to choose or edit JSON yourself when the setup agent can verify your installed schema.
Manual configuration for classic and V2 editions
Choose the Scope
Section titled “Choose the Scope”- User/global default:
~/.config/opencode/opencode.jsonoropencode.jsonc, subject to the selected profile/configuration overrides. - Project: project-root
opencode.jsonoropencode.jsonc. V2 docs also describe.opencode/opencode.json(c)and hierarchical merging.
Complete the shared prerequisites. Preserve existing entries and JSONC comments. Check precedence and same-name entries: V2 project overrides replace a whole server object, so partial overrides can drop required fields. Never automatically commit machine-specific paths.
Classic Repository Template
Section titled “Classic Repository Template”Use this only when your installed OpenCode schema puts server names directly
under mcp. command is an array, and environment settings use
environment, not env:
{ "$schema": "https://opencode.ai/config.json", "mcp": { "ark-seed": { "type": "local", "command": [ "/absolute/path/to/uv", "--directory", "/absolute/path/to/ark-mcp", "run", "--locked", "--no-sync", "python", "-m", "ark_mcp" ], "enabled": true, "environment": { "ARK_MCP_ENV_FILE": "/absolute/path/to/private/ark-mcp/.env", "MCP_TRANSPORT": "stdio", "MCP_AUTH_MODE": "local" } } }}V2 Official-Docs Variant
Section titled “V2 Official-Docs Variant”Use this only when the installed schema requires mcp.servers and uses
disabled rather than classic enabled. Here disabled: false permits
connection, and codemode: false requests directly exposed tools:
{ "$schema": "https://opencode.ai/config.json", "mcp": { "servers": { "ark-seed": { "type": "local", "command": [ "/absolute/path/to/uv", "--directory", "/absolute/path/to/ark-mcp", "run", "--locked", "--no-sync", "python", "-m", "ark_mcp" ], "disabled": false, "codemode": false, "environment": { "ARK_MCP_ENV_FILE": "/absolute/path/to/private/ark-mcp/.env", "MCP_TRANSPORT": "stdio", "MCP_AUTH_MODE": "local" } } } }}Replace all absolute-path placeholders on the actual execution host.
type: "local" means subprocess transport, not project scope. Both variants
contain only non-secret environment settings; Ark reads credentials from the
private file. OpenCode may inherit other environment variables that override
that file, so check presence/names without printing values.
Verify
Section titled “Verify”Run the discovery-only check, then Your First Tool Call. Finish active jobs before reloading the connection. If you need troubleshooting commands, ask the agent to use the help for your installed OpenCode version.
See Integrations, Python, Getting Started, Tools, and Configuration.
Official Sources
Section titled “Official Sources”Sources consulted 2026-11-10 describe V2. The classic shape follows this repository’s integration/setup references; check the installed edition before selecting either template.