fix: update all docs with correct MCP setup (npm package)

- docs/0_overview.md - npm config instead of stdio path
- docs/README.md - npm config instead of stdio path
- docs/4_tools-and-guides.md - added standalone server to key files
- docs/8_mcp.md - already updated in previous commit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/0_overview.md

@@ -62,14 +62,16 @@ RA-OS is designed to be the knowledge backend for your AI workflows:
 {
   "mcpServers": {
     "ra-h": {
-      "command": "node",
+      "command": "npx",
-      "args": ["/path/to/ra-h_os/apps/mcp-server/stdio-server.js"]
+      "args": ["ra-h-mcp-server"]
     }
   }
 }
 ```
 
-Available tools: `rah_add_node`, `rah_search_nodes`, `rah_update_node`, `rah_get_nodes`, `rah_create_edge`, `rah_query_edges`, `rah_update_edge`, `rah_create_dimension`, `rah_update_dimension`, `rah_delete_dimension`, `rah_search_embeddings`
+Add this to `~/.claude.json` and restart Claude. Works without RA-OS running.
+
+Available tools: `rah_add_node`, `rah_search_nodes`, `rah_update_node`, `rah_get_nodes`, `rah_create_edge`, `rah_query_edges`, `rah_list_dimensions`, `rah_create_dimension`, `rah_update_dimension`, `rah_delete_dimension`
 
 ## Documentation
 

docs/4_tools-and-guides.md

@@ -205,8 +205,9 @@ These tools are used by APIs and internal operations:
 
 | File | Purpose |
 |------|---------|
-| `apps/mcp-server/server.js` | HTTP MCP server |
+| `apps/mcp-server-standalone/` | **Standalone MCP server (recommended)** |
-| `apps/mcp-server/stdio-server.js` | STDIO MCP server |
+| `apps/mcp-server/server.js` | HTTP MCP server (requires app running) |
+| `apps/mcp-server/stdio-server.js` | STDIO bridge to HTTP server |
 | `src/tools/infrastructure/registry.ts` | Tool registry |
 | `src/services/guides/guideService.ts` | Guide management |
 | `src/config/guides/*.md` | Built-in guides |

docs/README.md

@@ -42,20 +42,20 @@ Open http://localhost:3000
 
 ## MCP Integration
 
-Add to your Claude Code config:
+Add to your `~/.claude.json`:
 
 ```json
 {
   "mcpServers": {
     "ra-h": {
-      "command": "node",
+      "command": "npx",
-      "args": ["/path/to/ra-h_os/apps/mcp-server/stdio-server.js"]
+      "args": ["ra-h-mcp-server"]
     }
   }
 }
 ```
 
-See [MCP docs](./8_mcp.md) for full setup.
+Works without RA-OS running. See [MCP docs](./8_mcp.md) for alternatives.
 
 ## Questions?