diff --git a/.gitignore b/.gitignore
index 99e48d9ab..534d83a64 100644
--- a/.gitignore
+++ b/.gitignore
@@ -48,6 +48,9 @@ CLAUDE.local.md
 .junie/
 .agents/
 
+# Test fixtures need a committed .mcp.json (the rule above ignores real projects')
+!src/core-skills/bmad-module/tests/fixtures/**/.mcp.json
+
 z*/
 !docs/zh-cn/
 
diff --git a/src/core-skills/bmad-module/tests/fixtures/examples/comprehensive/acme-devlog/.mcp.json b/src/core-skills/bmad-module/tests/fixtures/examples/comprehensive/acme-devlog/.mcp.json
new file mode 100644
index 000000000..a73e9e07a
--- /dev/null
+++ b/src/core-skills/bmad-module/tests/fixtures/examples/comprehensive/acme-devlog/.mcp.json
@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "devlog-history": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/mcp-server.js"],
+      "env": {
+        "DEVLOG_PATH": "${CLAUDE_PLUGIN_DATA}/devlog"
+      }
+    }
+  }
+}