From 09fbd6ad96f066b0152e0c2ff00cea0f40598f8e Mon Sep 17 00:00:00 2001
From: Julian Appel <kontakt@julianappel.de>
Date: Fri, 14 Aug 2026 23:18:08 +0200
Subject: [PATCH] Register versapad MCP server via project-scoped .mcp.json

Lets Claude Code offer the "versapad" MCP server automatically when this
project is opened, instead of requiring a manual `claude mcp add -s user`
per machine. Note: the script path is currently absolute (this machine's
checkout location) rather than relative -- .mcp.json doesn't reliably
support workspace-relative variables across Claude Code environments, so
this only works as-is on this specific checkout path for now.
---
 .mcp.json | 8 ++++++++
 AGENTS.md | 5 +++--
 README.md | 9 ++++++---
 3 files changed, 17 insertions(+), 5 deletions(-)
 create mode 100644 .mcp.json

diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 0000000..2b7f17d
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "versapad": {
+      "command": "py",
+      "args": ["C:\\Users\\Julian\\Documents\\__CODE\\VersaGUI-py\\versapad_mcp_server.py"]
+    }
+  }
+}
diff --git a/AGENTS.md b/AGENTS.md
index 653ea34..b508aaf 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -62,8 +62,9 @@ Nutzerorientierte Einführung: [`README.md`](README.md).
   `MacroStepsDialog`) für den Programmiermodus.
 
 **MCP-Server:**
-- `versapad_mcp_server.py` — registriert als User-Scope-MCP-Server
-  "versapad" (`claude mcp add -s user versapad -- <python> versapad_mcp_server.py`).
+- `versapad_mcp_server.py` — registriert als projektgebundener MCP-Server
+  "versapad" über `.mcp.json` im Projektordner (Alternative:
+  `claude mcp add -s user versapad -- <python> versapad_mcp_server.py`).
   Nutzt MCP-SDK v2 (Paket `mcp`, Klasse `mcp.server.mcpserver.MCPServer` —
   **nicht** `FastMCP` aus `mcp.server.fastmcp`, das existiert in dieser
   SDK-Version nicht mehr, wurde umbenannt). `@mcp.tool()`-dekorierte
diff --git a/README.md b/README.md
index 7a06535..e556a47 100644
--- a/README.md
+++ b/README.md
@@ -126,9 +126,12 @@ OneDrive-Desktop einer bestimmten Windows-Maschine, siehe `CONFIG_PATHS` in
 
 `versapad_mcp_server.py` macht die Config per Tool-Aufruf statt Hand-JSON
 programmierbar — nutzbar von jeder MCP-fähigen KI-Anwendung (Claude Code,
-Claude Desktop, andere). In der MCP-Server-Liste der jeweiligen Anwendung
-eintragen: Kommando `python`/`py`, Argument der Pfad zu
-`versapad_mcp_server.py`.
+Claude Desktop, andere). Für Claude Code liegt bereits eine projektgebundene
+[`.mcp.json`](.mcp.json) im Repo (Server "versapad", Kommando `py
+versapad_mcp_server.py`) — beim Öffnen des Projekts wird sie automatisch
+zum Verbinden angeboten. Für andere Anwendungen oder user-scope-Registrierung
+in der jeweiligen MCP-Server-Liste eintragen: Kommando `python`/`py`,
+Argument der Pfad zu `versapad_mcp_server.py`.
 
 Werkzeuge (Auszug): `list_profiles`, `get_profile`, `get_macro`,
 `get_board_status` (lesen) · `set_button_key`/`_consumer`/`_macro`/