use-cloud-agent-with-mcp.md

title	Using Copilot cloud agent via the GitHub MCP Server
shortTitle	Use cloud agent via GitHub MCP Server
intro	Start {% data variables.copilot.copilot_cloud_agent %} sessions from any IDE or agentic tool that supports Model Context Protocol (MCP).
product	{% data reusables.gated-features.copilot-cloud-agent %}<br><a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=purchase&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>
versions	feature copilot
contentType	how-tos
allowTitleToDifferFromFilename	true
category	Author and optimize with Copilot

Note

• This capability is only available on the remote {% data variables.product.github %} MCP Server and host applications where remote MCP Servers are supported.

Starting a session

1. Install the {% data variables.product.github %} MCP Server in your preferred IDE or agentic coding tool. See AUTOTITLE.

2. Ensure the create_pull_request_with_copilot tool is enabled.

3. Open chat.

4. 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.

5. 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.

Further reading

• AUTOTITLE
• AUTOTITLE