From 29eb67ac9392aacf3fe6226d637776edf189ef4e Mon Sep 17 00:00:00 2001 From: Daniel Kantor Date: Wed, 13 Aug 2025 13:47:42 +0200 Subject: [PATCH 1/2] Document volume mounts using the UI fixes: https://github.com/stacklok/docs-website/issues/111 --- docs/toolhive/guides-ui/run-mcp-servers.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/toolhive/guides-ui/run-mcp-servers.md b/docs/toolhive/guides-ui/run-mcp-servers.md index 7ec6dce5..a6cb6379 100644 --- a/docs/toolhive/guides-ui/run-mcp-servers.md +++ b/docs/toolhive/guides-ui/run-mcp-servers.md @@ -200,6 +200,24 @@ On the configuration form, enter: Click **Install server** to create and start the MCP server container. +## Mount host files and folders (Volumes) + +Some MCP servers need access to files on your machine. You can mount host paths +directly in the UI. + +1. In the server **Install / Configure** dialog, scroll to **Storage volumes**. +2. Use the **first row** to create your mount: + - **Host path** — choose a file or folder on your computer. + - **Container path** — where it should appear inside the server (for example, + `/data`). + - (Optional) uncheck **Read-only** to allow the server to write. By default, + mounts are read-only. +3. If you need additional mounts, click **Add a volume** and repeat. +4. Click **Install server** to start the server with your volume(s). + +This applies to both registry-installed servers and custom servers (Docker image +or source package). + ## Manage MCP servers On the **MCP Servers** page, you can manage your installed MCP servers: From cc10b420f7be11f849916705bfbd33068ede5942 Mon Sep 17 00:00:00 2001 From: Daniel Kantor Date: Thu, 14 Aug 2025 19:58:07 +0200 Subject: [PATCH 2/2] mention volume mounts in each section --- docs/toolhive/guides-ui/run-mcp-servers.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/toolhive/guides-ui/run-mcp-servers.md b/docs/toolhive/guides-ui/run-mcp-servers.md index 30721723..b40378cb 100644 --- a/docs/toolhive/guides-ui/run-mcp-servers.md +++ b/docs/toolhive/guides-ui/run-mcp-servers.md @@ -50,7 +50,10 @@ On the configuration form, enter the following details: ::: -3. **Secrets** and **environment variables** expected by the server are +3. To give the MCP server **access to the file system**, use the + [Volume mount](#volumes) feature. [Optional] + +4. **Secrets** and **environment variables** expected by the server are populated from the registry automatically. Required values are marked with an asterisk (\*). 1. **Secrets**: Enter a value to create a new secret or select an existing @@ -138,7 +141,10 @@ On the configuration form, enter: application-specific parameters. Refer to the MCP server's documentation for details. -6. Any **secrets** or **environment variables** required by the MCP server. +6. To give the MCP server **access to the file system**, use the + [Volume mount](#volumes) feature. [Optional] + +7. Any **secrets** or **environment variables** required by the MCP server. [Optional]\ These might include API tokens, configuration options, or other sensitive data. @@ -190,7 +196,10 @@ On the configuration form, enter: application-specific parameters. Refer to the MCP server's documentation for details. -7. Any **secrets** or **environment variables** required by the MCP server. +7. To give the MCP server **access to the file system**, use the + [Volume mount](#volumes) feature. [Optional] + +8. Any **secrets** or **environment variables** required by the MCP server. [Optional]\ These might include API tokens, configuration options, or other sensitive data. @@ -200,7 +209,7 @@ On the configuration form, enter: Click **Install server** to create and start the MCP server container. -## Mount host files and folders (Volumes) +## Mount host files and folders (Volumes) {#volumes} Some MCP servers need access to files on your machine. You can mount host paths directly in the UI.