Update install-claude.md

Author: D1M1TR10S

docs/installation-guides/install-claude.md

@@ -10,48 +10,57 @@ Claude Code CLI provides command-line access to Claude with MCP server integrati
 
 1. Claude Code CLI installed
 2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
+3. Node.js/npm or Docker (depending on installation method)
 
-### Installation
+### Installation Methods
 
-Run the following command in the Claude Code CLI, referencing your GitHub PAT:
+#### Method 1: Using Docker (Recommended)
+```bash
+claude mcp add-json github '{"command": "docker", "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"}}'
+```
 
+#### Method 2: Using NPX (Legacy)
+Note: The npm package has moved to GitHub's official repository but remains functional.
 ```bash
-claude mcp add-json github '{"command": "github-mcp-server", "args": ["stdio"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"}}'
+claude mcp add-json github '{"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"}}'
 ```
 
-### Configuration Steps
+### Configuration Options
 
-1. Replace `your_github_pat` with your actual GitHub Personal Access Token
-2. Ensure you have the necessary permissions on your GitHub PAT for the operations you want to perform
-3. The command will add the GitHub MCP Server to your Claude Code configuration
+- Use `-s user` to add the server to your user configuration (available across all projects)
+- Use `-s project` to add the server to project-specific configuration (shared via `.mcp.json`)
+- Default scope is `local` (available only to you in the current project)
 
-### Troubleshooting Claude Code
+### Verification
 
-- Verify the Claude Code CLI is properly installed and accessible
-- Check that your GitHub PAT is valid and has the required permissions
-- Ensure the command syntax is correct (note the single quotes around the JSON)
-- Review Claude Code documentation for any specific MCP server requirements
+Run the following command to verify the installation:
+```bash
+claude mcp list
+```
 
 ---
 
 ## Claude Desktop
 
-Claude Desktop provides a user-friendly interface for interacting with the GitHub MCP Server.
+Claude Desktop provides a graphical interface for interacting with the GitHub MCP Server.
 
 ### Prerequisites
 
 1. Claude Desktop installed
 2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
