Merge pull request #22536 from unoplatform/dev/mara/vs-mcp-workaround

Author: agneszitte

doc/articles/Assets/vs-mcp-reconnect.png

@@ -10,6 +10,24 @@ The getting started for Claude, Codex and Copilot CLI use the `dnx` command, whi
 
 If you want to use the App MCP with .NET 9 projects, you'll need to change `dnx` to `uno-devserver` and install it using `dotnet tool install -g uno.devserver`.
 
+## The App MCP does not appear in Visual Studio
+
+1. Open the `.vs/mcp.json` file in Visual Studio. It is located in your solution's root directory.
+2. Verify that the Uno MCP server entry is present:
+
+```json
+"uno": {
+  "url": "https://mcp.platform.uno/v1"
+}
+```
+
+3. If the entry is missing, add it to the `.vs/mcp.json` file and restart Visual Studio.
+4. If the entry exists but the server shows as disconnected, click on "Reconnect" in the file editor:
+
+![Visual Studio MCP reconnect in mcp.json](Assets/vs-mcp-reconnect.png)
+
+The Uno App MCP should now appear in the list of MCPs in Visual Studio.
+
 ## The App MCP turns red in Visual Studio 2022/2026
 
 In Visual Studio, the App MCP might turn red in some occasions. To fix this issue, click on the three dots on the right and select `Reload`.

doc/articles/common-issues-ai-agents.md

@@ -55,6 +55,8 @@ In your agent, there are some phrases that can be used to nudge the agent to use
 > Your agent will execute tools from our MCPs, you will need to approve them at your convenience.
 > [!NOTE]
 > In Visual Studio 2022/2026 MCPs might not be enabled automatically. Make sure to [click the "tools" icon](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022#configuration-example-with-a-github-mcp-server) in the chat window to check both Uno Platform MCPs.
+>
+> If the Uno App MCP is missing, see [how to make the App MCP appear in Visual Studio](xref:Uno.UI.CommonIssues.AIAgents#the-app-mcp-does-not-appear-in-visual-studio).
 
 - To ask the agent to explain what MVUX is:
 

doc/articles/explore-your-app-ai-agents.md

@@ -51,6 +51,9 @@ This MCP is running locally and provides agents with the ability to interact wit
 
 These tools give "eyes" and "hands" to Agents in order to validate their assumptions regarding the actions they take, and the code they generate.
 
+> [!NOTE]
+> If using Visual Studio 2022/2026, sometimes the Uno App MCP does not appear in the Visual Studio tools list. See [how to make the App MCP appear in Visual Studio](xref:Uno.UI.CommonIssues.AIAgents#the-app-mcp-does-not-appear-in-visual-studio).
+
 ### App MCP Tools
 
 The Community license MCP app tools are:

doc/articles/features/using-the-uno-mcps.md

@@ -10,6 +10,9 @@ To upgrade to the latest version of Uno Platform, [follow our guide](xref:Uno.De
 
 Uno Platform 6.5 does not contain breaking changes that require attention when upgrading
 
+> [!NOTE]
+> Uno App MCP: if using Visual Studio 2022/2026, sometimes the Uno App MCP does not appear in the Visual Studio tools list. See [how to make the App MCP appear in Visual Studio](xref:Uno.UI.CommonIssues.AIAgents#the-app-mcp-does-not-appear-in-visual-studio).
+
 ## Uno Platform 6.4
 
 Uno Platform 6.4 contains an Uno.Extensions breaking changes that require attention when upgrading: