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`/