|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +title: SyncfusionBlazorAssistant MCP Server | Syncfusion |
| 4 | +description: Learn how to configure and use SyncfusionBlazorAssistant MCP server for intelligent code generation, documentation, and troubleshooting in Blazor apps. |
| 5 | +control: Getting started with SyncfusionBlazorAssistant MCP Server |
| 6 | +platform: Blazor |
| 7 | +documentation: ug |
| 8 | +--- |
| 9 | + |
| 10 | +# SyncfusionBlazorAssistant MCP Server |
| 11 | + |
| 12 | +## Overview |
| 13 | + |
| 14 | +The [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant) is a specialized [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that provides intelligent assistance for developers using Syncfusion's Blazor component libraries. This tool seamlessly integrates with compatible MCP clients to enhance your development workflow when building Blazor applications with Syncfusion<sup style="font-size:70%">®</sup> components. |
| 15 | + |
| 16 | +### Key Benefits |
| 17 | + |
| 18 | +* Intelligent code generation for Syncfusion<sup style="font-size:70%">®</sup> Blazor components. |
| 19 | +* Detailed component documentation and usage examples. |
| 20 | +* Troubleshooting assistance for common integration challenges. |
| 21 | + |
| 22 | +## Prerequisites |
| 23 | + |
| 24 | +Before using [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant), ensure you have: |
| 25 | + |
| 26 | +* Required [node](https://nodejs.org/en/) version >= 18 |
| 27 | +* A [compatible MCP client](https://modelcontextprotocol.io/clients) (Syncfusion<sup style="font-size:70%">®</sup> CodeStudio, VS Code with GitHub Copilot, etc.) |
| 28 | +* An active Syncfusion<sup style="font-size:70%">®</sup> license (any of the following): |
| 29 | + - [Syncfusion<sup style="font-size:70%">®</sup> Commercial License](https://www.syncfusion.com/sales/unlimitedlicense) |
| 30 | + - [Syncfusion<sup style="font-size:70%">®</sup> Free Community License](https://www.syncfusion.com/products/communitylicense) |
| 31 | + - [Syncfusion<sup style="font-size:70%">®</sup> Free Trial](https://www.syncfusion.com/account/manage-trials/start-trials) |
| 32 | +* An active [API KEY](https://staging.syncfusion.com/account/user-token-generation) |
| 33 | + |
| 34 | +## Unlimited Access |
| 35 | + |
| 36 | +Syncfusion<sup style="font-size:70%">®</sup> users enjoy completely unlimited access to this MCP server. There are no restrictions on: |
| 37 | + |
| 38 | +* No request limits |
| 39 | +* No component restrictions |
| 40 | +* No query type limitations |
| 41 | +* No usage duration constraints |
| 42 | + |
| 43 | +We believe in providing unrestricted access to tools that enhance your development experience, ensuring you can fully leverage Syncfusion components without limitations. |
| 44 | + |
| 45 | +## Installation and setup |
| 46 | + |
| 47 | +Before you can invoke the SyncfusionBlazorAssistant MCP server, you need to configure your MCP client with these core settings. The **Generic MCP Server Settings** shown below are identical across all clients: |
| 48 | + |
| 49 | +### Generic MCP Server Settings |
| 50 | + |
| 51 | +- **npm package name**: `@syncfusion/blazor-assistant` |
| 52 | +- **Type**: stdio (standard input/output transport) |
| 53 | +- **Command**: npx |
| 54 | +- **Arguments**: -y |
| 55 | +- **Server name**: syncfusionBlazorAssistant |
| 56 | + |
| 57 | +You need to add your [Syncfusion API key](https://staging.syncfusion.com/account/user-token-generation) as an env parameter in the configuration file: |
| 58 | + |
| 59 | +```json |
| 60 | +"env": { |
| 61 | + "Syncfusion_API_Key": "YOUR_API_KEY" |
| 62 | +} |
| 63 | +``` |
| 64 | + |
| 65 | +[SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant) can be configured in various MCP clients. Below are setup instructions for popular environment: |
| 66 | + |
| 67 | +### Syncfusion<sup style="font-size:70%">®</sup> Code Studio |
| 68 | + |
| 69 | +* Install directly from the [Syncfusion Code Studio](https://www.syncfusion.com/code-studio/) MCP Marketplace. |
| 70 | +* Start the server and grant permission when prompted. |
| 71 | + |
| 72 | +### VS Code (GitHub Copilot MCP) |
| 73 | + |
| 74 | +1. To configure an MCP server for a specific workspace, you can create a `.vscode/mcp.json` file in your workspace folder. |
| 75 | + |
| 76 | +```json |
| 77 | +{ |
| 78 | + "servers": { |
| 79 | + "syncfusion-blazor-assistant": { |
| 80 | + "type": "stdio", |
| 81 | + "command": "npx", |
| 82 | + "args": [ |
| 83 | + "-y", |
| 84 | + "@syncfusion/blazor-assistant@latest" |
| 85 | + ], |
| 86 | + "env": { |
| 87 | + "Syncfusion_API_Key": "YOUR_API_KEY" |
| 88 | + } |
| 89 | + } |
| 90 | + } |
| 91 | +} |
| 92 | +``` |
| 93 | + |
| 94 | +2. After updating the configuration in settings.json, you'll notice a "Start" option at the top of the config. This allows you to easily start the [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant) server directly from the settings interface without additional commands. |
| 95 | + |
| 96 | +3. Confirm that [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant) is being used (this does not happen automatically). Look for a statement in the output, which is similar to: |
| 97 | + * `SyncfusionBlazorAssistant is running...` (in VS Code) |
| 98 | + |
| 99 | +### Cursor |
| 100 | + |
| 101 | +To configure an MCP server for a specific workspace, you can create a .cursor/mcp.json file in your workspace folder. |
| 102 | + |
| 103 | +```json |
| 104 | +{ |
| 105 | + "mcpServers": { |
| 106 | + "syncfusion-blazor-assistant": { |
| 107 | + "type": "stdio", |
| 108 | + "command": "npx", |
| 109 | + "args": [ |
| 110 | + "-y", |
| 111 | + "@syncfusion/blazor-assistant@latest" |
| 112 | + ], |
| 113 | + "env": { |
| 114 | + "Syncfusion_API_Key": "YOUR_API_KEY" |
| 115 | + } |
| 116 | + } |
| 117 | + } |
| 118 | +} |
| 119 | +``` |
| 120 | + |
| 121 | +### JetBrains IDEs |
| 122 | + |
| 123 | +1. Go to Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP). |
| 124 | +2. Click + Add to add a new MCP server configuration. |
| 125 | +3. In the New MCP Server dialog, switch the dropdown as `As JSON` and add the following config: |
| 126 | + |
| 127 | +```json |
| 128 | +{ |
| 129 | + "mcpServers": { |
| 130 | + "syncfusion-blazor-assistant": { |
| 131 | + "command": "npx", |
| 132 | + "args": [ |
| 133 | + "-y", |
| 134 | + "@syncfusion/blazor-assistant@latest" |
| 135 | + ], |
| 136 | + "env": { |
| 137 | + "Syncfusion_API_Key": "YOUR_API_KEY" |
| 138 | + } |
| 139 | + } |
| 140 | + } |
| 141 | +} |
| 142 | +``` |
| 143 | + |
| 144 | +Click OK and Apply. |
| 145 | + |
| 146 | +> For more detailed information about configuring MCP servers in various clients, refer to the official documentations. |
| 147 | + * [VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server) |
| 148 | + * [Cursor](https://docs.cursor.com/en/context/mcp#using-mcp-json) |
| 149 | + * [JetBrains](https://www.jetbrains.com/help/ai-assistant/mcp.html#connect-to-an-mcp-server) |
| 150 | + * [Windsurf](https://docs.windsurf.com/windsurf/cascade/mcp#mcp-config-json) |
| 151 | + |
| 152 | +## Usage |
| 153 | + |
| 154 | +To activate the SyncfusionBlazorAssistant MCP server: |
| 155 | + |
| 156 | +1. Start your prompt with one of the following: |
| 157 | + * 'SyncfusionBlazorAssistant' |
| 158 | + * '/syncfusion-blazor-assistant' |
| 159 | + * '/syncfusion-blazor' |
| 160 | + * '@syncfusion-blazor' |
| 161 | + * '@ask_syncfusion_blazor' |
| 162 | + * 'ej2-blazor' |
| 163 | + |
| 164 | + In VS Code, you can also use #SyncfusionBlazorAssistant to explicitly invoke the MCP server. |
| 165 | + |
| 166 | +2. Grant the SyncfusionBlazorAssistant MCP server a permission to run for this session, workspace, or always. |
| 167 | +3. For best results, start a new chat for each new topic to maintain clean context. |
| 168 | + |
| 169 | +### Best Practices for Effective Usage |
| 170 | + |
| 171 | +1. `Be specific`: Mention both platform and component (e.g., "How do I create a Syncfusion Blazor Grid with paging and filtering?"). |
| 172 | +2. `Provide context`: Include details about your use case for more targeted solutions. |
| 173 | +3. `Use descriptive queries`: Avoid vague questions that lack necessary context. |
| 174 | +4. `Start fresh for new topics`: Begin a new chat session when switching components or topics. |
| 175 | + |
| 176 | +### Example Queries |
| 177 | + |
| 178 | +Here are some effective ways to use [SyncfusionBlazorAssistant](https://www.npmjs.com/package/@syncfusion/blazor-assistant): |
| 179 | + |
| 180 | + * "Create a Syncfusion Blazor Grid component with paging, sorting and filtering" |
| 181 | + * "How do I implement data binding with Syncfusion Blazor scheduler?" |
| 182 | + * "Show me how to create a dashboard with multiple Syncfusion components" |
| 183 | + |
| 184 | +## Troubleshooting |
| 185 | + |
| 186 | +If you encounter issues: |
| 187 | + |
| 188 | + * Verify your API key is correctly configured. |
| 189 | + * Ensure the MCP server is enabled in your client's tools selection. |
| 190 | + * Check that you're using a compatible MCP client version. |
| 191 | + * Try restarting your development environment. |
| 192 | + |
| 193 | +## Support |
| 194 | + |
| 195 | +Product support is available through the following mediums. |
| 196 | + |
| 197 | +* [Support ticket](https://support.syncfusion.com/support/tickets/create) - Guaranteed Response in 24 hours | Unlimited tickets | Holiday support |
| 198 | +* [Community forum](https://www.syncfusion.com/forums/essential-js2) |
| 199 | +* [Request feature or report bug](https://www.syncfusion.com/feedback/javascript) |
| 200 | +* Live chat |
| 201 | + |
| 202 | +## See also |
| 203 | + |
| 204 | +* [Syncfusion Blazor Documentation](https://blazor.syncfusion.com/documentation) |
0 commit comments