AI Coding Assistant Documentation

_config.yml

@@ -42,6 +42,9 @@ navigation:
     "upgrade-compatibility":
         title: "Upgrade & Compatibility"
         position: 11        
+    "ai":
+        title: "AI Coding Assistant"
+        position: 4       
     "knowledge-base":
         title: "Knowledge Base"
         position: 30                

ai/mcp-server.md

@@ -0,0 +1,177 @@
+---
+title: MCP Server
+page_title: Telerik AJAX MCP Server
+description: Learn how to add and use the Telerik AJAX MCP Server as an AJAX coding assistant and code generator for better developer productivity. The Telerik AJAX MCP server provides proprietary context about Telerik UI for ASP.NET AJAX to AI-powered software.
+slug: ai/mcp-server
+tags: webforms, ai, mcp server
+published: True
+position: 2
+---
+
+
+# Telerik AJAX MCP Server
+
+The Telerik AJAX [MCP Server](https://modelcontextprotocol.io/docs/getting-started/intro) lets you interact with AI and reach new levels of developer productivity. The MCP server provides proprietary context to AI-powered IDEs, apps and tools. You can use the Telerik AJAX MCP server for AJAX AI code generation and ask about [Telerik UI for ASP.NET AJAX components](https://www.telerik.com/products/aspnet-ajax.aspx), features, or general usage. You can successfully prompt more complex questions and tasks, and generate tailored code that includes Telerik UI for ASP.NET AJAX components and API.
+
+## Prerequisites
+
+To use the Telerik Telerik AJAX 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 highly recommended.
+* A [Telerik user account](https://www.telerik.com/account/).
+* An active [DevCraft or Telerik UI for ASP.NET AJAX license](https://www.telerik.com/purchase/individual/aspnet-ajax.aspx) or a [Telerik UI for ASP.NET AJAX trial](https://www.telerik.com/products/aspnet-ajax.aspx).
+* A [WebForms application that includes Telerik UI for ASP.NET AJAX]({%slug getting-started/adding-the-telerik-controls-to-your-project%}).
+
+Check [AI Coding Assistant Overview]({%slug ai/overview%}) for more recommendations and usage information.
+
+## Installation
+
+There are two ways to install the Telerik Telerik AJAX MCP server:
+
+* Use a manual approach, which is described below.
+* Use an automated process provided by the Telerik extensions for [Visual Studio](slug:getting-started-vs-integration-ai-configuration).
+
+To install the Telerik MCP server manually, use the documentation of your AI-powered MCP client. You can enable the MCP server for specific workspaces or globally. The sections below provide installation tips and examples for some popular MCP clients like [Visual Studio](#visual-studio), [VS Code](#vs-code), and [Cursor](#cursor). The generic settings of the Telerik Telerik AJAX MCP server are:
+
+* npm package name: `@progress/telerik-ajax-mcp`
+* Type: `stdio` (standard input/output transport)
+* Command: `npx`
+* Arguments: `-y`
+* Server name: `telerik_ajax_assistant`. This name depends on your preferences. The suggestion here matches the MCP tool name in the npm package. See the notes below.
+* Your [Telerik license key](#license-key) as an `env` parameter
+
+> * 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.
+> * Some MCP clients, including older Visual Studio versions, may not accept a server name that uses hyphens (`-`) or underscores (`_`). In such cases, update the MCP client version or use a different server name.
+
+### License Key
+
+To use the Telerik MCP Server, your configuration must provide your [Telerik licence key]({%slug licensing/license-key %}) as an `env` parameter in the MCP `.json` file. There are two options:
+
+* Use a `TELERIK_LICENSE_PATH` argument and point to your Telerik license file location. This approach is recommended, unless you are sharing your VS Code settings across different computers with different operating systems or user names.
+* Use a `TELERIK_LICENSE` argument and paste your Telerik license key. Make sure to update the license key when necessary.
+
+### Visual Studio
+
+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.
+
+To enable the Telerik MCP Server in a specific WebForms app, add a `.mcp.json` file to the solution folder.
+
+>caption .mcp.json
+
+````JSON
+{
+  "servers": {
+    "telerik-ajax-assistant": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@progress/telerik-ajax-mcp@latest" ],
+      "env": {
+        "TELERIK_LICENSE_PATH": "C:\\Users\\___\\AppData\\Roaming\\Telerik\\telerik-license.txt"
+      }
+    }
+  }
+}
+````
+
+To enable global automatic discovery of the Telerik MCP Server in Visual Studio, add the above `.mcp.json` file to your user directory (`%USERPROFILE%`), for example, `C:\Users\____\.mcp.json`.
+
+> Once the Telerik MCP server is added, make sure that the `telerik_ajax_assistant` tool is [enabled (checked) in the Copilot Chat window's tool selection dropdown](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022#configuration-example-with-github-mcp-server). This dropdown opens when clicking on a wrench icon 🔧 at the bottom of the Copilot Window. The Telerik MCP server may get disabled when starting a new chat, changing threads, or relaunching Visual Studio. This is a known issue with MCP servers in general.
+
+### VS Code
+
+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), WebForms 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
+
+````JSON
+{
+  "servers": {
+    "telerik-ajax-assistant": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@progress/telerik-ajax-mcp@latest" ],
+      "env": {
+        "TELERIK_LICENSE_PATH": "C:\\Users\\___\\AppData\\Roaming\\Telerik\\telerik-license.txt"
+      }
+    }
+  }
+}
+````
+
+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
+{
+  // ...
+  "chat.mcp.discovery.enabled": true,
+}
+````
+
+### Cursor
+
+For detailed instructions, refer to [Model Context Protocol](https://docs.cursor.com/context/mcp).
+
+To [enable the Telerik MCP Server in a specific workspace, WebForms 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
+
+````JSON
+{
+  "servers": {
+    "telerik-ajax-assistant": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@progress/telerik-ajax-mcp@latest" ],
+      "env": {
+        "TELERIK_LICENSE_PATH": "C:\\Users\\___\\AppData\\Roaming\\Telerik\\telerik-license.txt"
+      }
+    }
+  }
+}
+````
+
+## Usage
+
+By default, MCP clients do not call MCP tools in a deterministic way. Some MCP clients like [VS Code](#vs-code) allow you to explicitly reference the desired MCP tool in your prompt.
+
+To use the Telerik MCP Server:
+
+1. Start your prompt with `Telerik` to make it more likely for the Telerik MCP server to get called. If you are using VS Code, then start your prompt with:
+    * `#` and the MCP server name that you used in `mcp.json` (for example, `#telerik_ajax_assistant`)
+    * `#` and the name of the Telerik Telerik AJAX MCP tool (`#telerik_ajax_assistant`)
+1. Confirm that the Telerik MCP server is used. Look for a statement in the output, which is similar to:
+    * `Running telerik_ajax_assistant` (in VS Code)
+    * `Calling MCP tool telerik_ajax_assistant` (in Cursor)
+1. Grant the Telerik tool permission to run for the current session, workspace, or always.
+
+### Sample Prompts
+
+The following list describes how your prompts may look like. Check the [Prompt Library](slug:ai-prompt-library) for more examples.
+
+* "Telerik Generate an AJAX Grid with sorting and paging enabled. Bind the Grid to a Person model and provide dummy data."
+* "Telerik Generate a ComboBox for AJAX that shows a list of products. Create a Product class and generate sample data."
+* "Telerik Show me sample code for an AJAX Grid with virtual scrolling for the rows and columns."
+
+## Usage Limits
+
+A Telerik [Subscription license](https://www.telerik.com/purchase/faq/licensing-purchasing) is recommended in order to use the Telerik Blazor AI Coding Assistant without restrictions. Perpetual license holders and trial users can make a [limited number of requests per year]({%slug ai/overview#usage-limits%}).
+
+## Connect to Local AI Model
+
+You can use the Telerik Telerik AJAX MCP server with local large language models (LLM). For example, run your local model through [Ollama](https://ollama.com) and use a third-party package such as [MCP-LLM Bridge](https://github.com/patruff/ollama-mcp-bridge) to connect the model to the Telerik MCP server. This will allow you to use the Telerik AI Coding Assistant without a cloud-based AI model.
+
+## Next Steps
+
+Test with sample prompts from the [Prompt Library]({%slug ai/prompt-library%}).

ai/overview.md

@@ -0,0 +1,77 @@
+---
+title: Overview
+page_title: Telerik AJAX AI Tooling Overview
+description: Learn about the AI-powered developer tools that integrate with your IDE or code editor for greater productivity and enhanced developer experience.
+slug: ai/overview
+tags: webforms, ai, assistant
+published: True
+position: 1
+---
+
+# Telerik AJAX AI Coding Assistant Overview
+
+The Telerik AJAX AI Coding Assistant improves your developer experience and increases your productivity when implementing WebForms apps that include Telerik UI for ASP.NET AJAX. The coding assistant is an AI code generator that provides proprietary context to AI models in order to produce higher quality code samples with the [Telerik UI for ASP.NET AJAX components](https://www.telerik.com/products/aspnet-ajax.aspx) and API.
+
+The Telerik AI Coding Assistant is integrated in the [WebFroms MCP Server]({%slug ai/mcp-server%}). The MCP server can handle more complex prompts that require several requests to the AI model. An MCP-enabled client like Cursor or GitHub Copilot in **Agent** mode can directly suggest changes to your app and even rebuild it to verify the new AI generated code.
+
+## Getting Started
+
+To use the Telerik AJAX AI Coding Assistant, you need:
+
+* A [Telerik user account](https://www.telerik.com/account/).
+* An active [DevCraft or Telerik UI for ASP.NET AJAX license](https://www.telerik.com/purchase/individual/aspnet-ajax.aspx) or a [Telerik UI for ASP.NET AJAX trial](https://www.telerik.com/products/aspnet-ajax.aspx).
+* A [WebForms application that includes Telerik UI for ASP.NET AJAX]({%slug getting-started/adding-the-telerik-controls-to-your-project%}).
+* A [Telerik Subscription license](https://www.telerik.com/purchase/faq/licensing-purchasing) is recommended in order to use the Telerik Telerik AJAX AI Coding Assistant without restrictions. Perpetual license holders and trial users can make a [limited number of requests per year](#usage-limits).
+
+## Intended Use
+
+You can use the Telerik AI Coding Assistant for:
+
+* Initial code generation: Quickly add components to your app to speed up the initial development.
+* Component configuration: Enable or disable specific component features, or fine tune the configuration through prompting. More complex configurations are possible but may require additional manual work to be production-ready.
+* Dummy data generation and data binding: Quickly add data to your app for testing and prototyping purposes. Avoid exposing or providing access to your proprietary or production data to AI-enabled tools.
+* Step-by-step explanations: Understand the solutions provided by the AI Coding Assistant through the detailed explanations (depends on the tool, mode, and model). To further develop your knowledge, check the respective documentation.
+* Preliminary troubleshooting: Resolve obvious and easy-to-solve issues affecting your code. For more complex issues, search the product documentation or look for assistance from the community.
+
+>warning Always double-check the suggested code and solutions of any AI-powered tool before applying them to your app.
+
+> The Telerik AI Coding Assistant is not intended for styling and theme customization. If you are looking for AI-powered styling and theming, check out [Telerik ThemeBuilder](https://www.telerik.com/themebuilder).
+
+## Recommendations
+
+Consider the following recommendations when working with the Telerik AI Coding Assistant:
+
+* When switching between tasks and files, start a new session in a new chat window to avoid polluting the context with irrelevant or outdated information.
+* At the time of publishing, Claude Sonnet 4 and GPT-5 produce better results.
+* Sometimes, the AI Coding Assistant might generate custom styles. To avoid any custom styling, include a similar statement in your prompts: `Don't add custom CSS styles`.
+
+## Telerik Document Processing AI Coding Assistant
+
+You can also use the AI Coding Assistant for [Telerik Document Processing](https://www.telerik.com/document-processing-libraries) to generate high-quality code samples and speed up your development. Read the full guide in the dedicated [DPL AI Coding Assistant](https://docs.telerik.com/devtools/document-processing/ai-coding-assistant/overview) article.
+
+## Usage Limits
+
+The Telerik AJAX AI Conding Assistant allows the following maximum number of requests, depending on your [Telerik license type](https://www.telerik.com/purchase/faq/licensing-purchasing):
+
+* Perpetual licenses: include 50 requests per year to let you explore and try out the AI Coding Assistant. If you'd like ongoing, higher-volume access, switch to a Subscription license.
+* Subscription licenses: virtually unlimited number of requests with a fair use threshold of 300 requests per day
+* Trial licenses: 300 requests per trial per year. Activating the same trial for a new release does not grant additional 300 requests.
+
+> All Telerik AI tools share a single request limit for your Telerik account. For example, the [Telerik MCP server](slug:ai-mcp-server) takes up from the same usage quota.
+> When using the Telerik MCP server, one prompt may trigger several requests, depending on the prompt complexity.
+
+## Privacy
+
+The Telerik AJAX AI Coding Assistant operates under the following conditions:
+
+* The Assistant does not have access to your workspace and application code. Note that when using the Telerik MCP server (or any other MCP server), the LLM generates parameters for the MCP server request, which may include parts of your application code.
+* The Assistant does not use your prompts to train Telerik AI models.
+* The Assistant does not generate the actual responses and has no access to these responses. The Assistant only provides a better context that helps your selected model (for example, GPT, Gemini, Claude) provide better responses.
+* The Assistant does not associate your prompts to your Telerik user account. Your prompts and generated context are anonymized and stored for statistical and troubleshooting purposes.
+* The Assistant stores metrics about how often and how much you use it in order to ensure compliance with the [allowed number of requests that correspond to your current license](#usage-limits).
+
+Make sure to also get familiar with the terms and privacy policy of your selected AI model and AI client.
+
+## Next Steps
+
+Add the [WebForms MCP Server]({%slug ai/mcp-server%}) to an MCP-enabled client.