Update install-other-copilot-ides.md

Author: D1M1TR10S

docs/installation-guides/install-other-copilot-ides.md

@@ -1,153 +1,282 @@
 # Installing GitHub MCP Server in GitHub Copilot IDEs
 
-This guide covers installation for GitHub Copilot in Visual Studio, JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm, etc.), Eclipse, and other supported development environments.
+Quick setup guide for the GitHub Model Context Protocol (MCP) server across different IDEs with GitHub Copilot. For GitHub Copilot in VS Code, view the install instructions in the [README.md](/README.md)
 
-## Prerequisites
+## Important Prerequisites
 
-- **GitHub Copilot subscription** (Individual, Business, or Enterprise)
-- **MCP support enabled** in your IDE (check your IDE's latest version)
-- **GitHub Personal Access Token** (if not using OAuth)
+- **Organization Policy**: To use GitHub Copilot with the Remote MCP Server, your organization must enable the Editor Preview Policy while MCP support remains in public preview
+- **Authentication Methods**: 
+  - VS Code supports both OAuth and PAT for remote servers
+  - All other IDEs (Visual Studio, JetBrains, Xcode, Eclipse) currently support PAT-only for remote servers
+  - All IDEs support local server installation with PAT authentication
 
-## Remote GitHub MCP Server (Recommended)
+---
 
-The remote server is hosted by GitHub and provides the easiest setup experience with automatic updates.
+## Important Notes on GitHub MCP Server
 
-### Step 1: Check IDE Compatibility
+- **Official Migration**: The GitHub MCP server has migrated to GitHub's official repository at [github/github-mcp-server](https://github.com/github/github-mcp-server)
+- **Docker Image**: The official Docker image is now `ghcr.io/github/github-mcp-server`
+- **npm Package**: The npm package `@modelcontextprotocol/server-github` is still maintained but includes a deprecation notice
+- **Remote Server**: The remote server URL remains `https://api.githubcopilot.com/mcp/`
 
-Ensure your IDE supports remote MCP servers:
-- **Visual Studio**: Version 17.14 or later
-- **JetBrains IDEs**: Latest versions with Copilot plugin
-- **Eclipse**: Latest version with GitHub Copilot extension
+---
 
-### Step 2: Configure Remote Server
+## Visual Studio Setup
 
-Add the GitHub MCP Server to your IDE's MCP configuration. The exact location varies by IDE:
+Requires Visual Studio 2022 version 17.14 or later. Visual Studio supports both remote and local GitHub MCP server configurations.
 
-**OAuth flow for IDEs that support OAuth (recommended):**
+### Remote Server Configuration (PAT Only)
+Visual Studio currently supports PAT authentication only for remote MCP servers.
+
+1. Create an `.mcp.json` file in your solution directory
+2. Add this configuration:
 ```json
 {
-  "mcpServers": {
+  "servers": {
     "github": {
-      "url": "https://api.githubcopilot.com/mcp/"
+      "type": "http",
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": {
+        "Authorization": "Bearer YOUR_GITHUB_PAT"
+      }
     }
   }
 }
 ```
+3. Save the file and restart Visual Studio
+4. Open Agent Mode in Copilot Chat to access MCP tools
+
+### Local Server Configuration
+Requires Docker installed and running.
 
-**Using a Personal Access Token:**
 ```json
 {
-  "mcpServers": {
+  "inputs": [
+    {
+      "id": "github_pat",
+      "description": "GitHub personal access token",
+      "type": "promptString",
+      "password": true
+    }
+  ],
+  "servers": {
     "github": {
-      "url": "https://api.githubcopilot.com/mcp/",
-      "authorization_token": "Bearer <your GitHub PAT>"
+      "type": "stdio",
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
+        "ghcr.io/github/github-mcp-server"
+      ],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_pat}"
+      }
     }
   }
 }
 ```
 
-### Step 3: IDE-Specific Configuration
+**Documentation:** [Visual Studio MCP Guide](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022)
+
+---
+
+## JetBrains IDEs Setup
+
+Agent mode and MCP support available in public preview across IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs.
+
+### Remote Server Configuration (PAT Only)
+1. Install/update the GitHub Copilot plugin
+2. Click **GitHub Copilot icon** → **Edit Settings** → **MCP Servers** → **Edit in mcp.json**
+3. Add configuration:
+```json
+{
+  "servers": {
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "requestInit": {
+        "headers": {
+          "Authorization": "Bearer YOUR_GITHUB_PAT"
+        }
+      }
+    }
+  }
+}
+```
+4. Restart IDE and use Agent mode in Copilot Chat
 
-#### Visual Studio
-1. Open **Tools** → **Options** → **GitHub Copilot** → **MCP Servers**
-2. Click **Add Server** and paste the JSON configuration
-3. Restart Visual Studio
+### Local Server Configuration
 
-#### JetBrains IDEs (IntelliJ, PyCharm, WebStorm, etc.)
-1. Go to **Settings** → **Tools** → **GitHub Copilot** → **MCP Integration**
-2. Add the server configuration
-3. Apply changes and restart the IDE
+#### Option 1: Using Docker (Recommended)
+Requires Docker installed and running.
+```json
+{
+  "servers": {
+    "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"
+      }
+    }
+  }
+}
+```
 
-#### Eclipse
-1. Navigate to **Window** → **Preferences** → **GitHub Copilot** → **Model Context Protocol**
-2. Add the remote server configuration
-3. Restart Eclipse
+#### Option 2: Using npx
+Note: The npm package `@modelcontextprotocol/server-github` has moved to GitHub's official repository but is still functional.
+```json
+{
+  "servers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
+      }
+    }
+  }
+}
+```
 
-> **Note:** Configuration paths may vary depending on your IDE version. Consult your IDE's documentation for the exact MCP configuration location.
+**Documentation:** [Copilot Plugin for JetBrains IDEs](https://plugins.jetbrains.com/plugin/17718-github-copilot)
 
-## Local GitHub MCP Server (Alternative)
+---
 
-If your IDE doesn't support remote MCP servers or you prefer local installation, use the Docker-based local server.
+## Xcode Setup
 
-### Prerequisites
-- **Docker** installed and running
-- **GitHub Personal Access Token** with appropriate permissions
+Agent mode and MCP support now available in public preview for Xcode.
 
-### Configuration
+### Remote Server Configuration (PAT Only)
+1. Install/update [GitHub Copilot for Xcode](https://github.com/github/CopilotForXcode)
+2. Open **GitHub Copilot for Xcode app** → **Agent Mode** → **🛠️ Tool Picker** → **Edit Config**
+3. Configure your MCP servers:
+```json
+{
+  "servers": {
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "requestInit": {
+        "headers": {
+          "Authorization": "Bearer YOUR_GITHUB_PAT"
+        }
+      }
+    }
+  }
+}
+```
 
-Add this configuration to your IDE's MCP settings:
+### Local Server Configuration
 
+#### Option 1: Using Docker (Recommended)
+Requires Docker installed and running.
 ```json
 {
-  "mcpServers": {
+  "servers": {
     "github": {
       "command": "docker",
       "args": [
-        "run",
-        "-i",
-        "--rm",
-        "-e",
-        "GITHUB_PERSONAL_ACCESS_TOKEN",
+        "run", "-i", "--rm", 
+        "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
         "ghcr.io/github/github-mcp-server"
       ],
       "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "<your GitHub PAT>"
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
+      }
+    }
+  }
+}
+```
+
+#### Option 2: Using npx
+Note: The npm package `@modelcontextprotocol/server-github` has moved to GitHub's official repository but is still functional.
+```json
+{
+  "servers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
       }
     }
   }
 }
 ```
 
-## Creating a GitHub Personal Access Token
+**Documentation:** [Xcode Copilot Guide](https://devblogs.microsoft.com/xcode/github-copilot-exploring-agent-mode-and-mcp-support-in-public-preview-for-xcode/)
 
-If using PAT authentication:
+---
 
-1. Go to [GitHub Settings → Personal Access Tokens](https://github.com/settings/personal-access-tokens/new)
-2. Click **Generate new token (classic)**
-3. Select appropriate scopes based on your needs:
-   - `repo` - for repository access
-   - `read:org` - for organization information
-   - `workflow` - for GitHub Actions access
-4. Copy the generated token and use it in your configuration
+## Eclipse Setup
 
-## Verification
+MCP support available with Eclipse 2024-09+ and latest GitHub Copilot extension.
 
-After configuration:
+### Remote Server Configuration (PAT Only)
+1. Install GitHub Copilot extension from Eclipse Marketplace
+2. Click **GitHub Copilot icon** → **Edit Preferences** → **MCP Servers**
+3. Add GitHub MCP server configuration:
+```json
+{
+  "servers": {
+    "github": {
+      "url": "https://api.githubcopilot.com/mcp/",
+      "requestInit": {
+        "headers": {
+          "Authorization": "Bearer YOUR_GITHUB_PAT"
+        }
+      }
+    }
+  }
+}
+```
+4. Restart Eclipse
 
-1. Restart your IDE completely
-2. Open a project with GitHub repositories
-3. Try asking Copilot: "List the recent issues in this repository"
-4. Copilot should now be able to access GitHub data and perform repository operations
+### Local Server Configuration
+Eclipse supports local MCP server installation using Docker or npx, following the same configuration patterns as shown in the JetBrains section above.
 
-## Troubleshooting
+**Documentation:** [Eclipse Copilot Extension](https://marketplace.eclipse.org/content/github-copilot)
+
+---
+
+## GitHub Personal Access Token
 
-### Common Issues
+For PAT authentication, create a token with appropriate scopes:
+- `repo` - For repository access
+- `read:packages` - Required for local Docker-based installation
+- Additional scopes based on the tools you plan to use
 
-**MCP server not connecting:**
-- Verify your IDE supports MCP integration
-- Check that Docker is running (for local server)
-- Ensure your GitHub PAT has the required permissions
+See our [Personal Access Token documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) for setup instructions.
 
-**Authentication errors:**
-- Verify your GitHub PAT is valid and has appropriate scopes
-- For OAuth, ensure you've completed the authentication flow
+---
 
-**Tools not appearing:**
-- Restart your IDE after configuration changes
-- Check IDE logs for MCP-related error messages
+## Usage
+
+After setup:
+1. Restart your IDE completely
+2. Open Agent mode in Copilot Chat
+3. Click the tools icon to see available MCP tools
+4. Try: *"List recent issues in this repository"*
+5. Copilot can now access GitHub data and perform repository operations
+
+---
+
+## Troubleshooting
 
-### Getting Help
+- **Connection issues**: Verify GitHub PAT permissions and IDE version compatibility
+- **Authentication errors**: 
+  - Check if your organization has enabled the Editor Preview Policy
+  - Ensure PAT has correct scopes
+  - For Enterprise Managed Users with PAT restrictions, OAuth is not available
+- **Tools not appearing**: Restart IDE after configuration changes and check error logs
+- **Local server issues**: Ensure Docker is running (for Docker-based setups) or Node.js is installed (for npx-based setups)
 
-- Check your IDE's documentation for MCP configuration specifics
-- Review GitHub MCP Server logs for detailed error information
-- Ensure you're using compatible versions of your IDE and Copilot plugin
+---
 
-## Next Steps
+## What's Next
 
-Once installed, explore the available toolsets:
-- **Repository Management**: Browse code, analyze commits
-- **Issue & PR Operations**: Create and manage issues/pull requests  
-- **CI/CD Integration**: Monitor GitHub Actions workflows
-- **Code Security**: Review security findings and alerts
+All IDEs now support the GitHub MCP server, with both remote and local installation options. While VS Code offers support for OAuth authentication, OAuth support is coming to all Copilot IDEs in the coming months.
 
-For advanced configuration options like toolsets and read-only mode, see the main [README documentation](../README.md).
+**Advanced configuration:** See the [GitHub MCP Server repository](https://github.com/github/github-mcp-server) for toolsets, read-only mode, and additional options.