> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ref.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode

> Connect OpenCode to Ref Plans.

[Opencode MCP docs](https://opencode.ai/docs/mcp-servers/)

You can find your API key at [ref.tools/keys](https://ref.tools/keys)

## Install Steps

1. Create or update an `opencode.jsonc` file in your project:

```
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "RefPlan": {
      "type": "remote",
      "url": "https://api.plan.ref.tools/mcp",
      "enabled": true,
      "headers": {
        "x-ref-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

For plan-specific mode, use `"url": "https://api.plan.ref.tools/mcp?plan=<PLAN_ID>"`.

## Verify

Open a new chat and ask the agent to list your plans or read a specific plan.

## Get help

If you have any issues, please reach out to `help@ref.tools`. We're happy to help you get started!