MCP support in GA for JetBrains, Eclipse, and XCode + OAuth remote GitHub server support (#57123)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Ben Ahmady <32935794+subatoi@users.noreply.github.com>

Author: 3 people

content/copilot/concepts/about-mcp.md

@@ -10,10 +10,7 @@ topics:
 contentType: concepts
 ---
 
->[!NOTE]
-> * MCP support is generally available (GA) in {% data variables.copilot.copilot_chat_short %} for {% data variables.product.prodname_vscode %}.
-> * MCP support for {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vs %}, JetBrains, Eclipse, and Xcode is in {% data variables.release-phases.public_preview %} and is subject to change.
-> * The [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) apply only to {% data variables.product.prodname_copilot_short %} in IDEs where MCP support is still in preview. GA terms apply when using MCP for {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vscode %}.
+{% data reusables.copilot.mcp-availability-and-preview-note %}
 
 ## Overview of Model Context Protocol (MCP)
 

content/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies.md

@@ -40,8 +40,7 @@ contentType: how-tos
    * Click **Models** to edit the policies that control availability of models beyond the basic models provided with {% data variables.product.prodname_copilot_short %}, which may incur additional costs.
 1. For each policy you want to configure, click the dropdown menu and select an enforcement option.
 
-> [!NOTE]
-> The **MCP servers in {% data variables.product.prodname_copilot_short %}** policy controls use where MCP server support is generally available (GA). In features where MCP support is in preview, for example {% data variables.product.prodname_copilot_short %} editors, availability is controlled by the **Editor preview features** policy.
+{% data reusables.copilot.mcp-servers-policy-note %}
 
 ## Opting in to to previews or feedback
 

content/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp.md

@@ -17,26 +17,23 @@ redirect_from:
 contentType: how-tos
 ---
 
->[!NOTE]
-> * MCP support is generally available (GA) in {% data variables.copilot.copilot_chat_short %} for {% data variables.product.prodname_vscode %}.
-> * MCP support for {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vs %}, JetBrains, Eclipse, and Xcode is in {% data variables.release-phases.public_preview %} and is subject to change.
-> * The [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) apply only to {% data variables.product.prodname_copilot_short %} in IDEs where MCP support is still in preview. GA terms apply when using MCP for {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vscode %}.
+{% data reusables.copilot.mcp-availability-and-preview-note %}
 
 ## Introduction
 
 The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). For an overview of MCP, see [AUTOTITLE](/copilot/concepts/about-mcp).
 
 For information on currently available MCP servers, see [the MCP servers repository](https://github.com/modelcontextprotocol/servers/tree/main).
 
-{% vscode %}
-
 {% data reusables.copilot.mcp.mcp-policy %}
 
+{% vscode %}
+
 ## Prerequisites
 
 * **Access to {% data variables.product.prodname_copilot_short %}**. {% data reusables.copilot.subscription-prerequisite %}
 * **{% data variables.product.prodname_vscode %} version 1.99 or later**. For information on installing {% data variables.product.prodname_vscode %}, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download).
-* If you are a member of an organization or enterprise with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP.
+* {% data reusables.copilot.mcp-policy-requirement %}
 
 ## Configuring MCP servers in {% data variables.product.prodname_vscode %}
 
@@ -132,17 +129,22 @@ If you already have an MCP configuration in Claude Desktop, you can use that con
 * **A compatible JetBrains IDE**. {% data variables.product.prodname_copilot %} is compatible with the following IDEs:
 
   {% data reusables.copilot.jetbrains-compatible-ides %}
+* {% data reusables.copilot.mcp-policy-requirement %}
 
 ## Configuring MCP servers in JetBrains IDEs
 
-1. In the lower right corner, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}**.
-1. From the menu, select "Edit settings."
-1. Under the MCP section, click "Edit in `mcp.json`."
-1. Define your MCP servers. You can use the following configuration as an example:
+{% data reusables.copilot.jetbrains-mcp-setup-steps %}
+1. In the `mcp.json` file, define your MCP servers. JetBrains IDEs support both remote and local servers. Remote servers are hosted externally for easier setup and sharing, while local servers run on your local machine and can access local resources.
 
-   {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides %}
+You can use the following configurations as examples:
 
