fix: docs

Author: fmenezes

README.md

@@ -10,38 +10,88 @@ A Model Context Protocol server for interacting with MongoDB Atlas. This project
 - [🚀 Getting Started](#getting-started)
   - [Prerequisites](#prerequisites)
   - [Installation](#installation)
-  - [Running the MCP Server](#running-the-mcp-server)
+    - [VSCode](#vscode)
+    - [Claude Desktop](#claude)
 - [🛠️ Supported Tools](#supported-tools)
   - [Tool List](#tool-list)
+- [⚙️ Configuration](#configuration)
+  - [Configuration Options](#configuration-options)
+  - [Atlas API Access](#atlas-api-access)
+  - [Configuration Methods](#configuration-methods)
 - [👩‍💻 Client Integration](#client-integration)
   - [VSCode](#vscode)
   - [Claude](#claude)
 - [🤝 Contributing](#contributing)
 
-## 🚀 Getting Started
-
-### Prerequisites
+## Prerequisites
 
 - Node.js (v20 or later)
 - MongoDB Atlas account
 
-### Installation
+## Installation
 
-```shell
-# Clone the repository
-git clone https://github.com/mongodb-labs/mongodb-mcp-server.git
-cd mongodb-mcp-server
+### VSCode
+
+Prerequisites:
+
+- Node.js v20.x
+
+Step 1: Add the mcp server to VSCode configuration
+
+- Press `Cmd + Shift + P` and type `MCP: Add MCP Server` and select it.
+- Select command (Stdio).
+- Input command `npx -y @mongodb-js/mongodb-mcp-server`.
+- Choose between user / workspace
+- Add arguments to the file
+
+Note: the file should look like:
 
-# Install dependencies
-npm install
+```
+{
+    "servers": {
+        "MongoDB": {
+            "type": "stdio",
+            "command": "npx",
+            "args": [
+                "-y",
+                "@mongodb-js/mongodb-mcp-server"
+            ]
+        }
+    }
+}
 ```
 
-### Running the MCP Server
+Notes: You can configure the server with atlas access, make sure to follow configuration section for more details.
 
-```shell
-npm run build
+Step 2: Try talking to github copilot
+
+- Can you connect to my mongodb instance?
+
+### Claude Desktop
+
+Step 1: Install claude and login
+
+Note: follow instructions at https://claude.ai/download
+
+Step 2: Launch Claude Settings -> Developer -> Edit Config
+
+Paste the mcp server configuration into the file
+
+```json
+{
+  "mcpServers": {
+    "MongoDB": {
+      "command": "npx",
+      "args": ["-y", "@mongodb-js/mongodb-mcp-server"]
+    }
+  }
+}
 ```
 
+Step 3: Close and Relaunch Claude Desktop and click on the hammer icon, the MongoDB MCP server should be detected.
+
+You may experiment asking `Can you connect to my mongodb instance?`.
+
 ## 🛠️ Supported Tools
 
 ### Tool List
@@ -80,77 +130,6 @@ npm run build
 - `collection-storage-size` - Get the size of a collection in MB
 - `db-stats` - Return statistics about a MongoDB database
 
-## 👩‍💻 Client Integration (Use the server!)
-
-### VSCode
-
-Prerequisites:
-
-- Node.js v20.x
-
-Step 1: Add the mcp server to VSCode configuration
-
-- Press `Cmd + Shift + P` and type `MCP: Add MCP Server` and select it.
-- Select the first option for a local MCP server.
-- Add the path to dist/index.js in the prompt
-
-Step 2: Verify the created mcp file
-
-It should look like this
-
-```json
-{
-  "servers": {
-    "mongodb-mcp-server": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@mongodb-js/mongodb-mcp-server"]
-    }
-  }
-}
-```
-
-Notes: You can configure the server with atlas access, make sure to follow configuration section for more details.
-
-Step 3: Open the copilot chat and check that the toolbox icon is visible and has the mcp server listed.
-
-Step 4: Try running a command
-
-- Can you list my clusters?
-
-### Claude
-
-Step 1: Install claude and login
-
-```shell
-brew install claude
-```
-
-Step 2: Create a configuration file for your MCP server
-
-Open the file
-
-```shell
-code ~/Library/Application\ Support/Claude/claude_desktop_config.json
-```
-
-Paste the mcp server configuration into the file
-
-```json
-{
-  "mcpServers": {
-    "Demo": {
-      "command": "npx",
-      "args": ["-y", "@mongodb-js/mongodb-mcp-server"]
-    }
-  }
-}
-```
-
-Step 3: Launch Claude Desktop and click on the hammer icon, the Demo MCP server should be detected. Type in the chat "show me a demo of MCP" and allow the tool to get access.
-
-Note: If you make changes to your MCP server code, rebuild the project with `npm run build` and restart the server and Claude Desktop.
-
 ## Configuration
 
 The MongoDB MCP Server can be configured using multiple methods, with the following precedence (highest to lowest):
@@ -219,7 +198,7 @@ export MDB_MCP_LOG_PATH="/path/to/logs"
 Pass configuration options as command-line arguments when starting the server:
 
 ```shell
-node dist/index.js --apiClientId="your-atlas-client-id" --apiClientSecret="your-atlas-client-secret" --connectionString="mongodb+srv://username:[email protected]/myDatabase" --logPath=/path/to/logs
+npx -y @mongodb-js/mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret="your-atlas-client-secret" --connectionString="mongodb+srv://username:[email protected]/myDatabase" --logPath=/path/to/logs
 ```
 
 ## 🤝 Contributing