Update Claude Code installation command to use add-json format for v2.1.1+

Co-authored-by: SamMorrowDrums <[email protected]>

Author: Copilot

docs/installation-guides/install-claude.md

@@ -28,15 +28,23 @@ echo -e ".env\n.mcp.json" >> .gitignore
 
 ### Remote Server Setup (Streamable HTTP)
 
+> **Note**: For Claude Code versions **2.1.1 and newer**, use the `add-json` command format below. For older versions, see the [legacy command format](#for-older-versions-of-claude-code).
+
 1. Run the following command in the terminal (not in Claude Code CLI):
 ```bash
-claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"
+claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}' --scope user
 ```
 
 With an environment variable:
 ```bash
-claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer $(grep GITHUB_PAT .env | cut -d '=' -f2)"
+claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer '"$(grep GITHUB_PAT .env | cut -d '=' -f2)"'"}}' --scope user
 ```
+
+> **About the `--scope` flag**: This specifies where the configuration is stored. Options:
+> - `local` (default): Available only to you in the current project (was called `project` in older versions)
+> - `project`: Shared with everyone in the project via `.mcp.json` file
+> - `user`: Available to you across all projects (was called `global` in older versions)
+
 2. Restart Claude Code
 3. Run `claude mcp list` to see if the GitHub server is configured
 
@@ -72,6 +80,19 @@ claude mcp list
 claude mcp get github
 ```
 
+### For Older Versions of Claude Code
+
+If you're using Claude Code version **2.1.0 or earlier**, use this legacy command format:
+
+```bash
+claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"
+```
+
+With an environment variable:
+```bash
+claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer $(grep GITHUB_PAT .env | cut -d '=' -f2)"
+```
+
 ---
 
 ## Claude Desktop
@@ -161,7 +182,4 @@ Add this codeblock to your `claude_desktop_config.json`:
 
 - The npm package `@modelcontextprotocol/server-github` is deprecated as of April 2025
 - Remote server requires Streamable HTTP support (check your Claude version)
-- Configuration scopes for Claude Code:
-  - `-s user`: Available across all projects
-  - `-s project`: Shared via `.mcp.json` file
-  - Default: `local` (current project only)
+- For Claude Code configuration scopes, see the `--scope` flag documentation in the [Remote Server Setup](#remote-server-setup-streamable-http) section