-Alternatively, to access the MCP settings, once you're in "Agent Mode," click the tools icon, then click **Add more tools**.
+### Remote server configuration example with PAT
+
+  {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides-remote %}
+
+### Local server configuration example
+
+  {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides-local %}
 
 {% endjetbrains %}
 
@@ -152,15 +154,22 @@ Alternatively, to access the MCP settings, once you're in "Agent Mode," click th
 
 * **Access to {% data variables.product.prodname_copilot_short %}**. {% data reusables.copilot.subscription-prerequisite %}
 * **{% data variables.product.prodname_copilot %} for Xcode extension**. See [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment).
+* {% data reusables.copilot.mcp-policy-requirement %}
 
 ## Configuring MCP servers in Xcode
 
-1. Open the {% data variables.product.prodname_copilot %} for Xcode extension.
-1. In agent mode, click the tools icon.
-1. Select "Edit config."
-1. Define your MCP servers, editing `mcp.json`. You can use the following configuration as an example:
+{% data reusables.copilot.xcode-mcp-setup-steps %}
+1. Define your MCP servers, editing `mcp.json`. Xcode supports both remote and local servers. Remote servers are hosted externally for easier setup and sharing, while local servers run on your local machine and can access local resources.
+
+You can use the following configurations as examples:
 
-   {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides %}
+### Remote server configuration example with PAT
+
+  {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides-remote %}
+
+### Local server configuration example
+
+  {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides-local %}
 
 {% endxcode %}
 
@@ -172,12 +181,18 @@ Alternatively, to access the MCP settings, once you're in "Agent Mode," click th
 
 ## Configuring MCP servers in Eclipse
 
