DOC-5254 rounded out install and client config details

Author: andy-stark-redis

content/integrate/redis-mcp/_index.md

@@ -28,10 +28,11 @@ Redis MCP is a general-purpose implementation that lets agents read, write, and
 query data in Redis and also has some basic commands to manage the Redis
 server. With this enabled, you can use an LLM client as a very high-level
 interface to Redis. Add, query, and analyze any Redis data set directly from
-an LLM chat:
+an LLM chat using instructions and questions like the following:
 
 - "Store the entire conversation in the 'recent_chats' stream"
 - "Cache this item"
 - "How many keys does my database have?"
 - "What is user:1's email?"
 
+See the other pages in this section to learn how to set up and use Redis MCP:

content/integrate/redis-mcp/ciient-conf.md renamed to content/integrate/redis-mcp/client-conf.md

@@ -19,15 +19,15 @@ The sections below describe the ways you can do this.
 
 ## Smithery
 
-Smithery provides a searchable repository of scripts that add configurations
-for many MCP services to client apps.
+[Smithery](https://smithery.ai/) provides a searchable repository of scripts
+that add configurations for many MCP services to client apps.
 The easiest way to configure your client is to use the
 [Smithery tool for Redis MCP](https://smithery.ai/server/@redis/mcp-redis).
 
 When you select your client from the **Install** bar on the Redis MCP page,
 you will see a command line that you can copy and paste into a terminal.
 Running this command will configure your client app to use Redis MCP. (Note
-that you need to have [Node.js](https://nodejs.org/en) installed to run
+that you must have [Node.js](https://nodejs.org/en) installed to run
 the Smithery scripts.) For example, the command line for
 [Claude Desktop](https://claude.ai/download) is
 
@@ -42,14 +42,21 @@ your Redis database.
 
 You can also add the configuration for Redis MCP to your client app
 manually. The exact method varies from client to client but the
-basic approach is similar in each case.
+basic approach is similar in each case. The pages listed below
+give the general configuration details for some common MCP client tools:
+
+-   [Claude Desktop](https://modelcontextprotocol.io/quickstart/user)
+-   [Github Copilot for VSCode](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
+-   [OpenAI](https://openai.github.io/openai-agents-python/mcp/)
+
+### Local servers
 
 For a locally-running MCP server, you need to edit the configuration
 file to add the command that launches the server, along with its
 arguments. For example, with Claude Desktop, you can locate the
 file by selecting **Settings** from the menu, then selecting the
 **Developer** tab, and then clicking the **Edit Config** button.
-When you open this JSON file, you should add your settings as
+Open this JSON file and add your settings as
 shown below:
 
 ```json
@@ -58,7 +65,7 @@ shown below:
         .
         .
       "redis": {
-            "command": "<path-to-uv-command>>",
+            "command": "<path-to-uv-command>",
             "args": [
                 "--directory",
                 "<your-folder-path>/mcp-redis",
@@ -96,4 +103,55 @@ the command shell here in the `env` section:
 }
 ```
 
+If you are using
+[Docker]({{< relref "/integrate/redis-mcp/install#install-using-docker" >}})
+to deploy the server, change the `command` and `args` sections of the
+configuration as shown below:
+
+```json
+"redis": {
+    "command": "docker",
+    "args": ["run",
+            "--rm",
+            "--name",
+            "redis-mcp-server",
+            "-i",
+            "-e", "REDIS_HOST=<redis_hostname>",
+            "-e", "REDIS_PORT=<redis_port>",
+            "-e", "REDIS_USERNAME=<redis_username>",
+            "-e", "REDIS_PWD=<redis_password>",
+            "mcp-redis"]
+}
+```
+
+### Remote servers
+
+If you set up an
+[externally visible]({{< relref "/integrate/redis-mcp/install#making-mcp-visible-externally" >}})
+MCP server, you may be able to configure it directly from the app (but
+if you can't, then see [Using a gateway](#using-a-gateway) for an alternative approach). For
+example, the following `JSON` element configures
+[Github Copilot for VSCode](https://code.visualstudio.com/docs/copilot/overview)
+to use an `sse` type server running at `127.0.0.1`:
+
+```json
+    .
+    .
+"mcp": {
+    "servers": {
+        "redis-mcp": {
+            "type": "sse",
+            "url": "http://127.0.0.1:8000/sse"
+        },
+    }
+},
+    .
+    .
+```
+
+### Using a gateway
 
+Apps that don't currently support external MCP servers directly, such as Claude
+Desktop, can still access them using a *gateway*. See
+[MCP server gateway](https://github.com/lightconetech/mcp-gateway)
+for more information.

content/integrate/redis-mcp/install.md

@@ -7,20 +7,23 @@ categories:
 - rs
 summary: Access a Redis server using any MCP client.
 group: service
-linkTitle: Install
+linkTitle: Install the server
 description: Install and configure the Redis MCP server.
 type: integration
 weight: 10
 ---
 
 The MCP server runs separately from Redis, so you will need a
-Redis server to access. See [Redis Cloud]({{< relref "/operate/rc" >}})
+Redis server for it to connect to. See [Redis Cloud]({{< relref "/operate/rc" >}})
 or [Redis Open Source]({{< relref "/operate/oss_and_stack" >}}) to learn
 how to get a test server active within minutes.
 
+When you have a Redis server available, use the instructions below to install and
+configure the Redis MCP server.
+
 ## Install the server from source
 
-When you have a Redis server, you can clone Redis MCP from the
+Clone Redis MCP from the
 [Github repository](https://github.com/redis/mcp-redis) using the following
 command:
 
@@ -33,7 +36,7 @@ tool to set up the server. See the `uv`
 [installation instructions](https://github.com/astral-sh/uv?tab=readme-ov-file#installation)
 for more information.
 
-When you have `uv`, go into the `mcp-redis` folder that you cloned and
+When you have installed `uv`, go to the `mcp-redis` folder that you cloned and
 enter the following commands to initialize the MCP server code:
 
 ```bash
@@ -47,9 +50,10 @@ uv sync
 ## Install using Docker
 
 You can use the [`mcp/redis`](https://hub.docker.com/r/mcp/redis)
-image (or build your own image from the source using the `Dockerfile`) to 
-run Redis MCP with [Docker](https://www.docker.com/). Use the following
-command to download `mcp/redis` from [DockerHub](https://hub.docker.com/):
+image to run Redis MCP with [Docker](https://www.docker.com/).
+Alternatively, use the following
+command to build the Docker image with the `Dockerfile` in the
+`mcp/redis` folder:
 
 ```
 docker build -t mcp-redis .
@@ -113,3 +117,10 @@ tool:
 curl -i http://127.0.0.1:8000/sse
 HTTP/1.1 200 OK
 ```
+
+## Next steps
+
+When you have installed the server, you will need a MCP client to
+connect to it and use its services. See
+[Configure client apps]({{< relref "/integrate/redis-mcp/client-conf" >}})
+for more information.