diff --git a/content/billing/how-tos/products/add-advanced-security.md b/content/billing/how-tos/products/buy-advanced-security.md similarity index 93% rename from content/billing/how-tos/products/add-advanced-security.md rename to content/billing/how-tos/products/buy-advanced-security.md index 938d97ee5c15..965043ab3688 100644 --- a/content/billing/how-tos/products/add-advanced-security.md +++ b/content/billing/how-tos/products/buy-advanced-security.md @@ -1,7 +1,7 @@ --- title: Buying Advanced Security for your organization or enterprise -intro: 'How to buy licenses for {% data variables.product.prodname_GHAS %} whether you have usage-based or volume/subscription billing.' -permissions: 'Organization or enterprise owners can sign up for {% data variables.product.prodname_GH_cs_or_sp %}' +intro: How to buy licenses for {% data variables.product.prodname_GHAS %} whether you have usage-based or volume/subscription billing. +permissions: Organization or enterprise owners can sign up for {% data variables.product.prodname_GH_cs_or_sp %} product: '{% data reusables.gated-features.ghas-billing %}' versions: fpt: '*' @@ -9,12 +9,12 @@ versions: redirect_from: - /billing/managing-billing-for-github-advanced-security/signing-up-for-github-advanced-security - /billing/managing-billing-for-your-products/managing-billing-for-github-advanced-security/signing-up-for-github-advanced-security + - /billing/how-tos/products/add-advanced-security topics: - Billing - Advanced Security - Enterprise shortTitle: Buy Advanced Security -allowTitleToDifferFromFilename: true contentType: how-tos --- diff --git a/content/billing/how-tos/products/download-ghas-license-use.md b/content/billing/how-tos/products/download-license-use.md similarity index 92% rename from content/billing/how-tos/products/download-ghas-license-use.md rename to content/billing/how-tos/products/download-license-use.md index 615ca33bc13f..83c362e2f17e 100644 --- a/content/billing/how-tos/products/download-ghas-license-use.md +++ b/content/billing/how-tos/products/download-license-use.md @@ -1,6 +1,6 @@ --- -title: 'Downloading license use for your enterprise or organization' -intro: 'Get data on consumption of {% data variables.product.github %}, {% data variables.product.prodname_copilot_short %}, and {% data variables.product.prodname_AS %} licenses.' +title: Downloading license use for your enterprise or organization +intro: Get data on consumption of {% data variables.product.github %}, {% data variables.product.prodname_copilot_short %}, and {% data variables.product.prodname_AS %} licenses. permissions: '{% data reusables.permissions.enhanced-billing-enterprise %}' versions: fpt: '*' @@ -11,9 +11,9 @@ topics: - Advanced Security - Enterprise shortTitle: Download license use -allowTitleToDifferFromFilename: true redirect_from: - /billing/managing-billing-for-your-products/managing-billing-for-github-advanced-security/downloading-your-github-advanced-security-usage + - /billing/how-tos/products/download-ghas-license-use contentType: how-tos --- diff --git a/content/billing/how-tos/products/index.md b/content/billing/how-tos/products/index.md index 4595a1aa06c9..3ef4c267d107 100644 --- a/content/billing/how-tos/products/index.md +++ b/content/billing/how-tos/products/index.md @@ -23,10 +23,11 @@ versions: topics: - Billing children: - - /view-product-use - - /download-ghas-license-use - - /add-advanced-security - - /manage-ghas-license + - /view-productlicense-use + - /download-license-use + - /buy-advanced-security + - /manage-ghas-licenses - /view-ghas-committers contentType: how-tos --- + diff --git a/content/billing/how-tos/products/manage-ghas-license.md b/content/billing/how-tos/products/manage-ghas-licenses.md similarity index 86% rename from content/billing/how-tos/products/manage-ghas-license.md rename to content/billing/how-tos/products/manage-ghas-licenses.md index fa0f18a55804..98667d245983 100644 --- a/content/billing/how-tos/products/manage-ghas-license.md +++ b/content/billing/how-tos/products/manage-ghas-licenses.md @@ -1,19 +1,19 @@ --- -title: 'Managing volume licenses for GitHub Advanced Security' -intro: 'You can monitor and control the availability and consumption of licenses for {% data variables.product.prodname_AS %} in repositories in your enterprise.' -permissions: 'Enterprise owners with **volume/subscription licenses** for {% data variables.product.prodname_AS %}.
For metered usage, see [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending).' +title: Managing volume licenses for GitHub Advanced Security +intro: You can monitor and control the availability and consumption of licenses for {% data variables.product.prodname_AS %} in repositories in your enterprise. +permissions: Enterprise owners with **volume/subscription licenses** for {% data variables.product.prodname_AS %}.
For metered usage, see [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending). versions: fpt: '*' ghec: '*' redirect_from: - /billing/managing-billing-for-github-advanced-security/managing-your-github-advanced-security-licensing - /billing/managing-billing-for-your-products/managing-billing-for-github-advanced-security/managing-your-github-advanced-security-licensing + - /billing/how-tos/products/manage-ghas-license topics: - Billing - Advanced Security - Enterprise shortTitle: Manage GHAS licenses -allowTitleToDifferFromFilename: true contentType: how-tos --- diff --git a/content/billing/how-tos/products/view-product-use.md b/content/billing/how-tos/products/view-productlicense-use.md similarity index 99% rename from content/billing/how-tos/products/view-product-use.md rename to content/billing/how-tos/products/view-productlicense-use.md index ed16b14c836a..abc339cf791f 100644 --- a/content/billing/how-tos/products/view-product-use.md +++ b/content/billing/how-tos/products/view-productlicense-use.md @@ -28,6 +28,7 @@ redirect_from: - /billing/managing-billing-for-github-packages/viewing-your-github-packages-usage - /billing/managing-billing-for-your-products/managing-billing-for-github-packages/viewing-your-github-packages-usage - /billing/managing-billing-for-your-products/viewing-your-product-usage + - /billing/how-tos/products/view-product-use versions: fpt: '*' ghec: '*' @@ -35,9 +36,8 @@ versions: topics: - Billing shortTitle: View product/license use -allowTitleToDifferFromFilename: true permissions: '{% data reusables.permissions.enhanced-billing-cloud-all %}' -product: 'Cloud only' +product: Cloud only contentType: how-tos --- diff --git a/content/billing/index.md b/content/billing/index.md index 7f9ed7618446..c4f687af9130 100644 --- a/content/billing/index.md +++ b/content/billing/index.md @@ -18,7 +18,7 @@ featuredLinks: - '{% ifversion ghes %}/billing/concepts/enterprise-billing/combined-enterprise-use{% endif %}' popular: - '{% ifversion ghec %}/billing/how-tos/manage-plan-and-licenses/view-enterprise-usage{% endif %}' - - '{% ifversion fpt or ghec %}/billing/how-tos/products/view-product-use{% endif %}' + - '{% ifversion fpt or ghec %}/billing/how-tos/products/view-productlicense-use{% endif %}' - '{% ifversion fpt or ghec %}/billing/concepts/product-billing/github-actions{% endif %}' - '{% ifversion fpt or ghec %}/billing/concepts/product-billing/github-copilot{% endif %}' - '{% ifversion fpt or ghec %}/billing/concepts/product-billing/github-codespaces{% endif %}' diff --git a/content/billing/reference/models-multipliers-and-costs.md b/content/billing/reference/costs-for-github-models.md similarity index 96% rename from content/billing/reference/models-multipliers-and-costs.md rename to content/billing/reference/costs-for-github-models.md index cb87c8cccf8e..4e8486d7d24e 100644 --- a/content/billing/reference/models-multipliers-and-costs.md +++ b/content/billing/reference/costs-for-github-models.md @@ -1,13 +1,14 @@ --- title: Costs and multipliers for using GitHub Models directly shortTitle: Costs for GitHub Models -allowTitleToDifferFromFilename: true -intro: 'Reference information for calculating the cost of using different {% data variables.product.prodname_github_models %} directly (outside {% data variables.product.prodname_copilot %}).' +intro: Reference information for calculating the cost of using different {% data variables.product.prodname_github_models %} directly (outside {% data variables.product.prodname_copilot %}). versions: feature: github-models topics: - Billing contentType: reference +redirect_from: + - /billing/reference/models-multipliers-and-costs --- ## Use of models in {% data variables.product.github %} diff --git a/content/billing/reference/license-consumption.md b/content/billing/reference/github-license-users.md similarity index 97% rename from content/billing/reference/license-consumption.md rename to content/billing/reference/github-license-users.md index 5ee886572f0d..bd0aa2e28bf9 100644 --- a/content/billing/reference/license-consumption.md +++ b/content/billing/reference/github-license-users.md @@ -1,8 +1,7 @@ --- title: People who consume a license in an organization -intro: 'Learn how consumption of {% data variables.product.github %} licenses is determined for paid organizations and enterprises.' +intro: Learn how consumption of {% data variables.product.github %} licenses is determined for paid organizations and enterprises. shortTitle: GitHub license users -allowTitleToDifferFromFilename: true redirect_from: - /github/setting-up-and-managing-billing-and-payments-on-github/about-per-user-pricing - /articles/about-per-user-pricing @@ -10,6 +9,7 @@ redirect_from: - /github/billing/managing-billing-for-your-github-account/about-per-user-pricing - /billing/managing-the-plan-for-your-github-account/about-per-user-pricing - /billing/concepts/license-consumption + - /billing/reference/license-consumption versions: fpt: '*' ghec: '*' diff --git a/content/billing/reference/index.md b/content/billing/reference/index.md index 69a4579dc580..87645b30dd84 100644 --- a/content/billing/reference/index.md +++ b/content/billing/reference/index.md @@ -17,9 +17,10 @@ children: - /billing-roles - /cost-center-allocation - /roles-for-visual-studio - - /license-consumption + - /github-license-users - /license-reports - - /models-multipliers-and-costs + - /costs-for-github-models - /enterprise-license-troubleshooting contentType: reference --- + diff --git a/content/billing/reference/license-reports.md b/content/billing/reference/license-reports.md index 48deeeb43d36..9b7312cabfb1 100644 --- a/content/billing/reference/license-reports.md +++ b/content/billing/reference/license-reports.md @@ -2,7 +2,6 @@ title: License reports reference shortTitle: License reports intro: 'License reports show details of the users consuming licenses that you pay for.' -allowTitleToDifferFromFilename: true versions: fpt: '*' ghec: '*' diff --git a/content/billing/reference/usage-reports.md b/content/billing/reference/usage-reports.md index d8b20393b964..224b0a7da76c 100644 --- a/content/billing/reference/usage-reports.md +++ b/content/billing/reference/usage-reports.md @@ -2,7 +2,6 @@ title: Usage reports reference shortTitle: Usage reports intro: 'Usage reports show detailed {% data variables.product.github %} usage and billing information for your account.' -allowTitleToDifferFromFilename: true versions: fpt: '*' ghec: '*' diff --git a/content/copilot/concepts/chat.md b/content/copilot/concepts/chat.md index ed2e2fa3e6f1..0d4bd34eb789 100644 --- a/content/copilot/concepts/chat.md +++ b/content/copilot/concepts/chat.md @@ -43,6 +43,16 @@ For more information, see [AUTOTITLE](/copilot/customizing-copilot/adding-reposi {% data reusables.copilot.change-the-ai-model %} -## Extending {% data variables.copilot.copilot_chat_dotcom_short %} +## Extending {% data variables.copilot.copilot_chat_short %} + +{% data variables.copilot.copilot_chat_short %} can be extended in a variety of ways to enhance its functionality and integrate it with other tools and services. This can include using the Model Context Protocol (MCP) to provide context-aware AI assistance, or connecting third-party tools to leverage {% data variables.product.github %}’s AI capabilities. + +### Extending {% data variables.copilot.copilot_chat_short %} with MCP + +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 configure MCP servers to provide context to {% data variables.copilot.copilot_chat_short %} in various IDEs, such as {% data variables.product.prodname_vscode %} and JetBrains IDEs. For {% data variables.copilot.copilot_chat_dotcom_short %}, the {% data variables.product.github %} MCP server is automatically configured, enabling {% data variables.copilot.copilot_chat_short %} to perform a limited set of tasks, at your request, such as creating branches or merging pull requests. For more information, see [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/extending-copilot-chat-with-mcp) and [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server). + +### Extending {% data variables.copilot.copilot_chat_short %} with external tools {% data reusables.copilot.copilot-extensions.extending-copilot-chat %} diff --git a/content/copilot/how-tos/provide-context/use-mcp/use-the-github-mcp-server.md b/content/copilot/how-tos/provide-context/use-mcp/use-the-github-mcp-server.md index a26799333797..6198c0cc851d 100644 --- a/content/copilot/how-tos/provide-context/use-mcp/use-the-github-mcp-server.md +++ b/content/copilot/how-tos/provide-context/use-mcp/use-the-github-mcp-server.md @@ -23,6 +23,8 @@ contentType: how-tos {% vscode %} +{% data reusables.copilot.mcp.mcp-ide-preview-note %} + {% data reusables.copilot.mcp.about-github-mcp-server %} ## Prerequisites @@ -209,10 +211,14 @@ The {% data variables.product.github %} MCP server enables you to perform a wide * In the {% data variables.copilot.copilot_chat_short %} box, you may be asked to give additional permissions or provide more information to complete the action. 1. Follow the prompts to complete the action. +{% data reusables.copilot.mcp.troubleshooting-mcp-server %} + {% endvscode %} {% jetbrains %} +{% data reusables.copilot.mcp.mcp-ide-preview-note %} + {% data reusables.copilot.mcp.about-github-mcp-server %} ## Prerequisites @@ -285,10 +291,14 @@ The {% data variables.product.github %} MCP server enables you to perform a wide * In the {% data variables.copilot.copilot_chat_short %} box, you may be asked to give additional permissions or provide more information to complete the action. 1. Follow the prompts to complete the action. +{% data reusables.copilot.mcp.troubleshooting-mcp-server %} + {% endjetbrains %} {% xcode %} +{% data reusables.copilot.mcp.mcp-ide-preview-note %} + {% data reusables.copilot.mcp.about-github-mcp-server %} ## Prerequisites @@ -356,10 +366,14 @@ The {% data variables.product.github %} MCP server enables you to perform a wide * In the {% data variables.copilot.copilot_chat_short %} box, you may be asked to give additional permissions or provide more information to complete the action. 1. Follow the prompts to complete the action. +{% data reusables.copilot.mcp.troubleshooting-mcp-server %} + {% endxcode %} {% eclipse %} +{% data reusables.copilot.mcp.mcp-ide-preview-note %} + {% data reusables.copilot.mcp.about-github-mcp-server %} ## Prerequisites @@ -428,9 +442,42 @@ The {% data variables.product.github %} MCP server enables you to perform a wide * In the {% data variables.copilot.copilot_chat_short %} box, you may be asked to give additional permissions or provide more information to complete the action. 1. Follow the prompts to complete the action. +{% data reusables.copilot.mcp.troubleshooting-mcp-server %} + {% endeclipse %} -{% data reusables.copilot.mcp.troubleshooting-mcp-server %} +{% webui %} + +>[!NOTE] MCP in {% data variables.copilot.copilot_chat_dotcom_short %} is currently in {% data variables.release-phases.public_preview %} and subject to change. + +## About MCP in {% data variables.copilot.copilot_chat_dotcom_short %} + +The {% data variables.product.github %} MCP server is a Model Context Protocol (MCP) server provided and maintained by {% data variables.product.github %}. MCP allows you to integrate AI capabilities with other tools and services, enhancing your development experience by providing context-aware AI assistance. + +For more information on MCP, see [the official MCP documentation](https://modelcontextprotocol.io/introduction). + +Within {% data variables.copilot.copilot_chat_dotcom_short %}, the {% data variables.product.github %} MCP server is automatically configured, with a limited set of skills available. This allows you to instruct {% data variables.copilot.copilot_chat_short %} to perform tasks such as creating branches or merging pull requests on your behalf. For a full list of available skills, see [AUTOTITLE](/copilot/reference/github-copilot-chat-cheat-sheet#mcp-skills). + +## Using the {% data variables.product.github %} MCP server in {% data variables.copilot.copilot_chat_dotcom_short %} + +The {% data variables.product.github %} MCP server is automatically configured in {% data variables.copilot.copilot_chat_dotcom_short %}. You can start using it immediately without any additional setup. + +{% data reusables.copilot.immersive-mode-instructions %} +1. In the prompt box, type a request related to the skill you want {% data variables.copilot.copilot_chat_short %} to perform, and press **Enter**. + + Some examples of requests you can make are: + * `Create a new branch called [BRANCH-NAME] in the repository [USERNAME/REPO-NAME].` + * `Create a new branch called [BRANCH-NAME] in the repository [USERNAME/REPO-NAME].` + * `Merge the pull request [PULL-REQUEST-NUMBER] in the repository [USERNAME/REPO-NAME].` + +1. {% data variables.copilot.copilot_chat_short %} will ask you to confirm that you want to proceed with the action. Click **Allow** to confirm. +1. {% data variables.copilot.copilot_chat_short %} will use the relevant skill from the {% data variables.product.github %} MCP server to perform the action you requested. {% data variables.copilot.copilot_chat_short %} will show you the result of the action in the chat interface. + +## Limitations + +The {% data variables.product.github %} MCP server in {% data variables.copilot.copilot_chat_dotcom_short %} is currently limited to a set of predefined skills. If you ask {% data variables.copilot.copilot_chat_short %} to perform an action that is not supported by the MCP server, it will still attempt to provide a helpful response, but it may not be able to perform the action as expected. For example, if you ask {% data variables.copilot.copilot_chat_short %} to create a new issue, it may provide you with a draft issue template, but you will still need to manually create the issue. + +{% endwebui %} ## Further reading diff --git a/content/copilot/how-tos/use-chat/use-chat-in-github.md b/content/copilot/how-tos/use-chat/use-chat-in-github.md index 50fb1e9e0e50..87a62f981664 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-github.md +++ b/content/copilot/how-tos/use-chat/use-chat-in-github.md @@ -20,6 +20,10 @@ redirect_from: contentType: how-tos --- +## Introduction + +This guide describes how to use {% data variables.copilot.copilot_chat_short %} to ask questions about software development in {% data variables.product.github %}. You can ask general questions about software development, or specific questions about the issues or code in a repository. For more information, see [AUTOTITLE](/copilot/concepts/about-github-copilot-chat). + ## Submitting a question to {% data variables.copilot.copilot_chat_short %} You can open {% data variables.copilot.copilot_chat_short %} from any page on {% data variables.product.github %}. Certain questions may require you to be in a specific context, such as a repository, issue, or pull request. The following procedure describes how to ask a general software related question, and demonstrates the core functionality of {% data variables.copilot.copilot_chat_short %} on {% data variables.product.github %}. For more information on other scenarios, see [Asking {% data variables.copilot.copilot_chat_short %} questions in different contexts](/copilot/using-github-copilot/asking-github-copilot-questions-in-github#asking-copilot-chat-questions-in-different-contexts). diff --git a/content/copilot/how-tos/use-chat/use-chat-in-ide.md b/content/copilot/how-tos/use-chat/use-chat-in-ide.md index 6adf4d4b151a..0ab8af349eb4 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-ide.md +++ b/content/copilot/how-tos/use-chat/use-chat-in-ide.md @@ -19,6 +19,10 @@ shortTitle: Use Chat in IDE contentType: how-tos --- +## Introduction + +This guide describes how to use {% data variables.copilot.copilot_chat_short %} to ask questions about software development in your IDE. You can ask general questions about software development, or specific questions about the code in your project. For more information, see [AUTOTITLE](/copilot/concepts/about-github-copilot-chat). + {% vscode %} ## Prerequisites diff --git a/content/copilot/how-tos/use-chat/use-chat-in-mobile.md b/content/copilot/how-tos/use-chat/use-chat-in-mobile.md index 81f5971ca557..941a5fb0030e 100644 --- a/content/copilot/how-tos/use-chat/use-chat-in-mobile.md +++ b/content/copilot/how-tos/use-chat/use-chat-in-mobile.md @@ -20,7 +20,7 @@ contentType: how-tos ## Overview -{% data variables.copilot.copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions in {% data variables.product.prodname_mobile %}. You can also use {% data variables.copilot.copilot_chat %} on either {% data variables.product.github %} or within a supported IDE. For information on using {% data variables.copilot.copilot_chat %} in an IDE, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide). +{% data variables.copilot.copilot_chat %} is a chat interface that lets you ask and receive answers to coding-related questions in {% data variables.product.prodname_mobile %}. You can also use {% data variables.copilot.copilot_chat %} on either {% data variables.product.github %} or within a supported IDE. For information about {% data variables.copilot.copilot_chat %}, see [AUTOTITLE](/copilot/concepts/about-github-copilot-chat). {% data variables.copilot.copilot_mobile_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. For more information, see [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-github-mobile/about-github-copilot-chat-in-github-mobile). diff --git a/content/copilot/reference/cheat-sheet.md b/content/copilot/reference/cheat-sheet.md index f8d4983eb234..7666f77622f1 100644 --- a/content/copilot/reference/cheat-sheet.md +++ b/content/copilot/reference/cheat-sheet.md @@ -44,6 +44,22 @@ Available slash commands may vary, depending on your environment and the context | `/new` | Start a new conversation | | `/rename` | Rename a conversation. | +## MCP skills + +Below is a list of the MCP skills that are currently available in {% data variables.copilot.copilot_chat_dotcom_short %}, and example prompts you can use to invoke them. You do not need to use the MCP skill name in your prompt; you can simply ask {% data variables.copilot.copilot_chat_short %} to perform the task. + +| Skill | Example prompt | +| --- | --- | +| `create_branch` | Create a new branch called [BRANCH-NAME] in the repository [USERNAME/REPO-NAME]. | +| `create_or_update_file` | Add a new file named `hello-world.md` to my [BRANCH-NAME] of [USERNAME/REPO-NAME] with the content: "Hello, world! This file was created from {% data variables.copilot.copilot_chat_dotcom_short %}!" | +| `push_files` | Push the files `test.md` with the content "This is a test file" and `test-again.md` with the content "This is another test file" to the [BRANCH-NAME] in [USERNAME/REPO-NAME] | +| `update_pull_request_branch`| Update the branch for pull request [PR-number] in [USERNAME/REPO-NAME] with the latest changes from the base branch. | +| `merge_pull_request` | Merge pull request [PR-Number] in [USERNAME/REPO-NAME] | +| `get_me` | Tell me about myself. | +| `search_users` | Search for users with the name "Mona Octocat" | + +For more information about using MCP skills in {% data variables.copilot.copilot_chat_short %}, see [AUTOTITLE](/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server). + {% endwebui %} {% vscode %} diff --git a/data/reusables/copilot/mcp/mcp-ide-preview-note.md b/data/reusables/copilot/mcp/mcp-ide-preview-note.md new file mode 100644 index 000000000000..37daea0d0f93 --- /dev/null +++ b/data/reusables/copilot/mcp/mcp-ide-preview-note.md @@ -0,0 +1,4 @@ +>[!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.