रिमोट सेटअप

lean-ctx एक stdio MCP server के रूप में चलता है - आपका AI क्लाइंट इसे लोकल subprocess की तरह स्पॉन करता है। रिमोट सर्वर, कंटेनर या headless वातावरण के लिए आप कनेक्शन को SSH पर टनल कर सकते हैं। किसी अतिरिक्त server component की ज़रूरत नहीं है।

SSH टनल (सिफ़ारिश की गई)

सबसे सरल तरीका: अपने AI क्लाइंट को SSH के जरिए lean-ctx चलाने के लिए कॉन्फ़िगर करें। MCP प्रोटोकॉल SSH के stdin/stdout पर चलता है - कोई पोर्ट खोलने की ज़रूरत नहीं, कोई HTTP नहीं, और अतिरिक्त authentication मैनेज नहीं करना पड़ता। SSH native रूप से encryption और authentication संभालता है।

1. रिमोट सर्वर पर lean-ctx इंस्टॉल करें

SSH करके सर्वर पर जाएँ और lean-ctx इंस्टॉल करें:

ssh user@server
cargo install lean-ctx
# or download pre-built binary:
curl -fsSL https://leanctx.com/install.sh | sh

2. कनेक्शन टेस्ट करें

पुष्टि करें कि lean-ctx SSH पर काम करता है। आप MCP server को सीधे चला सकते हैं या dashboard को टनल कर सकते हैं:

# Terminal 1: SSH tunnel (keeps running)
ssh -L 3333:localhost:3333 user@server "lean-ctx dashboard --port 3333"

# Or just forward the MCP stdio over SSH:
ssh user@server "lean-ctx"

3. अपना AI क्लाइंट कॉन्फ़िगर करें

अपने AI क्लाइंट की MCP config को SSH के जरिए lean-ctx चलाने के लिए सेट करें। यह Cursor, Claude Code, Windsurf और किसी भी MCP-compatible क्लाइंट के साथ काम करता है:

// ~/.cursor/mcp.json or ~/.claude.json
{
  "mcpServers": {
    "lean-ctx": {
      "command": "ssh",
      "args": ["user@server", "lean-ctx"]
    }
  }
}

यह क्लाइंट को लोकल lean-ctx की बजाय ssh user@server "lean-ctx" स्पॉन करने के लिए कहता है। MCP प्रोटोकॉल SSH कनेक्शन पर पारदर्शी रूप से चलता है - stdin/stdout अपने आप टनल हो जाता है।

पोर्ट फ़ॉरवर्डिंग (Dashboard)

यदि आप लोकल ब्राउज़र से lean-ctx dashboard (Observatory) खोलना चाहते हैं जबकि lean-ctx रिमोट पर चल रहा हो, तो SSH port forwarding का उपयोग करें:

Persistent SSH config

# ~/.ssh/config
Host dev-server
  HostName 192.168.1.100
  User developer
  LocalForward 3333 localhost:3333
  ServerAliveInterval 60
  ServerAliveCountMax 3

फिर कनेक्ट करें और dashboard शुरू करें:

ssh dev-server "lean-ctx dashboard --port 3333"
# Dashboard now available at http://localhost:3333

VS Code Remote SSH

यदि आप VS Code के Remote - SSH extension का उपयोग करते हैं, तो lean-ctx अपने आप काम करता है - MCP server रिमोट मशीन पर किसी भी टर्मिनल कमांड की तरह चलता है। रिमोट पर lean-ctx इंस्टॉल करें, lean-ctx setup चलाएँ, और यह रिमोट वातावरण के लिए खुद को कॉन्फ़िगर कर देगा।

Docker / कंटेनर

कंटेनर-आधारित development के लिए lean-ctx binary और उसका data directory कंटेनर में माउंट करें:

# Mount lean-ctx binary into your dev container
docker run -it \
  -v $(which lean-ctx):/usr/local/bin/lean-ctx:ro \
  -v ~/.lean-ctx:/root/.lean-ctx \
  your-dev-image bash

Docker Compose के लिए, अपने service में volumes जोड़ें:

# docker-compose.yml
services:
  dev:
    image: your-dev-image
    volumes:
      - ./:/workspace
      - lean-ctx-bin:/usr/local/bin/lean-ctx:ro
      - ~/.lean-ctx:/root/.lean-ctx

ट्रबलशूटिंग

Idle समय के बाद कनेक्शन गिर जाता है

लंबे idle period के दौरान SSH connections timeout हो सकते हैं। keepalive settings जोड़ें:

ssh -o ServerAliveInterval=60 -o ServerAliveCountMax=3 user@server "lean-ctx"

रिमोट पर Permission denied

सुनिश्चित करें कि lean-ctx रिमोट user के PATH में है। यदि cargo install से इंस्टॉल किया है, तो यह ~/.cargo/bin/lean-ctx पर होता है। रिमोट ~/.bashrc या ~/.zshrc में export PATH=\"$HOME/.cargo/bin:$PATH\" जोड़ें।

लोकल और रिमोट के बीच version mismatch

प्रोटोकॉल समस्याओं से बचने के लिए लोकल AI क्लाइंट और रिमोट lean-ctx एक ही version पर चलें। दोनों को अपडेट रखें:

# Check versions on both machines
lean-ctx --version              # local
ssh user@server "lean-ctx --version"  # remote

रिमोट पर diagnostics चलाएँ

रिमोट सर्वर पर lean-ctx doctor चलाकर installation, shell hooks और MCP configuration सत्यापित करें:

ssh user@server "lean-ctx doctor"