diff --git a/ai_assistants.md b/ai_assistants.md index 69cd1d2..b7f7941 100644 --- a/ai_assistants.md +++ b/ai_assistants.md @@ -17,7 +17,9 @@ option, is on the [MCP server](mcp_server) page. 1. **Python 3.9 or later.** Nothing else to install: the server uses only Python's standard library. On Windows, get it from [python.org](https://www.python.org/downloads/) and tick "Add python.exe - to PATH" in the installer. + to PATH" in the installer. If typing `python` in a terminal opens the + Microsoft Store, Python is not installed: that is a shortcut Windows + ships in its place. 2. **The server itself**, one file: [`qet_mcp.py`](https://raw.githubusercontent.com/qelectrotech/qelectrotech-source-mirror/master/misc/qet-mcp/qet_mcp.py). Save it anywhere, for example next to your drawings. It is not in the @@ -267,8 +269,27 @@ so Windows users need not install Python themselves. The command becomes > before trying any of this against your own build. This section will drop > this notice once it does. -A dialog in QElectroTech writes the setup for your assistant with the -paths filled in, for you to copy. +**Aide → Connecter un assistant IA…** (*Help → Connect an AI assistant*) +writes the setup for your assistant with this installation's paths filled +in: + +![The dialog with Claude Desktop chosen, /home/you/drawings as the folder, editing allowed, and the setup text below](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/ai-assistant-dialog.png) + +1. Pick the assistant: Claude Desktop, Claude Code, GitHub Copilot (VS + Code), Cursor, Gemini CLI, Codex CLI or LM Studio. +2. Pick the folder of drawings it may use (*Dossier accessible*). +3. Tick *Autoriser l'assistant à modifier les schémas* only if it may edit + them. It is unticked by default. +4. **Copier** (*Copy*), and paste where the dialog says. The dialog writes + nothing and starts nothing itself. + +It also tells you, in bold, when something is missing: + +| Message | Meaning | +|---|---| +| *Le serveur MCP n'est pas installé avec cette version* | this QElectroTech was installed without the server: use the download above | +| *Python est introuvable sur cet ordinateur* | the Python the setup names is not there. On Windows, run the QElectroTech installer again and tick *Python pour l'assistant IA*, or install Python; elsewhere, install Python 3 from your system's packages | +| *Python n'est peut-être pas installé* (Windows) | only the Microsoft Store shortcut answers to `python`, which opens the Store instead of running the server | ## ChatGPT, and Claude or Copilot in a web browser diff --git a/images/ai-assistant-dialog.png b/images/ai-assistant-dialog.png new file mode 100644 index 0000000..d20e1ea Binary files /dev/null and b/images/ai-assistant-dialog.png differ