-3. [Docker](https://www.docker.com/) installed and running
+3. Node.js/npm or Docker (depending on installation method)
 
-### Installation Steps
+### Configuration File Location
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/Claude/claude_desktop_config.json` (unofficial support)
 
-1. Follow the Claude Desktop [MCP install guide](https://modelcontextprotocol.io/quickstart/user)
-2. Add the following configuration to your Claude Desktop configuration file
+### Installation Methods
 
-### Configuration
+#### Method 1: Using Docker (Recommended)
 
-Add the following JSON to your Claude Desktop configuration file, replacing `your_github_pat` with your actual GitHub Personal Access Token:
+Add the following to your `claude_desktop_config.json`:
 
 ```json
 {
@@ -74,9 +83,27 @@ Add the following JSON to your Claude Desktop configuration file, replacing `you
 }
 ```
 
+#### Method 2: Using NPX (Legacy)
+
+Note: The npm package has moved to GitHub's official repository but remains functional.
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"
+      }
+    }
+  }
+}
+```
+
 ### Using Environment Variables
 
-You can also use environment variables for better security. Replace `your_github_pat` with a variable reference like `$GITHUB_PAT`:
+Claude Desktop supports environment variable references. You can use:
 
 ```json
 {
@@ -99,77 +126,59 @@ You can also use environment variables for better security. Replace `your_github
 }
 ```
 
-### Configuration File Location
-
-The Claude Desktop configuration file is typically located at:
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
-- **Linux**: `~/.config/claude/claude_desktop_config.json`
-
-### Troubleshooting Claude Desktop
+Then set the environment variable in your system before starting Claude Desktop.
 
-- Verify Docker is running and accessible
-- Check that your GitHub PAT is valid and has the required permissions
-- Ensure the configuration file is valid JSON
-- Restart Claude Desktop after making configuration changes
-- Check Claude Desktop logs for any error messages
+### Installation Steps
 
-### Prerequisites
+1. Open Claude Desktop
+2. Go to Settings (from the Claude menu) → Developer → Edit Config
+3. Add your chosen configuration
+4. Save the file
+5. Restart Claude Desktop
 
-1. Claude Code CLI installed
-2. [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens/new)
+### Verification
 
-### Installation
+After restarting, you should see:
+- An MCP icon in the Claude Desktop interface
+- The GitHub server listed as "running" in Developer settings
 
-Run the following command in the Claude Code CLI, referencing your GitHub PAT:
-
-```bash
-claude mcp add-json github '{"command": "github-mcp-server", "args": ["stdio"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat"}}'
-```
+---
 
-### Configuration Steps
+## Troubleshooting
 
-1. Replace `your_github_pat` with your actual GitHub Personal Access Token
-2. Ensure you have the necessary permissions on your GitHub PAT for the operations you want to perform
-3. The command will add the GitHub MCP Server to your Claude Code configuration
+### Claude Code CLI
+- Verify the command syntax is correct (note the single quotes around the JSON)
+- Check that Node.js/npm is installed: `node --version`
+- For Docker method, ensure Docker is running
+- Use `/mcp` command within Claude Code to check server status
 
-### Troubleshooting Claude Code
+### Claude Desktop
+- Check logs at:
+  - **macOS**: `~/Library/Logs/Claude/`
+  - **Windows**: `%APPDATA%\Claude\logs\`
+- Look for `mcp-server-github.log` for server-specific errors
+- Ensure configuration file is valid JSON
+- Try running the command manually in terminal to diagnose issues
 
-- Verify the Claude Code CLI is properly installed and accessible
-- Check that your GitHub PAT is valid and has the required permissions
-- Ensure the command syntax is correct (note the single quotes around the JSON)
-- Review Claude Code documentation for any specific MCP server requirements
+### Common Issues
+- **Invalid JSON**: Validate your configuration at [jsonlint.com](https://jsonlint.com)
+- **PAT issues**: Ensure your GitHub PAT has required scopes
+- **Docker not found**: Install Docker Desktop and ensure it's running
+- **NPX not found**: Install Node.js from [nodejs.org](https://nodejs.org)
 
 ---
 
 ## Security Best Practices
 
-Regardless of which Claude application you're using, follow these security guidelines:
-
-- **Keep your GitHub PAT secure** and never commit it to version control
-- **Limit the scope** of your GitHub PAT to only the permissions you need
-- **Consider using environment variables** for token storage when supported by your setup
+- **Protect configuration files**: Set appropriate file permissions
+- **Use environment variables** when possible instead of hardcoding tokens
+- **Limit PAT scope** to only necessary permissions
 - **Regularly rotate** your GitHub Personal Access Tokens
-- **Ensure Docker environment is secure** (for Claude Desktop installations)
+- **Never commit** configuration files containing tokens to version control
 
-## Installation Methods
-
-The GitHub MCP Server supports multiple installation approaches:
-
-### Docker (Recommended for Claude Desktop)
-- **Pros**: No local build required, consistent environment, easy updates
-- **Cons**: Requires Docker installed and running
-- **Used by**: Claude Desktop configuration above
-
-### Direct Binary (Used by Claude Code)
-- **Pros**: No Docker required, direct execution via stdio
-- **Cons**: Requires the `github-mcp-server` binary to be available in PATH
-- **Used by**: Claude Code CLI configuration above
+---
 
-### Build from Source (Alternative)
-- **Pros**: Latest features, customizable, no Docker dependency
-- **Cons**: Requires Go development environment
-- **Prerequisites**: [Go 1.24+](https://go.dev/doc/install)
-- **Build command**: `go build -o github-mcp-server cmd/github-mcp-server/main.go`
+## Additional Resources
 
-Choose the method that best fits your environment and requirements.
+- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
+- [Claude Code MCP Documentation](https://docs.anthropic.com/en/docs/claude-code/mcp)