From e91046ffdb3e59af338ae3f8d43e35a63c5d7dbe Mon Sep 17 00:00:00 2001 From: moraisacr Date: Wed, 11 Feb 2026 02:54:06 -0300 Subject: [PATCH] docs(ai-tutor): add troubleshooting for MCP setup issues --- adev/src/content/ai/ai-tutor.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/adev/src/content/ai/ai-tutor.md b/adev/src/content/ai/ai-tutor.md index e5a6144966e..c38c778bdca 100644 --- a/adev/src/content/ai/ai-tutor.md +++ b/adev/src/content/ai/ai-tutor.md @@ -97,6 +97,36 @@ If you want to learn about a specific topic out of order (e.g., jump from the ba ## **Troubleshooting** +### Setup Issues + +**"launch the Angular AI tutor" doesn't do anything?** + +Make sure you have a project open first. The tutor needs an actual Angular project to work with: + +```bash +ng new my-app +cd my-app +code . +``` + +Then ensure your MCP server is running. In VS Code, open the `.vscode/mcp.json` file and click the **"Start"** button at the top of the file. + +When you type "launch the Angular AI tutor", you should see a checkmark saying +"Reviewed .vscode/mcp.json and ran start task" and a prompt asking to +"Allow task run?" — go ahead and click Allow. + +**Still not working?** + +Try typing `#angular-cli` first to load the Angular context, then paste the tutorial URL: `https://angular.dev/ai/ai-tutor` + +**How to verify the server is running** + +Open the Command Palette (`Ctrl+Shift+P`), type "MCP: List Running Servers", and look for "angular-cli" in the list. + +--- + +### General Issues + If the tutor doesn't respond correctly or you suspect an issue with your application, here are a few things to try: 1. **Type "proceed":** This can often nudge the tutor to continue to the next step in the event it gets stuck.