From 21f3e93409710586b0df73a1d27ec0f5809ee3cc Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Mon, 21 Jul 2025 14:20:35 +0300 Subject: [PATCH 1/4] docs(AI): Revamp VS Code MCP information --- ai/mcp-server.md | 32 +++++++++----------------------- 1 file changed, 9 insertions(+), 23 deletions(-) diff --git a/ai/mcp-server.md b/ai/mcp-server.md index 19da38ca0..ea8e707d6 100644 --- a/ai/mcp-server.md +++ b/ai/mcp-server.md @@ -44,11 +44,11 @@ You also need to add your [Telerik licence key](slug:installation-license-key) a For detailed instructions, refer to [Use MCP servers in Visual Studio](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers). -> Visual Studio 17.14 seems to require the Copilot Chat window to be open and active when you open a solution. Otherwise the Telerik MCP server is not used. +> Older Visual Studio versions seem to require the Copilot Chat window to be open and active when you open a solution. Otherwise the Telerik MCP server is not used. To enable the Telerik MCP Server in a specific Blazor app, add a `.mcp.json` file to the solution folder. -> caption .mcp.json +>caption .mcp.json ````JSON.skip-repl { @@ -73,9 +73,9 @@ To enable global automatic discovery of the Telerik MCP Server in Visual Studio, For detailed instructions, refer to [Use MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers). -To enable the Telerik MCP Server in a specific workspace or Blazor app, add a `.vscode` folder with an `mcp.json` file at the root of the workspace: +To enable the Telerik MCP Server in a specific [workspace](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-workspace), Blazor app, or [globally](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-user-configuration), add a `.vscode` folder with an `mcp.json` file at the root of the workspace, app, or your user folder, respectively. ->caption .vscode/mcp.json at the workspace root +>caption .vscode/mcp.json ````JSON.skip-repl { @@ -92,34 +92,22 @@ To enable the Telerik MCP Server in a specific workspace or Blazor app, add a `. } ```` -To [add the Telerik MCP Server globally for VS Code, edit the VS Code `settings.json` file](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-user-settings): +To use the Telerik MCP server in all workspaces and apps, make sure that [`chat.mcp.discovery.enabled`](vscode://settings/chat.mcp.discovery.enabled) is enabled in [`settings.json`](https://code.visualstudio.com/docs/configure/settings#_settings-json-file). >caption VS Code settings.json ````JSON.skip-repl { - // ... - "chat.mcp.discovery.enabled": true, - "mcp": { - "servers": { - "telerikBlazorAssistant": { - "type": "stdio", - "command": "npx", - "args": ["-y", "@progress/telerik-blazor-mcp@latest"], - "env": { - "TELERIK_LICENSE_PATH": "C:\\Users\\___\\AppData\\Roaming\\Telerik\\telerik-license.txt" - } - } - } - } + // ... + "chat.mcp.discovery.enabled": true, } ```` ### Cursor -For detailed instructions, refer to [Model Context Protocol](https://docs.cursor.com/context/model-context-protocol). +For detailed instructions, refer to [Model Context Protocol](https://docs.cursor.com/context/mcp). -To [enable the Telerik MCP Server in a specific workspace](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-workspace) or Blazor app, add a `.cursor` folder with an `mcp.json` file at the root of the workspace. +To [enable the Telerik MCP Server in a specific workspace, Blazor app, or globally](https://docs.cursor.com/context/mcp#using-mcp-json), add a `.cursor` folder with an `mcp.json` file at the root of the workspace, app, or your user folder, respectively. >caption .cursor/mcp.json @@ -138,8 +126,6 @@ To [enable the Telerik MCP Server in a specific workspace](https://code.visualst } ```` -To [add the Telerik MCP Server globally for Cursor](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-user-settings), add a `.cursor` folder with the above `mcp.json` file in your user folder. - ## Usage To use the Telerik MCP Server: From 108ec53ad45c5b642d3335c5f661d1b9780ddb88 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Tue, 22 Jul 2025 16:34:37 +0300 Subject: [PATCH 2/4] continued --- ai/mcp-server.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/ai/mcp-server.md b/ai/mcp-server.md index 66e1a59aa..f556eabd3 100644 --- a/ai/mcp-server.md +++ b/ai/mcp-server.md @@ -17,7 +17,7 @@ The Telerik Blazor [MCP Server](https://modelcontextprotocol.io/introduction) le To use the Telerik Blazor MCP server, you need: * [Node.js](https://nodejs.org/en) 18 or a newer version. -* A [compatible MCP client (IDE, code editor or app)](https://modelcontextprotocol.io/clients) that supports *MCP tools*. Using the latest version of the MCP client is recommended. +* A [compatible MCP client (IDE, code editor or app)](https://modelcontextprotocol.io/clients) that supports *MCP tools*. Using the latest version of the MCP client is highly recommended. * A [Telerik user account](https://www.telerik.com/account/). * An active [DevCraft or Telerik UI for Blazor license](https://www.telerik.com/purchase/blazor-ui) or a [Telerik UI for Blazor trial](https://www.telerik.com/blazor-ui). * A [Blazor application that includes Telerik UI for Blazor](slug:blazor-overview#getting-started). @@ -73,6 +73,10 @@ To enable global automatic discovery of the Telerik MCP Server in Visual Studio, For detailed instructions, refer to [Use MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers). +> This section applies to VS Code 1.102.1 and newer versions. + +Make sure that [`chat.mcp.enabled`](vscode://settings/chat.mcp.enabled) is enabled in the VS Code settings. + To enable the Telerik MCP Server in a specific [workspace](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-workspace), Blazor app, or [globally](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server-to-your-user-configuration), add a `.vscode` folder with an `mcp.json` file at the root of the workspace, app, or your user folder, respectively. >caption .vscode/mcp.json From d6e150c9037504e043224f6e37f39343983b6a10 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Tue, 22 Jul 2025 16:35:14 +0300 Subject: [PATCH 3/4] Update ai/mcp-server.md --- ai/mcp-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ai/mcp-server.md b/ai/mcp-server.md index f556eabd3..f33902516 100644 --- a/ai/mcp-server.md +++ b/ai/mcp-server.md @@ -44,7 +44,7 @@ You also need to add your [Telerik licence key](slug:installation-license-key) a For detailed instructions, refer to [Use MCP servers in Visual Studio](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers). -> Early Visual Studio 17.14.# versions require the Copilot Chat window to be open and active when you open a solution. Otherwise the Telerik MCP server is not used. +> Early Visual Studio 17.14 versions require the Copilot Chat window to be open and active when you open a solution. Otherwise the Telerik MCP server is not used. To enable the Telerik MCP Server in a specific Blazor app, add a `.mcp.json` file to the solution folder. From 2ebb9a08178255c429f16d9a458d4633a0c291d1 Mon Sep 17 00:00:00 2001 From: Dimo Dimov <961014+dimodi@users.noreply.github.com> Date: Fri, 25 Jul 2025 11:08:07 +0300 Subject: [PATCH 4/4] Update mcp-server.md --- ai/mcp-server.md | 1 + 1 file changed, 1 insertion(+) diff --git a/ai/mcp-server.md b/ai/mcp-server.md index f33902516..4265d3e1a 100644 --- a/ai/mcp-server.md +++ b/ai/mcp-server.md @@ -34,6 +34,7 @@ Use the documentation of your AI-powered MCP client to add the Telerik MCP serve > * Do not use hyphens (`-`) or underscores (`_`) in the MCP server name in the MCP `.json` file, due to potential compatibility issues with some MCP clients such as Visual Studio or Windsurf. > * Some MCP clients expect the MCP servers to be listed under a `servers` JSON key, while others expect `mcpServers`. +> * Some MCP clients expect an `mcp.json` file, while others like Visual Studio 2022 expect an `.mcp.json` file. You also need to add your [Telerik licence key](slug:installation-license-key) as an `env` parameter in the `mcp.json` file. There are two options: