Skip to content

Commit 832c4c8

Browse files
Merge pull request #11371 from MicrosoftDocs/main639174173149276370sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 3a54c9b + 36e3e29 commit 832c4c8

29 files changed

Lines changed: 386 additions & 54 deletions

docs/ide/color-emojis.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: Use color emojis in Visual Studio
3+
description: Learn where Visual Studio shows emojis in full color, including comments, Markdown, Copilot Chat, Output window text, and Solution Explorer items.
4+
ms.date: 06/08/2026
5+
ms.topic: how-to
6+
author: ghogen
7+
ms.author: ghogen
8+
ms.subservice: general-ide
9+
---
10+
11+
# Use color emojis in Visual Studio
12+
13+
Visual Studio renders emojis in full color across common IDE surfaces. You can use emoji markers in comments, Markdown, and collaboration workflows while keeping the same visual meaning when you move between views.
14+
15+
## What color emoji support includes
16+
17+
Emoji characters now render in full color instead of monochrome outlines in supported Visual Studio surfaces. This behavior can make visual markers easier to scan in large files, logs, and tool windows.
18+
19+
## Where you see color emojis
20+
21+
You can use color emojis in the following places:
22+
23+
- Code comments
24+
- Markdown files and Markdown preview
25+
- GitHub Copilot Chat responses and prompts
26+
- Output window text and logs
27+
- Solution Explorer item and file names
28+
29+
## Try it quickly
30+
31+
Use this short check to verify rendering behavior in your environment:
32+
33+
1. Open a code file and add a comment that includes emojis, such as `// TODO ✅`.
34+
1. Open or create a Markdown file and add a line with emojis, such as `Status: 🟢 Ready`.
35+
1. Open **View** > **GitHub Copilot Chat** and submit a prompt that includes emojis.
36+
1. Build a project and review text in the **Output** window.
37+
1. Rename a test file or folder in **Solution Explorer** to include an emoji and confirm color rendering.
38+
39+
To insert emoji characters while you're typing, use the Windows emoji picker by pressing <kbd>Windows</kbd>+<kbd>.</kbd> (period), and then select an emoji.
40+
41+
## Notes and limitations
42+
43+
- Emoji appearance can vary slightly by Windows configuration, installed fonts, and scaling settings.
44+
- In Visual Studio, supported emoji characters are rendered with full color in the UI surfaces listed in this article.
45+
- For more ways to enter emojis and symbols in Windows, see [Emoji, kaomoji, and symbols panel](https://support.microsoft.com/en-us/windows/windows-keyboard-tips-and-tricks-588e0b72-0fff-6d3f-aeee-6e5116097942).
46+
47+
## Related content
48+
49+
- [Markdown preview controls](markdown-preview.md)
50+
- [About GitHub Copilot Chat in Visual Studio](visual-studio-github-copilot-chat.md)
51+
- [Learn about Solution Explorer](use-solution-explorer.md)
52+
- [Output Window](output-window.md)

docs/ide/how-to-customize-menus-and-toolbars-in-visual-studio.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Customize menus and toolbars
33
description: Learn how to customize Visual Studio menus and toolbars, and also learn how to customize any commands included in the menus and toolbars.
4-
ms.date: 01/27/2023
4+
ms.date: 06/10/2026
55
ms.topic: how-to
66
f1_keywords:
77
- vs.renametoolbar

docs/ide/markdown-preview.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@ monikerRange: "visualstudio"
1717

1818
The Visual Studio Markdown editor gives you more control over how you view and edit Markdown files. You can switch between different preview modes to focus on either editing or viewing rendered content, and you can zoom in on Mermaid diagrams to see details in complex visualizations.
1919

20+
For general behavior and supported surfaces, including emoji rendering in full color, see [Use color emojis in Visual Studio](color-emojis.md).
21+
2022
## Preview modes
2123

2224
Visual Studio provides three preview modes for working with Markdown files:

docs/ide/mcp-servers.md

Lines changed: 66 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Use MCP Servers
3-
description: Learn how to add MCP servers in Visual Studio to extend GitHub Copilot agent capabilities, set up mcp.json, and manage tool permissions.
4-
ms.date: 04/29/2026
2+
title: Use MCP Servers to Extend GitHub Copilot
3+
description: Learn how to add MCP servers in Visual Studio, configure mcp.json, and manage tool permissions to extend GitHub Copilot agents. Get started.
4+
ms.date: 05/26/2026
55
ms.update-cycle: 180-days
66
ms.topic: get-started
77
author: RoseHJM
@@ -13,9 +13,9 @@ ai-usage: ai-assisted
1313

1414
---
1515

16-
# Use MCP servers
16+
# Use MCP servers in Visual Studio
1717

18-
Model Context Protocol (MCP) is an open standard that lets GitHub Copilot use tools and services outside the IDE. In Visual Studio, MCP lets GitHub Copilot agents use external tools by connecting MCP clients to MCP servers that expose important functionality like file access, repo management, or PR creation. By standardizing how tools are discovered and invoked, MCP removes the need for custom integrations and makes it easy to extend AI assistants simply by adding new MCP servers.
18+
MCP servers use the open Model Context Protocol (MCP) to let GitHub Copilot use tools and services outside the IDE. In Visual Studio, you can add MCP servers to extend agent capabilities for tasks such as file access, repo management, and pull request creation.
1919

2020
MCP support enhances GitHub Copilot agent mode by allowing you to connect any MCP-compatible server to your agentic coding workflow. MCP support in Visual Studio works as follows:
2121

@@ -57,29 +57,29 @@ Try out some popular MCP servers in Visual Studio with one-click:
5757
- [![Install MongoDB MCP in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install_MongoDB_MCP-purple?style=flat-square&logo=visualstudio&logoColor=white)](https://vs-open.link/mcp-install?%7B%22name%22%3A%22mongodb%22%2C%22gallery%22%3Atrue%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mongodb-mcp-server%22%5D%7D) – Database operations and management. Execute queries, manage collections, aggregation pipelines, and document operations.
5858
- [![Install HuggingFace MCP in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install_HuggingFace_MCP-purple?style=flat-square&logo=visualstudio&logoColor=white)](https://vs-open.link/mcp-install?%7B%22name%22%3A%22huggingface%22%2C%22gallery%22%3Atrue%2C%22url%22%3A%22https%3A%2F%2Fhf.co%2Fmcp%22%7D) – Access models, datasets, and Spaces on the Hugging Face Hub.
5959

60-
### Add an MCP Server from chat
60+
### Add an MCP server from chat
6161

6262
To add an MCP server from chat view:
6363

6464
1. Select the green plus (`+`) button in the tool picker in the chat window.
6565

66-
:::image type="content" source="media/vs-2022/mcp-servers/plus-button-add-mcp.png" alt-text="Screenshot the plus button in tool picker of Visual Studio chat to add MCP server." lightbox="media/vs-2022/mcp-servers/configure-server-visual-studio.png":::
66+
:::image type="content" source="media/vs-2022/mcp-servers/plus-button-add-mcp.png" alt-text="Screenshot of the plus button in the Visual Studio chat tool picker for adding an MCP server." lightbox="media/vs-2022/mcp-servers/configure-server-visual-studio.png":::
6767

6868
1. Specify the server name and connection details, such as the URL for HTTP servers or the command and arguments for stdio servers.
6969

70-
:::image type="content" source="media/vs-2022/mcp-servers/configure-server-visual-studio.png" alt-text="Screenshot that shows adding an MCP server from the chat view." lightbox="media/vs-2022/mcp-servers/configure-server-visual-studio.png":::
70+
:::image type="content" source="media/vs-2022/mcp-servers/configure-server-visual-studio.png" alt-text="Screenshot of the chat view for adding an MCP server in Visual Studio." lightbox="media/vs-2022/mcp-servers/configure-server-visual-studio.png":::
7171

7272
### Add an MCP server from the GitHub MCP server registry
7373

74-
You can install an MCP server directly from the GitHub MCP server registry via Extensions in Visual Studio.
74+
You can install an MCP server directly from the GitHub MCP server registry via **Extensions** in Visual Studio.
7575

7676
1. From the Visual Studio menu, select **Extensions** > **MCP Registries...** to open the **MCP Server Manager**.
7777

78-
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-registry.png" alt-text="Screenshot that shows the Extensions menu for MCP Registries." lightbox="media/vs-2022/mcp-servers/model-context-protocol-registry.png":::
78+
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-registry.png" alt-text="Screenshot of the Extensions menu option for MCP Registries in Visual Studio." lightbox="media/vs-2022/mcp-servers/model-context-protocol-registry.png":::
7979

8080
1. Select the server you want, and then select **Install** for your Visual Studio instance.
8181

82-
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-server-manager.png" alt-text="Screenshot that shows adding an MCP server from the MCP Server Manager." lightbox="media/vs-2022/mcp-servers/model-context-protocol-server-manager.png":::
82+
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-server-manager.png" alt-text="Screenshot of the MCP Server Manager for installing an MCP server." lightbox="media/vs-2022/mcp-servers/model-context-protocol-server-manager.png":::
8383

8484
### Add an MCP server to the `.mcp.json` file
8585

@@ -105,23 +105,23 @@ The following steps walk you through a configuration example with the GitHub MCP
105105
1. In the file, select **Authentication Required** from the CodeLens that appears to authenticate to the server through a GitHub account.
106106
Select **Authenticate** on the pop-up dialog to authenticate with your GitHub account.
107107

108-
:::image type="content" source="media/vs-2022/mcp-servers/codelens-authentication.png" alt-text="Screenshot that shows CodeLens authentication." lightbox="media/vs-2022/mcp-servers/codelens-authentication.png":::
108+
:::image type="content" source="media/vs-2022/mcp-servers/codelens-authentication.png" alt-text="Screenshot of the CodeLens prompt for MCP server authentication." lightbox="media/vs-2022/mcp-servers/codelens-authentication.png":::
109109

110110
If you don't see the CodeLens, ensure it's enabled in **Tools** > **Options** > **Text Editor** > **CodeLens**.
111111

112112
1. At the bottom of the chat panel, select **Agent** from the mode dropdown.
113113

114-
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-dropdown.png" alt-text="Screenshot that shows the Copilot agent mode selector." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-dropdown.png":::
114+
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-dropdown.png" alt-text="Screenshot of the GitHub Copilot agent mode selector in the chat pane." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-dropdown.png":::
115115

116116
1. Select the tools that you want to use, for example, **List issues**.
117117

118-
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-github-tools-list.png" alt-text="Screenshot that shows MCP GitHub tools." lightbox="media/vs-2022/mcp-servers/model-context-protocol-github-tools-list.png":::
118+
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-github-tools-list.png" alt-text="Screenshot of GitHub MCP tools available in the Visual Studio chat pane." lightbox="media/vs-2022/mcp-servers/model-context-protocol-github-tools-list.png":::
119119

120120
Try a sample prompt: **List issues assigned to me on GitHub**.
121121

122122
1. Copilot asks for permission to use a tool that the MCP server made available to it. Select **Allow** with the scope that you want to proceed with.
123123

124-
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png" alt-text="Screenshot that shows confirmation options for agent tools." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png":::
124+
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png" alt-text="Screenshot of confirmation options for GitHub Copilot agent tools." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png":::
125125

126126
## Manage configuration of MCP servers
127127

@@ -157,21 +157,21 @@ It's common to invoke tools through package managers. For example, use `npx -y @
157157

158158
The format must follow the MCP specification. For example, it must include an array of server objects, each with `name`, `command` or `url`, and `transport`.
159159

160-
### Editing MCP configuration
160+
### Edit MCP configuration
161161

162162
If you have an existing `mcp.json` file and you check the file into your version control system, add the file location to **Solution Items** in Solution Explorer.
163163

164164
When you save the file with valid syntax, the GitHub Copilot agent restarts and reloads the configured servers.
165165

166166
:::moniker range="visualstudio"
167167

168-
:::image type="content" source="media/visualstudio/model-context-protocol-add-solution-item.png" alt-text="Screenshot that shows how to add the MCP configuration file location to Solution Items." lightbox="media/visualstudio/model-context-protocol-add-solution-item.png":::
168+
:::image type="content" source="media/visualstudio/model-context-protocol-add-solution-item.png" alt-text="Screenshot of adding the MCP configuration file location to Solution Items." lightbox="media/visualstudio/model-context-protocol-add-solution-item.png":::
169169

170170
:::moniker-end
171171

172172
:::moniker range="<=vs-2022"
173173

174-
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-add-solution-item.png" alt-text="Screenshot that shows adding the MCP configuration file location to Solution Items." lightbox="media/vs-2022/mcp-servers/model-context-protocol-add-solution-item.png":::
174+
:::image type="content" source="media/vs-2022/mcp-servers/model-context-protocol-add-solution-item.png" alt-text="Screenshot of the MCP configuration file location added to Solution Items." lightbox="media/vs-2022/mcp-servers/model-context-protocol-add-solution-item.png":::
175175

176176
:::moniker-end
177177

@@ -186,39 +186,82 @@ As soon as Visual Studio discovers or adds a server:
186186
- If you remove a server, Visual Studio immediately stops its process and withdraws all its tools from the UI.
187187
- If you edit a server definition, Visual Studio terminates and restarts it, and then re-queries.
188188

189-
### Management of tool approvals
189+
:::moniker range="visualstudio"
190+
191+
## MCP server trust dialog
192+
193+
> [!NOTE]
194+
> MCP server trust is available in Visual Studio 2026 version 18.7 and later.
195+
196+
Visual Studio asks you to trust an MCP server again when the server has changed since the last time you used it. This prompt helps you decide whether to run the updated server.
197+
198+
### What to do when you're prompted
199+
200+
When the trust dialog appears, review the change and choose the action that matches your intent:
201+
202+
- **Accept** to run this updated version now.
203+
- **Always Trust** to stop future trust prompts for this server.
204+
- **Reject** to stop startup because you don't want to run the updated server.
205+
206+
If you choose **Reject**, Visual Studio doesn't start the server and asks again the next time you try to activate it.
207+
208+
### When you'll see the trust dialog
209+
210+
You'll be prompted when Visual Studio detects changes to either of these:
211+
212+
- Server configuration details, such as transport type, URL, command, or arguments.
213+
- Server capabilities, such as tools, prompts, resources, resource templates, or instructions.
214+
215+
### When you won't see the trust dialog
216+
217+
Visual Studio skips the prompt when:
218+
219+
- The server is built in and shipped with the extension.
220+
- Organization policy is set to `RegistryOnly`.
221+
- You already selected **Always Trust** for that server.
222+
- It's the first time the server is seen. Visual Studio saves an initial trust baseline automatically.
223+
224+
### Turn trust prompts on or off for updated MCP servers
225+
226+
To control whether Visual Studio prompts before running tools from an updated MCP server, go to **Tools** > **Options** > **GitHub** > **Copilot** and in **Copilot Chat** select or clear **Show trust dialog before running tools from an updated MCP server**.
227+
228+
If you don't see this setting, update to Visual Studio 2026 version 18.7 or later.
229+
230+
:::moniker-end
231+
232+
## Management of tool approvals
190233

191234
When you invoke a tool, Copilot requests confirmation to run the tool. The reason is that tools might run locally on your machine and perform actions that modify files or data.
192235

193236
:::moniker range="visualstudio"
194237

195238
After a tool invocation, on the chat pane, use the **Confirm** dropdown options. You can automatically confirm the specific tool for the current session, the current solution, or all future invocations.
196239

197-
:::image type="content" source="media/visualstudio/copilot-agent-tool-approval.png" alt-text="Screenshot that shows how to manage agent tool approvals." lightbox="media/visualstudio/copilot-agent-tool-approval.png":::
240+
:::image type="content" source="media/visualstudio/copilot-agent-tool-approval.png" alt-text="Screenshot of the chat pane options for managing agent tool approvals." lightbox="media/visualstudio/copilot-agent-tool-approval.png":::
198241

199242
:::moniker-end
200243

201244
:::moniker range="<=vs-2022"
202245

203246
After a tool invocation, on the chat pane, use the **Allow** dropdown options. You can automatically confirm the specific tool for the current session, the current solution, or all future invocations.
204247

205-
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png" alt-text="Screenshot that shows managing agent tool approvals." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png":::
248+
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png" alt-text="Screenshot of agent tool approval options in the Visual Studio chat pane." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-tool-approval.png":::
206249

207250
:::moniker-end
208251

209252
:::moniker range="visualstudio"
210253

211254
You can reset tool confirmation selections in the **Tools** > **Options** dialog, in the **All Settings** > **GitHub** > **Copilot** > **Tools** section.
212255

213-
:::image type="content" source="media/visualstudio/copilot-agent-tool-config.png" alt-text="Screenshot that shows Copilot tool configuration settings." lightbox="media/visualstudio/copilot-agent-tool-config.png":::
256+
:::image type="content" source="media/visualstudio/copilot-agent-tool-config.png" alt-text="Screenshot of GitHub Copilot tool configuration settings in Visual Studio." lightbox="media/visualstudio/copilot-agent-tool-config.png":::
214257

215258
:::moniker-end
216259

217260
:::moniker range="<=vs-2022"
218261

219262
You can reset tool confirmation selections in the **Tools** > **Options** dialog, under the **GitHub** > **Copilot** section in the **Tools** group.
220263

221-
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-tool-config.png" alt-text="Screenshot that shows tool configuration settings." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-tool-config.png":::
264+
:::image type="content" source="media/vs-2022/copilot-agent-mode/copilot-agent-tool-config.png" alt-text="Screenshot of tool configuration settings for GitHub Copilot in Visual Studio." lightbox="media/vs-2022/copilot-agent-mode/copilot-agent-tool-config.png":::
222265

223266
:::moniker-end
224267

docs/ide/output-window.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@ Turns the Word Wrap feature on and off in the **Output** pane. When Word Wrap is
5252

5353
The **Output** pane selected in the **Show output from** list displays output from the source indicated.
5454

55+
Emoji characters in Output text render in full color. For more information about emoji behavior across Visual Studio surfaces, see [Use color emojis in Visual Studio](color-emojis.md).
56+
5557
## Route messages to the Output window
5658

5759
To display the **Output** window whenever you build a project, in the **Options** dialog box, on the **Projects and Solutions** > **General** page, select **Show Output window when build starts**. Then, with a code file open for editing, choose **Go to Next Message** and **Go To Previous Message** on the **Output** window toolbar to select entries in the **Output** pane. As you do this, the insertion point in the code editor jumps to the line of code where the selected problem occurs.

0 commit comments

Comments
 (0)