add link to service accounts

Author: blva

README.md

@@ -38,7 +38,7 @@ node -v
 
 Most MCP clients require a configuration file to be created or modified to add the MCP server.
 
-- **Windsurf**:https://docs.windsurf.com/windsurf/mcp
+- **Windsurf**: https://docs.windsurf.com/windsurf/mcp
 - **VSCode**: https://docs.codeium.com/docs/mcp
 - **Claude Desktop**: https://modelcontextprotocol.io/quickstart/user
 - **Cursor**: https://docs.cursor.com/context/model-context-protocol
@@ -89,8 +89,9 @@ Use your Atlas API Service Account credentials. More details in the [Atlas API A
 
 Alternatively you can use environment variables in the config file or set them and run the server via npx.
 
-- Connection String via environment variables in the MCP file [example](#connection-string-with-environment-variables)
-- Atlas API credentials via environment variables in the MCP file [example](#atlas-api-credentials-with-environment-variables)
+- Connection String via environment variables in the MCP file [example](#connection-string-configuration)
+- Atlas API credentials via environment variables in the MCP file [example](#atlas-api-credentials-configuration)
+- Set env variables and run the server directly [example](#environment-variables)
 
 ## 🛠️ Supported Tools
 
@@ -220,6 +221,9 @@ To use the Atlas API tools, you'll need to create a service account in MongoDB A
    - Select appropriate permissions (for full access, use Organization Owner)
    - Click "Create"
 
+To learn more about Service Accounts, check the [MongoDB Atlas documentation](https://www.mongodb.com/docs/atlas/api/service-accounts-overview/).
+
+
 2. **Save Client Credentials:**
 
    - After creation, you'll be shown the Client ID and Client Secret
@@ -234,6 +238,11 @@ To use the Atlas API tools, you'll need to create a service account in MongoDB A
 
 ### Configuration Methods
 
+There are multiple ways to configure the MongoDB MCP Server. You can use:
+1. Environment variables
+2. Command-line arguments 
+3. MCP client configuration files with either method
+
 #### Environment Variables
 
 Set environment variables with the prefix `MDB_MCP_` followed by the option name in uppercase with underscores:
@@ -247,12 +256,33 @@ export MDB_MCP_API_CLIENT_SECRET="your-atlas-client-secret"
 export MDB_MCP_CONNECTION_STRING="mongodb+srv://username:[email protected]/myDatabase"
 
 export MDB_MCP_LOG_PATH="/path/to/logs"
+```
+
+You can also set environment variables and run the server directly:
+
+```shell
+export MDB_MCP_API_CLIENT_ID="your-atlas-client-id"
+export MDB_MCP_API_CLIENT_SECRET="your-atlas-client-secret"
+export MDB_MCP_CONNECTION_STRING="mongodb+srv://username:[email protected]/myDatabase"
+
+npx -y mongodb-mcp-server
+```
+
+#### Command-Line Arguments
 
+Pass configuration options as command-line arguments when starting the server:
+
+```shell
+npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret="your-atlas-client-secret" --connectionString="mongodb+srv://username:[email protected]/myDatabase" --logPath=/path/to/logs
 ```
 
-#### MCP configuration file examples
+#### MCP Client Configuration Examples
 
-##### Connection String with environment variables
+The examples below show how to configure various MCP clients with different configuration methods.
+
+##### Using Environment Variables in MCP Configuration
+
+###### Connection String Configuration
 
 ```json
 {
@@ -268,7 +298,7 @@ export MDB_MCP_LOG_PATH="/path/to/logs"
 }
 ```
 
-##### Atlas API credentials with environment variables
+###### Atlas API Credentials Configuration
 
 ```json
 {
@@ -285,17 +315,9 @@ export MDB_MCP_LOG_PATH="/path/to/logs"
 }
 ```
 
-#### Command-Line Arguments
-
-Pass configuration options as command-line arguments when starting the server:
-
-```shell
-npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret="your-atlas-client-secret" --connectionString="mongodb+srv://username:[email protected]/myDatabase" --logPath=/path/to/logs
-```
-
-#### MCP configuration file examples
+##### Using Command-Line Arguments in MCP Configuration
 
-##### Connection String with command-line arguments
+###### Connection String Configuration
 
 ```json
 {
@@ -313,7 +335,7 @@ npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret
 }
 ```
 
-##### Atlas API credentials with command-line arguments
+###### Atlas API Credentials Configuration
 
 ```json
 {