Skip to content

Commit e6395f8

Browse files
authored
Document volume mounts using the UI (#113)
* Document volume mounts using the UI fixes: #111
1 parent 950d3da commit e6395f8

File tree

1 file changed

+30
-3
lines changed

1 file changed

+30
-3
lines changed

docs/toolhive/guides-ui/run-mcp-servers.md

Lines changed: 30 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,10 @@ On the configuration form, enter the following details:
5050

5151
:::
5252

53-
3. **Secrets** and **environment variables** expected by the server are
53+
3. To give the MCP server **access to the file system**, use the
54+
[Volume mount](#volumes) feature. [Optional]
55+
56+
4. **Secrets** and **environment variables** expected by the server are
5457
populated from the registry automatically. Required values are marked with an
5558
asterisk (\*).
5659
1. **Secrets**: Enter a value to create a new secret or select an existing
@@ -138,7 +141,10 @@ On the configuration form, enter:
138141
application-specific parameters. Refer to the MCP server's documentation for
139142
details.
140143

141-
6. Any **secrets** or **environment variables** required by the MCP server.
144+
6. To give the MCP server **access to the file system**, use the
145+
[Volume mount](#volumes) feature. [Optional]
146+
147+
7. Any **secrets** or **environment variables** required by the MCP server.
142148
[Optional]\
143149
These might include API tokens, configuration options, or other sensitive
144150
data.
@@ -190,7 +196,10 @@ On the configuration form, enter:
190196
application-specific parameters. Refer to the MCP server's documentation for
191197
details.
192198

193-
7. Any **secrets** or **environment variables** required by the MCP server.
199+
7. To give the MCP server **access to the file system**, use the
200+
[Volume mount](#volumes) feature. [Optional]
201+
202+
8. Any **secrets** or **environment variables** required by the MCP server.
194203
[Optional]\
195204
These might include API tokens, configuration options, or other sensitive
196205
data.
@@ -200,6 +209,24 @@ On the configuration form, enter:
200209

201210
Click **Install server** to create and start the MCP server container.
202211

212+
## Mount host files and folders (Volumes) {#volumes}
213+
214+
Some MCP servers need access to files on your machine. You can mount host paths
215+
directly in the UI.
216+
217+
1. In the server **Install / Configure** dialog, scroll to **Storage volumes**.
218+
2. Use the **first row** to create your mount:
219+
- **Host path** — choose a file or folder on your computer.
220+
- **Container path** — where it should appear inside the server (for example,
221+
`/data`).
222+
- By default, mounts are in read-write mode. If you want your volume mount to
223+
be **Read-only**, select the "Read-only access" option from the drop-down.
224+
3. If you need additional mounts, click **Add a volume** and repeat.
225+
4. Click **Install server** to start the server with your volume(s).
226+
227+
This applies to both registry-installed servers and custom servers (Docker image
228+
or source package).
229+
203230
## Manage MCP servers
204231

205232
On the **MCP Servers** page, you can manage your installed MCP servers:

0 commit comments

Comments
 (0)