Skip to content

Commit 188be32

Browse files
committed
docs(AI): Revamp VS Code MCP information (#3125)
* docs(AI): Revamp VS Code MCP information * continued * Update ai/mcp-server.md * Update mcp-server.md
1 parent 1a017f8 commit 188be32

File tree

1 file changed

+13
-20
lines changed

1 file changed

+13
-20
lines changed

ai/mcp-server.md

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ The Telerik Blazor [MCP Server](https://modelcontextprotocol.io/introduction) le
1717
To use the Telerik Blazor MCP server, you need:
1818

1919
* [Node.js](https://nodejs.org/en) 18 or a newer version.
20-
* 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.
20+
* 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.
2121
* A [Telerik user account](https://www.telerik.com/account/).
2222
* 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).
2323
* A [Blazor application that includes Telerik UI for Blazor](slug:blazor-overview#getting-started).
@@ -34,6 +34,7 @@ Use the documentation of your AI-powered MCP client to add the Telerik MCP serve
3434

3535
> * 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.
3636
> * Some MCP clients expect the MCP servers to be listed under a `servers` JSON key, while others expect `mcpServers`.
37+
> * Some MCP clients expect an `mcp.json` file, while others like Visual Studio 2022 expect an `.mcp.json` file.
3738
3839
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:
3940

@@ -44,11 +45,11 @@ You also need to add your [Telerik licence key](slug:installation-license-key) a
4445

4546
For detailed instructions, refer to [Use MCP servers in Visual Studio](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers).
4647

47-
> 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.
48+
> 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.
4849
4950
To enable the Telerik MCP Server in a specific Blazor app, add a `.mcp.json` file to the solution folder.
5051

51-
> caption .mcp.json
52+
>caption .mcp.json
5253
5354
````JSON.skip-repl
5455
{
@@ -73,9 +74,13 @@ To enable global automatic discovery of the Telerik MCP Server in Visual Studio,
7374

7475
For detailed instructions, refer to [Use MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
7576

76-
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:
77+
> This section applies to VS Code 1.102.1 and newer versions.
7778
78-
>caption .vscode/mcp.json at the workspace root
79+
Make sure that [`chat.mcp.enabled`](vscode://settings/chat.mcp.enabled) is enabled in the VS Code settings.
80+
81+
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.
82+
83+
>caption .vscode/mcp.json
7984
8085
````JSON.skip-repl
8186
{
@@ -92,26 +97,14 @@ To enable the Telerik MCP Server in a specific workspace or Blazor app, add a `.
9297
}
9398
````
9499

95-
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):
100+
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).
96101

97102
>caption VS Code settings.json
98103
99104
````JSON.skip-repl
100105
{
101-
// ...
102-
"chat.mcp.discovery.enabled": true,
103-
"mcp": {
104-
"servers": {
105-
"telerikBlazorAssistant": {
106-
"type": "stdio",
107-
"command": "npx",
108-
"args": ["-y", "@progress/telerik-blazor-mcp@latest"],
109-
"env": {
110-
"TELERIK_LICENSE_PATH": "C:\\Users\\___\\AppData\\Roaming\\Telerik\\telerik-license.txt"
111-
}
112-
}
113-
}
114-
}
106+
// ...
107+
"chat.mcp.discovery.enabled": true,
115108
}
116109
````
117110

0 commit comments

Comments
 (0)