diff --git a/assets/images/help/copilot/coding-agent/agents-page-input.png b/assets/images/help/copilot/coding-agent/agents-page-input.png new file mode 100644 index 000000000000..20a495eba573 Binary files /dev/null and b/assets/images/help/copilot/coding-agent/agents-page-input.png differ diff --git a/assets/images/help/copilot/coding-agent/agents-page.png b/assets/images/help/copilot/coding-agent/agents-page.png new file mode 100644 index 000000000000..f0ae04cc9b2a Binary files /dev/null and b/assets/images/help/copilot/coding-agent/agents-page.png differ diff --git a/content/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot.md b/content/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot.md index 1bd3c14fae1f..7da8219e9d25 100644 --- a/content/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot.md +++ b/content/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot.md @@ -86,6 +86,8 @@ Each model has a premium request multiplier, based on its complexity and resourc If you use **{% data variables.copilot.copilot_free_short %}**, you have access to a limited number of models, and each model will consume one premium request when used. For example, if you make a request using the {% data variables.copilot.copilot_o3_mini %} model, your interaction will consume **one premium request**, not 0.33 premium requests. +{% rowheaders %} + | Model | Multiplier for **paid plans** | Multiplier for **{% data variables.copilot.copilot_free_short %}** | |-------------------------------------------------------------------------|--------------------------------|-----------------------| | {% data variables.copilot.copilot_gpt_41 %} | 0 | 1 | @@ -103,6 +105,8 @@ If you use **{% data variables.copilot.copilot_free_short %}**, you have access | {% data variables.copilot.copilot_o3_mini %} | 0.33 | 1 | | {% data variables.copilot.copilot_o4_mini %} | 0.33 | Not applicable | +{% endrowheaders %} + ## Examples of premium request usage Premium request usage is based on the model’s multiplier and the feature you’re using. For example: diff --git a/content/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request.md b/content/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request.md index f3e095eb0df3..3ea1ead889b7 100644 --- a/content/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request.md +++ b/content/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request.md @@ -1,7 +1,7 @@ --- title: Asking Copilot to create a pull request shortTitle: Create a PR from chat -intro: 'You can use a {% data variables.copilot.copilot_chat_short %} prompt to ask {% data variables.product.prodname_copilot_short %} to create a pull request.' +intro: 'You can ask {% data variables.product.prodname_copilot_short %} to create a pull request from the Agents page or from {% data variables.copilot.copilot_chat_short %}.' product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot @@ -15,20 +15,37 @@ redirect_from: --- > [!NOTE] -> * If you have access to {% data variables.copilot.copilot_coding_agent %}, you can create a pull request from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, and on {% data variables.product.prodname_dotcom_the_website %}. > * {% data reusables.copilot.coding-agent.preview-note-text %} ## Introduction -Often, when you are working on a project, you might notice a change you want to make, but the change doesn't directly relate to your current task. You might raise a {% data variables.product.github %} issue to record that a change needs to be made—or perhaps, forget the change and move on. +You can ask {% data variables.product.prodname_copilot_short %} to work on a task from the Agents page on {% data variables.product.github %}, or from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs and {% data variables.product.prodname_dotcom_the_website %}. -Instead—if {% data variables.copilot.copilot_coding_agent %} is available—you can ask {% data variables.product.prodname_copilot_short %} to make the change for you. {% data variables.product.prodname_copilot_short %} will start working on the change in the background and, when it's done, request you to review the pull request it raises. +{% data variables.product.prodname_copilot_short %} will start working on the task, raise a pull request, then request a review from you when it's finished working. For more information, see [AUTOTITLE](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot). -For information on making {% data variables.copilot.copilot_coding_agent %} available, see [AUTOTITLE](/copilot/using-github-copilot/coding-agent/enabling-copilot-coding-agent). +## Asking {% data variables.product.prodname_copilot_short %} to create a pull request from the Agents page -## Creating a pull request from {% data variables.copilot.copilot_chat_short %} +1. Navigate to the Agents page at [github.com/copilot/agents](https://github.com/copilot/agents). -1. Open {% data variables.copilot.copilot_chat %}, in your IDE, or while viewing a file on {% data variables.product.prodname_dotcom_the_website %}. + You can also reach this page by clicking the **{% octicon "copilot" aria-label="Copilot icon" %}** button next to the search bar on any page on {% data variables.product.github %}, then selecting **Agents** from the sidebar. + +1. Using the dropdown menu in the prompt field, select the repository you want {% data variables.product.prodname_copilot_short %} to work in. +1. Type a prompt describing your request. + + For example, `Implement a user friendly message for common errors.` + + ![Screenshot of asking Copilot to create a pull request from the Agents page.](/assets/images/help/copilot/coding-agent/agents-page-input.png) + +1. Click the **Send now** button or press Return. + + {% data variables.product.prodname_copilot_short %} will start a new session, which will appear in the list below the prompt box. {% data variables.product.prodname_copilot_short %} will work on the task and push changes to its pull request, 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 {% data variables.copilot.copilot_chat_short %} + +> [!NOTE] +> * You can ask {% data variables.product.prodname_copilot_short %} to create a pull request from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, and on {% data variables.product.prodname_dotcom_the_website %}. + +1. Open {% data variables.copilot.copilot_chat %}, in your IDE or on {% data variables.product.prodname_dotcom_the_website %}. 1. Type a prompt asking {% data variables.product.prodname_copilot_short %} to create a pull request, and giving details of what you want {% data variables.product.prodname_copilot_short %} to change. For example, `@github Create a PR to put backticks around file names and variables in output.` @@ -36,22 +53,21 @@ For information on making {% data variables.copilot.copilot_coding_agent %} avai > [!IMPORTANT] > {% data reusables.copilot.coding-agent.use-chat-participant-in-vsc %} - > [!TIP] - > To help {% data variables.product.prodname_copilot_short %}, you can select the relevant line(s) of code before submitting your prompt. - 1. Submit your prompt. {% data variables.product.prodname_copilot_short %} asks you to confirm that you want to use the coding agent to create a pull request. 1. Click **Allow**. - {% data variables.product.prodname_copilot_short %} will 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. + {% 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. ## Monitoring progress -You can see what {% data variables.product.prodname_copilot_short %} is doing while it is working on a task by viewing the session logs. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs). +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). + +You can see what {% data variables.product.prodname_copilot_short %} is doing while it is working on a task by viewing the session logs. You can access the session logs by clicking the **View session** button in the timeline of {% data variables.product.prodname_copilot_short %}'s pull request. -You can also stop {% data variables.product.prodname_copilot_short %} from working on a task by clicking **Stop session** in the session logs. +From the session logs page, you can also stop {% data variables.product.prodname_copilot_short %} from working on a task by clicking **Stop session**. ## Further reading diff --git a/content/copilot/how-tos/agents/copilot-coding-agent/index.md b/content/copilot/how-tos/agents/copilot-coding-agent/index.md index 4b29b9ae11b1..81bd6b56ea38 100644 --- a/content/copilot/how-tos/agents/copilot-coding-agent/index.md +++ b/content/copilot/how-tos/agents/copilot-coding-agent/index.md @@ -8,10 +8,10 @@ topics: children: - /best-practices-for-using-copilot-to-work-on-tasks - /enabling-copilot-coding-agent - - /using-copilot-to-work-on-an-issue - /asking-copilot-to-create-a-pull-request + - /using-copilot-to-work-on-an-issue + - /tracking-copilots-sessions - /reviewing-a-pull-request-created-by-copilot - - /using-the-copilot-coding-agent-logs - /extending-copilot-coding-agent-with-mcp - /customizing-the-development-environment-for-copilot-coding-agent - /customizing-or-disabling-the-firewall-for-copilot-coding-agent diff --git a/content/copilot/how-tos/agents/copilot-coding-agent/using-the-copilot-coding-agent-logs.md b/content/copilot/how-tos/agents/copilot-coding-agent/tracking-copilots-sessions.md similarity index 60% rename from content/copilot/how-tos/agents/copilot-coding-agent/using-the-copilot-coding-agent-logs.md rename to content/copilot/how-tos/agents/copilot-coding-agent/tracking-copilots-sessions.md index 7f92200cf541..11d314f89aa3 100644 --- a/content/copilot/how-tos/agents/copilot-coding-agent/using-the-copilot-coding-agent-logs.md +++ b/content/copilot/how-tos/agents/copilot-coding-agent/tracking-copilots-sessions.md @@ -1,7 +1,7 @@ --- -title: Using the Copilot coding agent logs -shortTitle: Use the Copilot logs -intro: "You can use the session logs to understand {% data variables.product.prodname_copilot_short %}'s approach." +title: Tracking Copilot's sessions +shortTitle: Track Copilot sessions +intro: "You can use the Agents page and session logs to track {% data variables.product.prodname_copilot_short %}'s progress and understand its approach." product: '{% data reusables.gated-features.copilot-coding-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' versions: feature: copilot @@ -11,18 +11,35 @@ type: how_to redirect_from: - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/using-the-copilot-coding-agent-logs - /copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs + - /copilot/how-tos/agents/copilot-coding-agent/using-the-copilot-coding-agent-logs --- {% data reusables.copilot.coding-agent.preview-note %} ## Introduction -After you assign an issue to {% data variables.product.prodname_copilot_short %}, or use {% data variables.copilot.copilot_chat_short %} to ask {% data variables.product.prodname_copilot_short %} to create a pull request, {% data variables.product.prodname_copilot_short %} works autonomously to complete the task. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot). +After you give {% data variables.product.prodname_copilot_short %} a task, it works autonomously in the background to complete it. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot). + +The [Agents page](https://github.com/copilot/agents) provides an overview of your agent sessions across repositories. From this page, you can kick off new tasks and track {% data variables.product.prodname_copilot_short %}'s progress. During or after an agent session, you can inspect the session logs to understand {% data variables.product.prodname_copilot_short %}'s approach to your problem. +## Tracking agent sessions from the Agents page + +You can see a list of your running and past agent sessions on the Agents page at [github.com/copilot/agents](https://github.com/copilot/agents). + +You can also reach this page by clicking the **{% octicon "copilot" aria-label="Copilot icon" %}** button next to the search bar on any page on {% data variables.product.github %}, then selecting **Agents** from the sidebar. + +![Screenshot of the Agents page with several sessions, including one currently in progress.](/assets/images/help/copilot/coding-agent/agents-page.png) + +For each session listed below the prompt field, you can see its status at a glance, or click on it to navigate to the linked pull request. + +You can also start new agent sessions from this page. See [AUTOTITLE](/copilot/how-tos/agents/copilot-coding-agent/asking-copilot-to-create-a-pull-request). + ## Using the session logs to understand {% data variables.product.prodname_copilot_short %}'s approach +You can dive into {% data variables.product.prodname_copilot_short %}'s session logs to understand how it approached your task. + To view the session logs, click **View session** in the pull request timeline. ![Screenshot of a section of a pull request with the 'View session' button highlighted.](/assets/images/help/copilot/coding-agent/log-view-session.png) diff --git a/content/copilot/how-tos/agents/copilot-coding-agent/using-copilot-to-work-on-an-issue.md b/content/copilot/how-tos/agents/copilot-coding-agent/using-copilot-to-work-on-an-issue.md index 7e887e00f391..da8425d7e82a 100644 --- a/content/copilot/how-tos/agents/copilot-coding-agent/using-copilot-to-work-on-an-issue.md +++ b/content/copilot/how-tos/agents/copilot-coding-agent/using-copilot-to-work-on-an-issue.md @@ -132,6 +132,8 @@ A few seconds later, {% data variables.product.prodname_copilot_short %} will op {% data variables.product.prodname_copilot_short %} will start an **agent session** to work on your issue. A "{% data variables.product.prodname_copilot_short %} started work" event will appear in the pull request timeline, and as {% data variables.product.prodname_copilot_short %} works, it will update the pull request body with regular status updates, and push commits to the branch. +All of your sessions, past and present, can be seen and tracked from the [Agents page](https://github.com/copilot/agents). See [AUTOTITLE](/copilot/how-tos/agents/copilot-coding-agent/tracking-copilots-sessions). + ![Screenshot of a pull request with a series of timeline events, including "Copilot started work."](/assets/images/help/copilot/coding-agent/copilot-started-work.png) If you want to check what {% data variables.product.prodname_copilot_short %} is doing, click **View session**. The session log viewer is displayed, showing you a live log as {% data variables.product.prodname_copilot_short %} works on the issue. If you want to stop {% data variables.product.prodname_copilot_short %} from working on the issue, click **Stop session**. See [AUTOTITLE](/copilot/using-github-copilot/coding-agent/using-the-copilot-coding-agent-logs). diff --git a/content/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server.md b/content/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server.md index ea40e4a34f17..f9088e9eb737 100644 --- a/content/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server.md +++ b/content/copilot/how-tos/context/model-context-protocol/using-the-github-mcp-server.md @@ -14,8 +14,15 @@ redirect_from: >[!NOTE] > The {% data variables.product.github %} MCP server is currently in {% data variables.release-phases.public_preview %} and subject to change. +{% vscode %} + {% data reusables.copilot.mcp.about-github-mcp-server %} +## Prerequisites + +* A {% data variables.product.github %} account. +* {% data variables.product.prodname_vscode %}, or another MCP-compatible editor. + ## Setting up the {% data variables.product.github %} MCP server in {% data variables.product.prodname_vscode %} The instructions below guide you through setting up the {% data variables.product.github %} MCP server in {% data variables.product.prodname_vscode %}. Other MCP-compatible editors may have similar steps, but the exact process may vary. @@ -187,13 +194,201 @@ The {% data variables.product.github %} MCP server enables you to perform a wide {% data reusables.copilot.open-chat-vs-code %} {% data reusables.copilot.select-agent %} 1. To see the available actions, in the {% data variables.copilot.copilot_chat_short %} box, click the **Select tools** icon. - * In the **Tools** dropdown, under **MCP Server:{% data variables.product.github %}**, you will see a list of available actions. + * In the **Tools** dropdown, under **MCP Server: {% data variables.product.github %}**, you will see a list of available actions. +1. In the {% data variables.copilot.copilot_chat_short %} box, type a command or question related to the action you want to perform, and press **Enter**. + * For example, you can ask the {% data variables.product.github %} MCP server to create a new issue, list pull requests, or retrieve repository information. +1. The {% data variables.product.github %} MCP server will process your request and provide a response in the chat interface. + * 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. + +{% endvscode %} + +{% jetbrains %} + +{% data reusables.copilot.mcp.about-github-mcp-server %} + +## Prerequisites + +* **Access to {% data variables.product.prodname_copilot_short %}**. {% data reusables.copilot.subscription-prerequisite %} +* **A compatible JetBrains IDE**. {% data variables.product.prodname_copilot %} is compatible with the following IDEs: + + {% data reusables.copilot.jetbrains-compatible-ides %} +{% data reusables.copilot.jetbrains-plugin-prerequisites %} + +## 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. + +> [!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 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: + + ```json copy + { + "servers": { + "github": { + "url": "https://api.githubcopilot.com/mcp/", + "requestInit": { + "headers": { + "Authorization": "Bearer YOUR_GITHUB_PAT" + } + } + } + } + } + ``` + +## Using the {% data variables.product.github %} MCP server in JetBrains IDEs + +The {% data variables.product.github %} MCP server enables you to perform a wide range of actions on {% data variables.product.github %}, via {% data variables.copilot.copilot_chat_short %} in JetBrains IDEs. + +1. Open the {% data variables.copilot.copilot_chat_short %} window by clicking the **{% data variables.copilot.copilot_chat %}** icon at the right side of the JetBrains IDE window. + + ![Screenshot of the {% data variables.copilot.copilot_chat %} icon in the Activity Bar.](/assets/images/help/copilot/jetbrains-copilot-chat-icon.png) +1. At the top of the chat panel, click the **Agent** tab. +1. To see the available actions, in the {% data variables.copilot.copilot_chat_short %} box, click the tools icon. + * Under **MCP Server: {% data variables.product.github %}**, you will see a list of available actions. 1. In the {% data variables.copilot.copilot_chat_short %} box, type a command or question related to the action you want to perform, and press **Enter**. * For example, you can ask the {% data variables.product.github %} MCP server to create a new issue, list pull requests, or retrieve repository information. 1. The {% data variables.product.github %} MCP server will process your request and provide a response in the chat interface. * 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. +{% endjetbrains %} + +{% xcode %} + +{% data reusables.copilot.mcp.about-github-mcp-server %} + +## Prerequisites + +* **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). + +## 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. + +> [!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 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". +1. Add the following configuration, replacing `YOUR_GITHUB_PAT` with the PAT you created: + +```json copy + { + "servers": { + "github": { + "url": "https://api.githubcopilot.com/mcp/", + "requestInit": { + "headers": { + "Authorization": "Bearer YOUR_GITHUB_PAT" + } + } + } + } + } +``` + +## Using the {% data variables.product.github %} MCP server in Xcode + +The {% data variables.product.github %} MCP server enables you to perform a wide range of actions on {% data variables.product.github %}, via {% data variables.copilot.copilot_chat_short %} in Xcode. + +1. To open the chat view, click **Editor** in the menu bar, then click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}** then **Open Chat**. {% data variables.copilot.copilot_chat_short %} opens in a new window. +1. At the bottom of the chat panel, select **Agent**. +1. To see the available actions, in the {% data variables.copilot.copilot_chat_short %} box, click the tools icon. + * Under **MCP Server: {% data variables.product.github %}**, you will see a list of available actions. +1. In the {% data variables.copilot.copilot_chat_short %} box, type a command or question related to the action you want to perform, and press **Enter**. + * For example, you can ask the {% data variables.product.github %} MCP server to create a new issue, list pull requests, or retrieve repository information. +1. The {% data variables.product.github %} MCP server will process your request and provide a response in the chat interface. + * 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. + +{% endxcode %} + +{% eclipse %} + +{% data reusables.copilot.mcp.about-github-mcp-server %} + +## Prerequisites + +{% data reusables.copilot.eclipse-prerequisites %} +* **Latest version of the {% data variables.product.prodname_copilot %} extension**. Download this from the [Eclipse Marketplace](https://aka.ms/copiloteclipse). For more information, see [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/installing-the-github-copilot-extension-in-your-environment?tool=eclipse). +* **Sign in to {% data variables.product.company_short %} from Eclipse**. + +## Setting up the {% data variables.product.github %} MCP server in Eclipse + +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. + +> [!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 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: + + ```json copy + { + "servers": { + "github": { + "url": "https://api.githubcopilot.com/mcp/", + "requestInit": { + "headers": { + "Authorization": "Bearer YOUR_GITHUB_PAT" + } + } + } + } + } + ``` + +## Using the {% data variables.product.github %} MCP server in Eclipse + +The {% data variables.product.github %} MCP server enables you to perform a wide range of actions on {% data variables.product.github %}, via {% data variables.copilot.copilot_chat_short %} 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, then click **Open Chat**. +1. At the bottom of the chat panel, select **Agent** from the mode dropdown. +1. To see the available actions, in the {% data variables.copilot.copilot_chat_short %} box, click the tools icon. + * Under `github`, you will see a list of available actions. +1. In the {% data variables.copilot.copilot_chat_short %} box, type a command or question related to the action you want to perform, and press **Enter**. + * For example, you can ask the {% data variables.product.github %} MCP server to create a new issue, list pull requests, or retrieve repository information. +1. The {% data variables.product.github %} MCP server will process your request and provide a response in the chat interface. + * 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. + +{% endeclipse %} + {% data reusables.copilot.mcp.troubleshooting-mcp-server %} ## Further reading diff --git a/content/repositories/releasing-projects-on-github/about-releases.md b/content/repositories/releasing-projects-on-github/about-releases.md index 047ed11b7b6b..a0cd02116c94 100644 --- a/content/repositories/releasing-projects-on-github/about-releases.md +++ b/content/repositories/releasing-projects-on-github/about-releases.md @@ -46,6 +46,6 @@ You can also use the Releases API to gather information, such as the number of t ## Storage and bandwidth quotas - Each file included in a release must be under {% data variables.large_files.max_file_size %}. There is no limit on the total size of a release, nor bandwidth usage. +Up to {% data variables.releases.release_asset_limit %} release assets may be associated with a single release. Each file included in a release must be under {% data variables.large_files.max_file_size %}. There is no limit on the total size of a release, nor bandwidth usage. {% endif %} diff --git a/data/reusables/actions/supported-shells.md b/data/reusables/actions/supported-shells.md index 8189709701e4..446fcf22109d 100644 --- a/data/reusables/actions/supported-shells.md +++ b/data/reusables/actions/supported-shells.md @@ -1,3 +1,4 @@ + | Supported platform | `shell` parameter | Description | Command run internally | | ------------------ | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | | Linux / macOS | unspecified | The default shell on non-Windows platforms. Note that this runs a different command to when `bash` is specified explicitly. If `bash` is not found in the path, this is treated as `sh`. | `bash -e {0}` | diff --git a/data/reusables/copilot/mcp/about-github-mcp-server.md b/data/reusables/copilot/mcp/about-github-mcp-server.md index d6a7d2632efa..02f2aef8f777 100644 --- a/data/reusables/copilot/mcp/about-github-mcp-server.md +++ b/data/reusables/copilot/mcp/about-github-mcp-server.md @@ -20,11 +20,6 @@ Running the {% data variables.product.github %} MCP server locally requires a bi There is currently broad support for local MCP servers in clients such as {% data variables.product.prodname_vscode %}, JetBrains IDEs, XCode, and others. -Support for remote MCP servers is growing, with editors like {% data variables.product.prodname_vscode %} (with OAuth or PAT), {% data variables.product.prodname_vs %} (PAT only), Windsurf (PAT only), and Cursor (PAT only) already providing this functionality. +Support for remote MCP servers is growing, with editors like {% data variables.product.prodname_vscode %} (with OAuth or PAT), {% data variables.product.prodname_vs %} (PAT only), JetBrains IDEs (PAT only), Xcode (PAT only), Eclipse (PAT only), Windsurf (PAT only), and Cursor (PAT only) already providing this functionality. To find out if your preferred editor supports remote MCP servers, check the documentation for your specific editor. - -## Prerequisites - -* A {% data variables.product.github %} account. -* {% data variables.product.prodname_vscode %}, or another MCP-compatible editor. diff --git a/data/reusables/copilot/mcp/troubleshooting-mcp-server.md b/data/reusables/copilot/mcp/troubleshooting-mcp-server.md index d2babb3b521c..f14ef8ee56cc 100644 --- a/data/reusables/copilot/mcp/troubleshooting-mcp-server.md +++ b/data/reusables/copilot/mcp/troubleshooting-mcp-server.md @@ -10,13 +10,13 @@ If you are having trouble authorizing the MCP server, ensure that: If you are authenticating with a {% data variables.product.pat_generic %} (PAT), ensure that: * Your GitHub PAT is valid and has the necessary scopes for the actions you want to perform. -* You have entered the correct PAT when prompted in {% data variables.product.prodname_vscode %}. +* You have entered the correct PAT. ### Copilot agent mode problems If you are having trouble with the {% data variables.copilot.copilot_chat_short %} agent mode, ensure that: * You have selected the correct agent in the {% data variables.copilot.copilot_chat_short %} box. -* You have configured the MCP server correctly in {% data variables.product.prodname_vscode %}. +* You have configured the MCP server correctly in your IDE. * You have the necessary permissions to perform the actions you are trying to execute. ### General tips diff --git a/data/variables/releases.yml b/data/variables/releases.yml new file mode 100644 index 000000000000..847545e27be5 --- /dev/null +++ b/data/variables/releases.yml @@ -0,0 +1 @@ +release_asset_limit: '1000'