Model Context Protocol (MCP) - GitHub Docs
Skip to main content Skip to content Collapse sidebar Expand sidebar Model Context Protocol (MCP) Connect Copilot to external tools and data through Model Context Protocol (MCP) servers. In this article Overview of Model Context Protocol (MCP) The Model Context Protocol (MCP) is an open standard that defines how applications share context with large language models (LLMs). MCP provides a standardized way to connect AI models to different data sources and tools, enabling them to work together more effectively.
You can use MCP to extend the capabilities of GitHub Copilot by integrating it with a wide range of existing tools and services. MCP works across all major Copilot surfaces—whether you're working in an IDE, using GitHub Copilot CLI, working in the GitHub Copilot app, or delegating tasks to an agent on GitHub.com. You can also use MCP to create new tools and services that work with Copilot, allowing you to customize and enhance your experience.
For example, you can connect an issue tracker so Copilot can look up a bug while working on a fix, without asking you to copy the issue into chat. For more information on MCP, see the official MCP documentation . For a curated list of MCP servers from partners and the community, see the GitHub MCP Registry . Enterprises and organizations can choose to enable or disable use of MCP for members of their organization or enterprise with the MCP servers in Copilot policy.
The policy is disabled by default. See Managing policies and features for GitHub Copilot in your enterprise and Managing policies and features for GitHub Copilot in your organization . The MCP policy only applies to users who have a Copilot Business or Copilot Enterprise subscription from an organization or enterprise that configures the policy. Copilot Free, Copilot Pro, Copilot Pro+, or Copilot Max do not have their MCP access governed by this policy.
MCP complements the context you provide through prompts, files, and instructions. It adds connections to tools and data, rather than replacing guidance about how the agent should work. For guidance about prompting and managing context, see Prompting and context for GitHub Copilot . Connect a service once through GitHub-verified MCP servers (connectors), then use the connection across supported Copilot surfaces without repeating setup or signing in separately in each one.
These connections also work in Copilot sessions running in a cloud sandbox, but not in sessions running on GitHub Actions. See Copilot connectors . Where you can use MCP MCP setup depends on where you use Copilot: The GitHub Copilot app : You can use MCP servers configured for your repository or in your local Copilot configuration. You can also discover and install additional MCP servers from the Customize tab. Copilot CLI : GitHub Copilot CLI supports both local and remote MCP servers.
The GitHub MCP server is built in and available without additional configuration. Copilot cloud agent (including automations) and Copilot code review : GitHub.com supports MCP servers configured at the repository level. The configuration applies to Copilot cloud agent, automations and Copilot code review. The GitHub MCP server and Playwright MCP server are configured by default. IDEs : MCP servers are supported in Visual Studio Code, Visual Studio, JetBrains IDEs, Xcode, and Eclipse.
Connection and authentication options depend on the IDE. See Extending GitHub Copilot Chat with Model Context Protocol (MCP) servers . Chat on GitHub.com has preconfigured tools, such as tools for creating branches and searching code. This is separate from the repository MCP settings for Copilot cloud agent and Copilot code review. See GitHub Copilot on GitHub.com and GitHub Mobile . MCP for Copilot cloud agent The following sections describe MCP defaults and configuration for Copilot cloud agent, including automations.
Repository-level MCP settings also apply to Copilot code review, as noted below. For other surfaces, use the setup guides in Next steps . Default MCP servers Copilot cloud agent starts with two MCP servers configured: GitHub provides access to repository data such as issues and pull requests. By default, it uses a specially scoped token with read-only access to the current repository. Access outside that repository requires explicitly configuring credentials with broader access.
Playwright provides tools to read, interact with, and take screenshots of web pages. By default, it can only access web resources in the agent's own environment through localhost or 127.0.0.1 . These defaults are specific to the cloud environment. For example, Copilot CLI includes the GitHub MCP server without additional configuration, but you configure other servers separately. Personal MCP servers Personal MCP servers connect Copilot to tools and data for your own workflow.
Configure a server once to make it available in every cloud session you start. These servers are available only to you and do not affect other users working in the same repository. Before configuring a personal MCP server, check if the service you need is covered by GitHub-verified MCP servers (connectors). GitHub-verified MCP servers are available in both cloud and local sessions, and GitHub handles MCP server configuration and authentication for you.
By contrast, personal MCP servers only support key-based authentication and are only available in cloud sandboxes. See Copilot connectors . Use personal MCP servers for connections you want across repositories or that require your own credentials. To provide a shared configuration for collaborators working in a particular repository, use repository-level configuration instead. Navigate to your Copilot home page at github.com/copilot .
In the left menu, click the Customize menu. Check whether the service you need is covered by a GitHub-verified MCP server. If a GitHub-verified MCP server doesn't cover your needs and you want to configure your own MCP server, select the Add dropdown menu, then click MCP server . Enter the server name, transport type, URL or startup command, and other required configuration. If authentication is required, create secrets in Personal MCP server secrets with names prefixed with COPILOT_MCP_ , such as COPILOT_MCP_API_KEY , and reference them in the server configuration.
Click Add server . By default, personal MCP server secrets are available in sessions scoped to your personal account. You can also allow their use in selected organizations to use your authenticated servers there. Limitations Personal MCP servers are available in every cloud session. You cannot currently choose which servers to enable for an individual session. Custom HTTP and SSE MCP servers do not support query parameters in their URLs.
Pass these values as request headers instead. If a server is unavailable, check its configuration and confirm that any required secrets exist and are available to the account or organization where the session runs. You can use up to 50 MCP servers in total across personal and repository-level configurations. Repository-level configuration Repository-level MCP servers connect Copilot to tools and data for work in a specific repository.
Repository administrators configure these servers in repository settings on GitHub.com, and the configuration is available to anyone with write access to the repository. These settings apply to both Copilot in the cloud (including automations) and Copilot code review. You can disable MCP tool use for code review separately. Use repository-level configuration when collaborators need the same tools, such as a shared issue tracker or documentation service.
For servers that require authentication, use a service account for Copilot rather than personal credentials. Repository-level servers cannot reference personal MCP server secrets. You can use personal and repository-level servers together. If both configurations define a server with the same name, the repository-level configuration takes precedenc
The rest of this page is on the live site.