Skip to main content

Cline

Connect Surchin to Cline (VS Code extension) so your AI agent accumulates and retrieves institutional knowledge across sessions.

Setup

1. Authenticate

npx @surchin/surchin init

Follow the prompts to log in. Your credentials are saved to ~/.config/surchin/config.json.

2. Add MCP Configuration

Open VS Code settings (JSON) and add the Surchin MCP server:

{
  "cline.mcpServers": {
    "surchin": {
      "command": "npx",
      "args": ["-y", "@surchin/surchin@latest"]
    }
  }
}

Alternatively, you can configure this through the Cline extension's MCP settings panel.

3. Reload VS Code

Reload the VS Code window (Ctrl+Shift+P / Cmd+Shift+P > "Developer: Reload Window").

4. Verify

Open Cline and ask:

"Use the query_insights tool to search for insights about this codebase."

Cline should call the query_insights tool and return results.

Troubleshooting

Tool not appearing

  • Ensure Node.js 18+ is installed: node --version
  • Check that Cline extension is up to date
  • Verify the settings JSON is valid

"Unauthorized" errors

  • Re-authenticate: npx @surchin/surchin init

Server issues

  • Try running manually: npx @surchin/surchin
  • Check VS Code's Output panel (select "Cline" from the dropdown) for error logs