Set up Linear MCP in one OpenCode workspace

Set up Linear MCP for one workspace

For one repository, the whole setup is a local opencode.jsonc, one auth command, and a quick check with opencode mcp list.

The config stays in the repository, so it affects only that directory and leaves your global OpenCode profile alone.

If another repository needs Linear tools, add the same opencode.jsonc pattern there.

1. Create a workspace config file

Create opencode.jsonc at the workspace root with this MCP block:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "linear-project": {
      "type": "remote",
      "url": "https://mcp.linear.app/mcp",
      "enabled": true
    }
  }
}

I use "linear-project" instead of "linear" to avoid collisions with other tools or global configs. You can choose another key, but keep the URL the same and use that key in the auth command.

2. Authenticate the server

From that workspace, run:

opencode mcp auth linear-project

If your OpenCode version does not include this command, open the app settings and authenticate from the MCP section instead.

3. Confirm it is active in that workspace

opencode mcp list

Then give the agent one read-only Linear query:

Show me the first five open issues assigned to me in Linear.

If the query returns fresh workspace data, the setup works.

4. If opencode mcp auth is missing

Some OpenCode builds put MCP auth in the app instead of the CLI. If opencode mcp auth linear-project is unavailable, open OpenCode settings, find the MCP section, select the same Linear server entry, and authenticate there.

After that, run:

opencode mcp list

If linear-project appears in the workspace output, the setup is valid.

5. How to confirm it is workspace-only

The file is local to the repository path. Other directories keep their own MCP state, so you can enable Linear one repository at a time.

Run opencode mcp list in this repository, then run it again in a directory without the same opencode.jsonc. The Linear entry should appear only in the configured workspace.

Related links

• Linear MCP for OpenCode (español)
• OpenCode MCP docs
• Linear MCP server docs
• Model Context Protocol overview