diff --git a/web/content/docs/6-memory.md b/web/content/docs/6-memory.md
index d198d6b17..e4f5c8e0e 100644
--- a/web/content/docs/6-memory.md
+++ b/web/content/docs/6-memory.md
@@ -33,14 +33,23 @@ This is the most powerful way to use Memory. Your AI (Cursor, Claude, etc.) gain
 
 ### Setup
 
-Add the server to your MCP configuration file:
+Run `ai-devkit setup` once per machine. It wires the memory MCP server — named `ai-devkit-memory`, launched with `npx -y @ai-devkit/memory` — into the global config of every MCP-capable agent it detects:
+
+| Agent | MCP wiring |
+|-------|-----------|
+| Claude Code, Codex, Gemini, Cursor, opencode, Grok | Automatic via `setup` |
+| Pi | No MCP support by design — use the `memory` skill or `ai-devkit memory` CLI instead |
+
+`ai-devkit status` reports the wiring state per agent, so you can confirm the server is connected before relying on it.
+
+If an agent's config is managed manually, you can still add the server yourself:
 
 ```json
 {
   "mcpServers": {
-    "memory": {
+    "ai-devkit-memory": {
       "command": "npx",
-      "args": ["@ai-devkit/memory"]
+      "args": ["-y", "@ai-devkit/memory"]
     }
   }
 }