Add MCP configuration generator documentation

Author: butschster

docs/getting-started/command-reference.md

@@ -83,6 +83,106 @@ ctx init -c context.json
 
 > **Note**: Only `json` and `yaml` formats are supported for the configuration file.
 
+## Generate MCP Configuration
+
+Generates MCP configuration snippets for connecting CTX to Claude Desktop or other MCP clients. This command
+automatically detects your operating system and generates the appropriate configuration format.
+
+```bash
+ctx mcp:config
+```
+
+### Options
+
+| Option                | Description                                        |
+|-----------------------|----------------------------------------------------|
+| `--explain`           | Show detailed setup instructions                   |
+| `--interactive`, `-i` | Interactive mode with guided questions             |
+| `--client`, `-c`      | MCP client type (claude, generic). Default: claude |
+| `--global`, `-g`      | Use global project registry (no -c option)         |
+
+### Examples
+
+**Auto-detect and generate global registry configuration:**
+
+```bash
+ctx mcp:config
+```
+
+**Interactive mode with guided questions:**
+
+```bash
+ctx mcp:config --interactive
+# or
+ctx mcp:config -i
+```
+
+**Global registry mode (default):**
+
+```bash
+ctx mcp:config --global
+# or
+ctx mcp:config -g
+```
+
+**Generate for different MCP clients:**
+
+```bash
+ctx mcp:config --client=generic
+# or
+ctx mcp:config -c generic
+```
+
+### Sample Output
+
+**Global Registry Mode:**
+
+```json
+{
+  "mcpServers": {
+    "ctx": {
+      "command": "ctx",
+      "args": [
+        "server"
+      ]
+    }
+  }
+}
+```
+
+**Project-Specific Mode:**
+
+```json
+{
+  "mcpServers": {
+    "ctx": {
+      "command": "ctx",
+      "args": [
+        "server",
+        "-c",
+        "/path/to/project"
+      ]
+    }
+  }
+}
+```
+
+**WSL Configuration:**
+
+```json
+{
+  "mcpServers": {
+    "ctx": {
+      "command": "bash.exe",
+      "args": [
+        "-c",
+        "ctx server -c /path/to/project"
+      ]
+    }
+  }
+}
+```
+
 ## MCP Server
 
 Starts the Model Control Protocol (MCP) server to enable direct integration with Claude AI. This server acts as a bridge

docs/mcp/index.md

@@ -109,17 +109,48 @@ First, you need to [install](https://claude.ai/download) Claude app and latest v
 
 > **Note**: The MCP server is only available in the desktop version of Claude. The web version does not support it.
 
-### Steps
+### Quick Setup
+
+The easiest way to set up MCP integration is using the built-in configuration generator:
+
+```bash
+ctx mcp:config
+```
+
+> **Note**: All the command options can be found in
+> the [CLI Reference](../getting-started/command-reference.md#generate-mcp-configuration).
+
+This command will:
+
+- 🔍 Auto-detect your operating system (Windows, Linux, macOS, WSL)
+- 🎯 Generate the correct configuration for your environment
+- 📋 Provide copy-paste ready JSON for Claude Desktop
+- 🧭 Include setup instructions and troubleshooting tips
+
+### Manual Configuration Steps
 
 1. Download Claude App for your operating system
 2. Open **Settings** → **Developer** → **Edit config** → open config file `claude_desktop_config`
-3. Register the **CTX** MCP server using the appropriate configuration
+3. Add the generated configuration to your Claude Desktop config file
+4. Save and restart Claude Desktop
 
---- 
-
-**Important: You must specify the path to your project using the `-c` flag. The project root should contain a
+> **Important: You must specify the path to your project using the `-c` flag. The project root should contain a
 `context.json` or `context.yaml` configuration file.**
 
+### Configuration Modes
+
+**Global Registry Mode (recommended for multiple projects):**
+
+- Uses `ctx server` without project path
+- Enables dynamic switching between registered projects
+- Requires projects to be registered with `ctx project:add`
+
+**Project-Specific Mode (single project):**
+
+- Uses `ctx server -c /path/to/project`
+- Ties configuration to a specific project path
+- Good for focused single-project workflows
+
 ### Platform-Specific Configurations
 
 #### Linux Configuration