From 63b1a6fe39b5aacdaca8305904cb204a6b1ac5c1 Mon Sep 17 00:00:00 2001
From: damocles <damocles@hyperhive.local>
Date: Thu, 23 Jul 2026 18:00:06 +0200
Subject: [PATCH] docs(#2659): note bash extraMcpServers example is
 illustrative, tracks bashHttpPort

---
 nix/agent-modules/mcp.nix | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/nix/agent-modules/mcp.nix b/nix/agent-modules/mcp.nix
index 1ae2af03..dafeda83 100644
--- a/nix/agent-modules/mcp.nix
+++ b/nix/agent-modules/mcp.nix
@@ -131,6 +131,12 @@ in
       it into `--mcp-config` + `--allowedTools`. Take effect on the
       agent's next harness restart (no operator approval needed beyond
       whatever brought the new agent.nix into deployed/*).
+
+      The `bash` entry above is illustrative only — it's auto-injected
+      below (`hyperhive.extraMcpServers.bash` via `lib.mkDefault`) already
+      tracking `hyperhive.mcp.bashHttpPort`, so overriding it directly
+      with a hardcoded port (as shown) is unusual and will drift if
+      `bashHttpPort` is changed separately; bump `bashHttpPort` instead.
     '';
   };