# OpenCode Setup

Source checked: 2026-07-24
Official sources: https://opencode.ai/docs/mcp-servers/ and https://opencode.ai/docs/cli/

Use the complete Secure server address shown by Core during onboarding, including `?setup_attempt=...`. Outside onboarding, use `https://core.gradien.ai/mcp/continuity`.

## Add Core

Add Core to either your global `~/.config/opencode/opencode.json` or a project's
`opencode.json`. Merge the `mcp.core` entry into the existing JSON instead of
replacing the rest of the file:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "core": {
      "type": "remote",
      "url": "<secure-server-address>",
      "enabled": true
    }
  }
}
```

Alternatively, run the documented interactive wizard:

```bash
opencode mcp add
```

Choose a remote server, name it `core`, and paste the complete Secure server
address when prompted. OpenCode starts OAuth automatically when Core is first
used; you can trigger it explicitly with `opencode mcp auth core`. Verify with
`opencode mcp list`, then restart OpenCode if the tools do not appear.

If OpenCode says valid credentials already exist, do not reauthenticate unless the existing token is actually failing.