Cline integration

Cline is a VS Code extension with full MCP support. Oka Reason works as a standard MCP server — no Cline-specific adapter needed.

Setup

1. Open MCP settings

In VS Code, click the MCP Servers icon in Cline’s top navigation bar, then click Configure MCP Servers.

2. Add Oka

Add to the configuration file that opens:

{
  "mcpServers": {
    "oka": {
      "command": "npx",
      "args": ["-y", "@oka-core/reason"]
    }
  }
}

The config file location varies by platform:

OS	Path
macOS	`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
Linux	`~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
Windows	`%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`

3. Authenticate

After Cline connects, use the login tool:

Use the login tool to authenticate with Oka

This opens your browser to id.oka.so where you sign in or create an account. Your credentials are stored locally and refresh automatically.

Cline-specific options

Auto-approve tools

Skip the per-tool approval prompt for trusted Oka tools:

{
  "mcpServers": {
    "oka": {
      "command": "npx",
      "args": ["-y", "@oka-core/reason"],
      "alwaysAllow": [
        "context",
        "learnings",
        "decisions",
        "patterns",
        "semantic_search"
      ]
    }
  }
}

This auto-approves only read tools. Write tools (observe, decision, done, etc.) will still prompt for confirmation — a reasonable default while getting started.

Disable without removing

{
  "mcpServers": {
    "oka": {
      "command": "npx",
      "args": ["-y", "@oka-core/reason"],
      "disabled": true
    }
  }
}

Tips

Cline has no tool limit (unlike Windsurf’s 100-tool cap). All 19 Oka tools are always available.
Set OKA_WORKSPACE in the env block to scope events to your project.
Cline tends to call MCP tools proactively when they match the task — you may not need explicit prompting as with some other clients.