Update docs to include Remote MCP support in CCA (#56499)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: hubwriter <hubwriter@github.com>
Co-authored-by: Tim Rogers <timrogers@github.com>

Author: 4 people

content/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request.md

@@ -66,6 +66,30 @@ You can ask {% data variables.product.prodname_copilot_short %} to work on a tas
 
    {% data variables.product.prodname_copilot_short %} will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.
 
+## Asking {% data variables.product.prodname_copilot_short %} to create a pull request from the {% data variables.product.github %} MCP server
+
+As an alternative to using {% data variables.copilot.copilot_chat_short %}, you can use the remote {% data variables.product.github %} MCP server to trigger {% data variables.copilot.copilot_coding_agent %} from any MCP host.
+
+> [!NOTE]
+> * This capability is only available on the remote {% data variables.product.github %} MCP server and host applications where remote MCP servers are supported.
+
+1. Install the {% data variables.product.github %} MCP server in your preferred IDE or agentic coding tool. See [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server).
+
+1. Ensure the `create_pull_request_with_copilot` tool is enabled.
+
+1. Open chat.
+
+1. Type a prompt asking {% data variables.product.prodname_copilot_short %} to create a pull request, with the details of what you want to change.
+
+   For example, `Open a PR in my repository to expand unit test coverage.`
+
+   > [!TIP]
+   > * You can ask {% data variables.product.prodname_copilot_short %} to open a pull request using a specific branch as the base branch by including it in your prompt.
+
+1. Submit your prompt.
+
+   {% data variables.product.prodname_copilot_short %} will start a new session, open a draft pull request and work on the task in the background. As it works, it will push changes to the pull request, and once it has finished, it will add you as a reviewer. In most cases, the MCP host will show you the URL of the created pull request.
+
 ## Monitoring progress
 
 You can view your current and past {% data variables.product.prodname_copilot_short %} sessions from the [Agents page](https://github.com/copilot/agents). See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs).

content/copilot/how-tos/agents/copilot-coding-agent/extending-copilot-coding-agent-with-mcp.md

@@ -24,13 +24,13 @@ redirect_from:
 
 {% data reusables.copilot.coding-agent.mcp-brief-intro %}
 
-The agent can use tools provided by local MCP servers. Some MCP servers are configured by default to provide the best experience for getting started.
+The agent can use tools provided by local and remote MCP servers. Some MCP servers are configured by default to provide the best experience for getting started.
 
 For more information on MCP, see [the official MCP documentation](https://modelcontextprotocol.io/introduction). For information on some of the currently available MCP servers, see [the MCP servers repository](https://github.com/modelcontextprotocol/servers/tree/main).
 
 > [!NOTE]
 > * {% data variables.copilot.copilot_coding_agent %} only supports tools provided by MCP servers. It does not support resources or prompts.
-> * {% data variables.copilot.copilot_coding_agent %} currently only supports local MCP servers. To learn more about transport types, see the [official MCP documentation](https://modelcontextprotocol.io/docs/concepts/transports).
+> * {% data variables.copilot.copilot_coding_agent %} does not currently support remote MCP servers that leverage OAuth for authentication and authorization.
 
 ## Default MCP servers
 
@@ -77,14 +77,23 @@ You configure MCP servers using a special JSON format. The JSON must contain an
 
 The configuration object can contain the following keys:
 
-* `command` (`string`): The command to run to start the MCP server.
-* `args` (`string[]`): The arguments to pass to the `command`.
+**Required keys for local and remote MCP servers**
 * `tools` (`string[]`): The tools from the MCP server to enable. You may be able to find a list of tools in the server's documentation, or in its code. We strongly recommend that you allowlist specific read-only tools, since the agent will be able to use these tools autonomously and will not ask you for approval first. You can also enable all tools by including `*` in the array.
-* `type` (`string`): {% data variables.copilot.copilot_coding_agent %} only accepts `"local"`.
-* `env` (`object`): The environment variables to pass to the server. This object should map the name of the environment variable that should be exposed to your MCP server to either of the following:
+* `type` (`string`): {% data variables.copilot.copilot_coding_agent %} accepts `"local"`, `"http"`, or `"sse"`.
+
+**Local MCP specific keys**
+* `command` (`string`): Required. The command to run to start the MCP server.
+* `args` (`string[]`): Required. The arguments to pass to the `command`.
+* `env` (`object`): Optional. The environment variables to pass to the server. This object should map the name of the environment variable that should be exposed to your MCP server to either of the following:
   * The name of a {% data variables.product.prodname_actions %} secret you have configured, beginning with `COPILOT_MCP_`.
   * A string value.
 
+**Remote MCP specific keys**
+* `url` (`string`): Required. The MCP server's URL.
+* `headers` (`object`): Optional. The headers to attach to requests to the server. This object should map the name of header keys to either of the following:
+  * The name of a {% data variables.product.prodname_actions %} secret you have configured, beginning with `COPILOT_MCP_` preceded by a `$`
+  * A string value
+
 ### Example configurations
 
 #### Example: Sentry
@@ -96,6 +105,7 @@ The [Sentry MCP server](https://github.com/getsentry/sentry-mcp) gives {% data v
 {
   "mcpServers": {
     "sentry": {
+      "type": "local",
       "command": "npx",
       // We can use the $SENTRY_HOST environment variable which is passed to
       // the server because of the `env` value below.
@@ -122,6 +132,7 @@ The [Notion MCP server](https://github.com/makenotion/notion-mcp-server) gives {
 {
   "mcpServers": {
     "notionApi": {
+      "type": "local",
       "command": "docker",
       "args": [
         "run",
@@ -185,19 +196,36 @@ To use the Azure MCP with {% data variables.copilot.copilot_coding_agent %}, you
    {
      "mcpServers": {
        "Azure": {
-         "command": "npx",
-         "args": [
-           "-y",
-           "@azure/mcp@latest",
-           "server",
-           "start"
+        "type": "local",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@azure/mcp@latest",
+          "server",
+          "start"
          ],
-           "tools": ["*"]
+        "tools": ["*"]
        }
      }
    }
    ```
 
+#### Example: Cloudflare
+
+The [Cloudflare MCP server](https://github.com/cloudflare/mcp-server-cloudflare) creates connections between your Cloudflare services, including processing documentation and data analysis.
+
+```json copy
+{
+  "mcpServers": {
+    "cloudflare": {
+      "type": "sse",
+      "url": "https://docs.mcp.cloudflare.com/sse",
+      "tools": ["*"]
+    }
+  }
+}
+```
+
 ### Reusing your MCP configuration from {% data variables.product.prodname_vscode %}
 
 If you have already configured MCP servers in {% data variables.product.prodname_vscode_shortname %}, you can leverage a similar configuration for {% data variables.copilot.copilot_coding_agent %}.