Update install-cursor.md

Author: D1M1TR10S

docs/installation-guides/install-cursor.md

@@ -1,16 +1,35 @@
 # Install GitHub MCP Server in Cursor
 
 ## Prerequisites
+1. Cursor IDE installed (latest version)
+2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new) with appropriate scopes
+3. For local installation: [Docker](https://www.docker.com/) installed and running
 
-1. Cursor IDE installed
-2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
-3. [Docker](https://www.docker.com/) installed and running
+## Remote Server Setup (Recommended)
 
-## Installation Steps
+The remote GitHub MCP server is hosted by GitHub at `https://api.githubcopilot.com/mcp/` and supports both HTTP and SSE protocols. Cursor currently supports remote servers with PAT authentication.
+
+### SSE Configuration
+As of Cursor v0.48.0, Cursor supports SSE servers directly:
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": {
+        "Authorization": "Bearer YOUR_GITHUB_PAT"
+      }
+    }
+  }
+}
+```
+
+**Note**: If your Cursor version doesn't support direct SSE, you may need to use a proxy tool like `mcp-remote`.
 
-1. Go to `Cursor Settings` → `Tools & Integrations` → Click `Add Custom MCP` or `New MCP Server`
-2. Use the following `mcp.json` structure:
+## Local Server Setup
 
+### Option 1: Docker (Recommended)
 ```json
 {
   "mcpServers": {
@@ -25,44 +44,114 @@
         "ghcr.io/github/github-mcp-server"
       ],
       "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
       }
     }
   }
 }
 ```
 
-3. Replace `your_github_pat` with your actual GitHub PAT
-4. Restart Cursor for changes to apply
+### Option 2: NPX
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
+      }
+    }
+  }
+}
+```
 
-## Important Security Notes
+**Note**: The npm package has a deprecation notice but remains functional.
 
-⚠️ **Environment Variable Limitations**: Environment-variable interpolation (using a `$GITHUB_PAT` variable) is not supported in Cursor.
+## Installation Steps
 
-### Security Best Practices
+### Via Cursor Settings UI
+1. Open Cursor
+2. Navigate to **Settings** → **Tools & Integrations** → **MCP**
+3. Click **"+ Add new global MCP server"**
+4. This opens `~/.cursor/mcp.json` in the editor
+5. Add your chosen configuration from above
+6. Save the file
+7. Restart Cursor
+
+### Manual Configuration
+1. Create or edit the configuration file:
+   - **Global (all projects)**: `~/.cursor/mcp.json`
+   - **Project-specific**: `.cursor/mcp.json` in project root
+2. Add your chosen configuration
+3. Save the file
+4. Restart Cursor completely
+
+## Security Best Practices
+
+### Configuration Note
+Cursor's current MCP implementation requires tokens to be specified directly in the configuration file. We recommend taking extra security precautions:
+
+### File Protection
+```bash
+# Secure the configuration file
+chmod 600 ~/.cursor/mcp.json
+
+# For project-specific config
+chmod 600 .cursor/mcp.json
+
+# Verify permissions
+ls -la ~/.cursor/mcp.json
+```
 
-- **File Permissions**: Lock down file permissions for the configuration file:
-  ```bash
-  chmod 600 ~/.codeium/windsurf/mcp.json
-  ```
-- **Version Control**: Avoid committing configuration files with tokens to version control
-- **Token Scope**: Limit PAT scopes to necessary repositories and tools only
-- **Token Rotation**: Regularly rotate your GitHub Personal Access Tokens
+### Token Security
+- Create PATs with minimum required scopes:
+  - `repo` - For repository operations
+  - `read:packages` - For Docker image pull (local setup)
+  - Additional scopes based on tools you need
+- Use separate PATs for different projects
+- Regularly rotate tokens
+- Never commit configuration files to version control
 
-## Configuration File Location
+## Configuration Details
 
-The MCP configuration is typically stored at:
-- `~/.codeium/windsurf/mcp.json`
+- **File paths**: 
+  - Global: `~/.cursor/mcp.json`
+  - Project: `.cursor/mcp.json`
+- **Scope**: Both global and project-specific configurations supported
+- **Format**: Must be valid JSON (use a linter to verify)
 
-## Troubleshooting
+## Verification
 
-- Ensure Docker is running and accessible
-- Verify your GitHub PAT is valid and has required permissions
-- Check that the JSON configuration is valid
-- Restart Cursor after making configuration changes
-- Review Cursor logs for any MCP server startup errors
-- Ensure the GitHub MCP Server Docker image is accessible (`ghcr.io/github/github-mcp-server`)
+After installation:
+1. Restart Cursor completely
+2. Open Settings → Tools & Integrations → MCP
+3. Look for green dot next to your server name
+4. In chat/composer, check "Available Tools"
+5. Test with: "List my GitHub repositories"
 
-## Alternative Setup
+## Troubleshooting
 
-If you prefer to manually edit the configuration file, you can directly edit the `mcp.json` file at the location mentioned above with the same JSON structure.
+### Remote Server Issues
+- **SSE not working**: Ensure you're using Cursor v0.48.0 or later
+- **Authentication failures**: Verify PAT has correct scopes
+- **Connection errors**: Check firewall/proxy settings
+
+### Local Server Issues
+- **Docker errors**: Ensure Docker Desktop is running
+- **Image pull failures**: Try `docker logout ghcr.io` then retry
+- **NPX failures**: Clear npm cache with `npm cache clean --force`
+
+### General Issues
+- **MCP not loading**: Restart Cursor completely after configuration
+- **Invalid JSON**: Validate with [jsonlint.com](https://jsonlint.com)
+- **Tools not appearing**: Check server shows green dot in MCP settings
+- **Check logs**: Look for MCP-related errors in Cursor logs
+
+## Important Notes
+
+- **Official repository**: [github/github-mcp-server](https://github.com/github/github-mcp-server)
+- **Remote server URL**: `https://api.githubcopilot.com/mcp/`
+- **Docker image**: `ghcr.io/github/github-mcp-server`
+- **npm package**: `@modelcontextprotocol/server-github` (deprecated but functional)
+- **Cursor specifics**: Supports both project and global configurations, uses `mcpServers` key