diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 0000000..0c065b1
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "bilagun": {
+      "type": "http",
+      "url": "${BILAGUN_MCP_URL:-https://mcp.gureametsabilagun.pireon.dev/mcp}",
+      "headers": {
+        "Authorization": "Basic ${BILAGUN_MCP_AUTH}"
+      }
+    }
+  }
+}
diff --git a/mcp/README.md b/mcp/README.md
index 413b9a1..35d8360 100644
--- a/mcp/README.md
+++ b/mcp/README.md
@@ -49,10 +49,24 @@ so each person acts with their own permissions and access can be revoked from th
 After deploying, in Dokploy add a **domain** to the service `mcp`, port **3000** (e.g. `mcp.gureametsabilagun.pireon.dev`, HTTPS on).
 Check it: `https://mcp.gureametsabilagun.pireon.dev/healthz` → `{"ok":true}`.
 
-**Claude Code**
+**Claude Code (from this repository)**
+
+The repo includes `.mcp.json`, so Claude Code offers the `bilagun` server when you open the project.
+Each person only sets their own credential (never committed):
 
 ```bash
-claude mcp add --transport http bilagun https://mcp.gureametsabilagun.pireon.dev/mcp \
+# ~/.zshrc or ~/.bashrc
+export BILAGUN_MCP_AUTH="$(printf 'asistente:xxxx xxxx xxxx xxxx xxxx xxxx' | base64)"
+# optional, if the MCP domain is different:
+# export BILAGUN_MCP_URL="https://mcp.example.org/mcp"
+```
+
+Open a new terminal, run `claude` in the project, approve the `bilagun` server and check it with `/mcp`.
+
+**Claude Code (any folder)**
+
+```bash
+claude mcp add --transport http --scope user bilagun https://mcp.gureametsabilagun.pireon.dev/mcp \
   --header "Authorization: Basic <base64 from step 1>"
 ```