opencode MCP client setup

opencode supports remote MCP servers and can run OAuth for those servers. It is a high-confidence smoke target for DCR and refresh-token behavior.

OAuth config

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orkestia-workflow": {
      "type": "remote",
      "url": "https://mcp.orkestia.dev/mcp",
      "enabled": true
    }
  }
}

Authenticate the server:

opencode mcp auth orkestia-workflow

Header-token fallback

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orkestia-workflow": {
      "type": "remote",
      "url": "https://mcp.orkestia.dev/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:ORKESTIA_AGENT_TOKEN}"
      }
    }
  }
}

Smoke test

1. Run the auth command.
2. Confirm whoami resolves the expected organization.
3. Wait for access-token expiry or force a refresh path and confirm no full reauth is required.
4. Run list_workflow_types and get_workflow_schema.

Official docs

• opencode MCP servers