-1. To open the {% data variables.copilot.copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse.
-1. From the menu, select "Edit preferences."
-1. In the left pane, expand {% data variables.copilot.copilot_chat_short %} and click **MCP**.
-1. Define your MCP servers. You can use the following configuration as an example:
+{% data reusables.copilot.eclipse-mcp-setup-steps %}
+1. Under "Server Configurations", define your MCP servers. Eclipse supports both remote and local servers. Remote servers are hosted externally for easier setup and sharing, while local servers run on your local machine and can access local resources.
+
+You can use the following configurations as examples:
+
+### Remote server configuration example with PAT
+
+  {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides-remote %}
+
+### Local server configuration example
 
-   {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides %}
+  {% data reusables.copilot.mcp-chat-json-snippet-for-other-ides-local %}
 
 {% endeclipse %}
 

content/copilot/how-tos/provide-context/use-mcp/use-the-github-mcp-server.md

@@ -16,9 +16,10 @@ contentType: how-tos
 ---
 
 >[!NOTE]
-> The remote {% data variables.product.github %} MCP server is currently in {% data variables.release-phases.public_preview %} and subject to change; use of the {% data variables.product.github %} MCP server locally is generally available (GA).
->
-> While in {% data variables.release-phases.public_preview %}, access to the remote {% data variables.product.github %} MCP server through OAuth in {% data variables.product.prodname_copilot_short %} is governed by the {% data variables.product.prodname_copilot_short %} **Editor preview features** policy at the organization or enterprise level. PAT access to the server is managed by PAT policies.
+> * The remote {% data variables.product.github %} MCP server is currently in {% data variables.release-phases.public_preview %} and subject to change; use of the {% data variables.product.github %} MCP server locally is generally available (GA).
+> * MCP support is generally available (GA) in {% data variables.product.prodname_copilot_short %} for {% data variables.product.prodname_vscode %}, JetBrains, Eclipse, and Xcode.
+> * The **MCP servers in {% data variables.product.prodname_copilot_short %}** policy for enterprises and organizations, disabled by default, controls use of MCP where MCP server support is generally available (GA).
+> * While in {% data variables.release-phases.public_preview %}, access to the remote {% data variables.product.github %} MCP server through OAuth in {% data variables.product.prodname_copilot_short %} is governed by the {% data variables.product.prodname_copilot_short %} **Editor preview features** policy at the organization or enterprise level. PAT access to the server is managed by PAT policies.
 
 {% vscode %}
 
@@ -28,6 +29,7 @@ contentType: how-tos
 
 * A {% data variables.product.github %} account.
 * {% data variables.product.prodname_vscode %}, or another MCP-compatible editor.
+* {% data reusables.copilot.mcp-policy-requirement %}
 
 ## Setting up the {% data variables.product.github %} MCP server in {% data variables.product.prodname_vscode %}
 
@@ -220,26 +222,37 @@ The {% data variables.product.github %} MCP server enables you to perform a wide
 
   {% data reusables.copilot.jetbrains-compatible-ides %}
 {% data reusables.copilot.jetbrains-plugin-prerequisites %}
+* {% data reusables.copilot.mcp-policy-requirement %}
 
 ## Setting up the {% data variables.product.github %} MCP server in JetBrains IDEs
 
 The instructions below guide you through setting up the {% data variables.product.github %} MCP server in JetBrains IDEs. Other MCP-compatible editors may have similar steps, but the exact process may vary.
 
-We recommend setting up the {% data variables.product.github %} MCP server remotely. JetBrains IDEs only support using a {% data variables.product.pat_generic %} (PAT) for authentication with the {% data variables.product.github %} MCP server.
+We recommend setting up the {% data variables.product.github %} MCP server remotely. The remote {% data variables.product.github %} MCP server uses one-click OAuth authentication by default, but you can also manually configure it to use a {% data variables.product.pat_generic %} (PAT) for authentication. If you use OAuth, the MCP server will have the same access as your {% data variables.product.github %} account. If you use a PAT, the MCP server will have access to the scopes granted by the PAT.
 
 > [!NOTE]
 > If you are an {% data variables.product.prodname_emu %} with PAT restrictions, you won't be able to use PAT authentication.
 
 For information on setting up the {% data variables.product.github %} MCP server locally, see the [GitHub MCP server repository](https://github.com/github/github-mcp-server#usage-in-other-mcp-hosts-1).
 
+### Remote MCP server configuration with OAuth
+
+You do not need to create a PAT or install any additional software to use the remote {% data variables.product.github %} MCP server with OAuth. You can set it up directly in JetBrains IDEs.
+
+{% data reusables.copilot.jetbrains-mcp-setup-steps %}
+1. In the `mcp.json` file, add the following configuration:
+
+    {% data reusables.copilot.github-mcp-oauth-config-other-ides %}
+
+1. In the "{% data variables.product.prodname_copilot %}" popup that says the "MCP server definition wants to authenticate to {% data variables.product.github %}, click **Allow**.
+1. If you have not yet authorized the {% data variables.product.prodname_copilot %} plugin, in the browser popup, click **Continue** next to your personal account.
+
 ### Remote MCP server configuration with PAT
 
 To configure the remote {% data variables.product.github %} MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
 
-1. In the lower right corner, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %}**.
-1. From the menu, select "Edit settings".
-1. Under the MCP section, click "Edit in `mcp.json`".
-1. Add the following configuration, replacing `YOUR_GITHUB_PAT` with the PAT you created:
+{% data reusables.copilot.jetbrains-mcp-setup-steps %}
+1. In the `mcp.json` file, add the following configuration, replacing `YOUR_GITHUB_PAT` with the PAT you created:
 
   ```json copy
     {
@@ -282,25 +295,36 @@ The {% data variables.product.github %} MCP server enables you to perform a wide
 
 * **Access to {% data variables.product.prodname_copilot_short %}**. {% data reusables.copilot.subscription-prerequisite %}
 * **{% data variables.product.prodname_copilot %} for Xcode extension**. See [AUTOTITLE](/copilot/configuring-github-copilot/installing-the-github-copilot-extension-in-your-environment).
+* {% data reusables.copilot.mcp-policy-requirement %}
 
 ## Setting up the {% data variables.product.github %} MCP server in Xcode
 
 The instructions below guide you through setting up the {% data variables.product.github %} MCP server in Xcode. Other MCP-compatible editors may have similar steps, but the exact process may vary.
 
-We recommend setting up the {% data variables.product.github %} MCP server remotely. Xcode only supports using a {% data variables.product.pat_generic %} (PAT) for authentication with the {% data variables.product.github %} MCP server.
+We recommend setting up the {% data variables.product.github %} MCP server remotely. The remote {% data variables.product.github %} MCP server uses one-click OAuth authentication by default, but you can also manually configure it to use a {% data variables.product.pat_generic %} (PAT) for authentication. If you use OAuth, the MCP server will have the same access as your {% data variables.product.github %} account. If you use a PAT, the MCP server will have access to the scopes granted by the PAT.
 
 > [!NOTE]
 > If you are an {% data variables.product.prodname_emu %} with PAT restrictions, you won't be able to use PAT authentication.
 
 For information on setting up the {% data variables.product.github %} MCP server locally, see the [GitHub MCP server repository](https://github.com/github/github-mcp-server#usage-in-other-mcp-hosts-1).
 
+### Remote MCP server configuration with OAuth
+
+You do not need to create a PAT or install any additional software to use the remote {% data variables.product.github %} MCP server with OAuth. You can set it up directly in Xcode.
+
+{% data reusables.copilot.xcode-mcp-setup-steps %}
+1. Add the following configuration:
+
+    {% data reusables.copilot.github-mcp-oauth-config-other-ides %}
+
+1. In the "{% data variables.product.prodname_copilot %}" popup that says the "MCP Server Definition wants to authenticate to {% data variables.product.github %}", click **Continue**.
+1. If you have not yet authorized the {% data variables.product.prodname_copilot %} plugin, in the browser popup, click **Continue** next to your personal account.
+
 ### Remote MCP server configuration with PAT
 
 To configure the remote {% data variables.product.github %} MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
 
-1. Open the {% data variables.product.prodname_copilot %} for Xcode extension.
-1. In agent mode, click the tools icon.
-1. Select "Edit config".
+{% data reusables.copilot.xcode-mcp-setup-steps %}
 1. Add the following configuration, replacing `YOUR_GITHUB_PAT` with the PAT you created:
 
 ```json copy
@@ -348,21 +372,32 @@ The {% data variables.product.github %} MCP server enables you to perform a wide
 
 The instructions below guide you through setting up the {% data variables.product.github %} MCP server in Eclipse. Other MCP-compatible editors may have similar steps, but the exact process may vary.
 
-We recommend setting up the {% data variables.product.github %} MCP server remotely. Eclipse only supports using a {% data variables.product.pat_generic %} (PAT) for authentication with the {% data variables.product.github %} MCP server.
+We recommend setting up the {% data variables.product.github %} MCP server remotely. The remote {% data variables.product.github %} MCP server uses one-click OAuth authentication by default, but you can also manually configure it to use a {% data variables.product.pat_generic %} (PAT) for authentication. If you use OAuth, the MCP server will have the same access as your {% data variables.product.github %} account. If you use a PAT, the MCP server will have access to the scopes granted by the PAT.
 
 > [!NOTE]
 > If you are an {% data variables.product.prodname_emu %} with PAT restrictions, you won't be able to use PAT authentication.
 
 For information on setting up the {% data variables.product.github %} MCP server locally, see the [GitHub MCP server repository](https://github.com/github/github-mcp-server#usage-in-other-mcp-hosts-1).
 
+### Remote MCP server configuration with OAuth
+
+You do not need to create a PAT or install any additional software to use the remote {% data variables.product.github %} MCP server with OAuth. You can set it up directly in Eclipse.
+
+{% data reusables.copilot.eclipse-mcp-setup-steps %}
+1. Add the following configuration under "Server Configurations":
+
+    {% data reusables.copilot.github-mcp-oauth-config-other-ides %}
+
+1. Click **Apply**.
+1. In the "{% data variables.product.prodname_copilot %}" popup that says the "MCP Server Definition wants to authenticate to {% data variables.product.github %}", click **OK**.
+1. If you have not yet authorized the {% data variables.product.prodname_copilot %} plugin, in the browser popup, click **Continue** next to your personal account.
+
 ### Remote MCP server configuration with PAT
 
 To configure the remote {% data variables.product.github %} MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).
 
-1. To open the {% data variables.copilot.copilot_chat_short %} panel, click the {% data variables.product.prodname_copilot_short %} icon ({% octicon "copilot" aria-hidden="true" aria-label="copilot" %}) in the status bar at the bottom of Eclipse.
-1. From the menu, select "Edit preferences".
-1. In the left pane, expand {% data variables.product.prodname_copilot %} and click **MCP**.
-1. Add the following configuration, replacing `YOUR_GITHUB_PAT` with the PAT you created:
+{% data reusables.copilot.eclipse-mcp-setup-steps %}
+1. Add the following configuration under "Server Configurations", replacing `YOUR_GITHUB_PAT` with the PAT you created:
 
   ```json copy
     {