ডকুমেন্টেশন

রিমোট সেটআপ

SSH টানেল ব্যবহার করে রিমোট সার্ভার, কনটেইনার ও হেডলেস পরিবেশে lean-ctx চালান।

lean-ctx একটি stdio MCP server হিসেবে চলে - আপনার AI ক্লায়েন্ট এটিকে লোকাল সাবপ্রসেস হিসেবে চালু করে। রিমোট সার্ভার, কনটেইনার বা হেডলেস পরিবেশের জন্য আপনি সংযোগটি SSH এর উপর টানেল করতে পারেন। অতিরিক্ত কোনো সার্ভার কম্পোনেন্ট দরকার নেই।

SSH টানেল (প্রস্তাবিত)

সবচেয়ে সহজ উপায়: আপনার AI ক্লায়েন্টকে SSH দিয়ে lean-ctx চালাতে কনফিগার করুন। MCP প্রোটোকল SSH-এর stdin/stdout দিয়ে যায় - কোনো পোর্ট খুলতে হয় না, HTTP লাগে না, আলাদা করে অথেনটিকেশন ম্যানেজ করতে হয় না। SSH নিজেই এনক্রিপশন ও অথেনটিকেশন হ্যান্ডেল করে।

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. সংযোগ পরীক্ষা করুন

SSH এর মাধ্যমে lean-ctx কাজ করছে কিনা যাচাই করুন। আপনি MCP সার্ভার সরাসরি চালাতে পারেন বা ড্যাশবোর্ড টানেল করতে পারেন:

# 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 কনফিগে SSH দিয়ে lean-ctx চালানোর সেটিং দিন। এটি Cursor, Claude Code, Windsurf এবং যেকোনো MCP-সামঞ্জস্যপূর্ণ ক্লায়েন্টে কাজ করবে:

// ~/.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 রিমোটে চলছে অথচ আপনি লোকাল ব্রাউজার থেকে lean-ctx dashboard (Observatory) দেখতে চান, SSH পোর্ট ফরওয়ার্ডিং ব্যবহার করুন:

পার্সিস্টেন্ট SSH কনফিগ

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

তারপর কানেক্ট করে ড্যাশবোর্ড চালু করুন:

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

VS Code Remote SSH

VS Code এর Remote - SSH এক্সটেনশন ব্যবহার করলে lean-ctx স্বয়ংক্রিয়ভাবে কাজ করে - MCP সার্ভার রিমোট মেশিনে সাধারণ টার্মিনাল কমান্ডের মতো চলে। রিমোটে lean-ctx ইনস্টল করুন, lean-ctx setup চালান, এবং এটি রিমোট এনভায়রনমেন্টের জন্য নিজে কনফিগার হবে।

Docker / কনটেইনার

কনটেইনারাইজড ডেভেলপমেন্টের জন্য lean-ctx বাইনারি এবং এর ডেটা ডিরেক্টরি কনটেইনারে মাউন্ট করুন:

# 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 এর জন্য সার্ভিসে ভলিউম যোগ করুন:

# 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

সমস্যা সমাধান

আইডল থাকার পর কানেকশন ড্রপ হয়

দীর্ঘ সময় আইডল থাকলে SSH কানেকশন টাইমআউট হতে পারে। keepalive সেটিং যোগ করুন:

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

রিমোটে Permission denied

রিমোট ইউজারের PATH এ lean-ctx আছে কিনা নিশ্চিত করুন। cargo install দিয়ে ইনস্টল হলে এটি ~/.cargo/bin/lean-ctx এ থাকে। রিমোট ~/.bashrc বা ~/.zshrc এ export PATH=\"$HOME/.cargo/bin:$PATH\" যোগ করুন।

লোকাল ও রিমোটের মধ্যে ভার্সন মিসম্যাচ

প্রোটোকল সমস্যা এড়াতে লোকাল AI ক্লায়েন্ট ও রিমোট lean-ctx একই ভার্সনে থাকা উচিত। দুটোই আপডেট রাখুন:

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

রিমোটে ডায়াগনস্টিক চালান

রিমোট সার্ভারে lean-ctx doctor চালিয়ে ইনস্টলেশন, শেল হুক এবং MCP কনফিগারেশন যাচাই করুন:

ssh user@server "lean-ctx doctor"