Skip to content

[Gap]: Document Proxy Mode and Proxy Port form fields #772

@danbarr

Description

@danbarr

Gap

The local-MCP and remote-MCP forms both render:

  • Proxy modesse / streamable-http dropdown, visible only for stdio transport with non–Bearer-Token auth
  • Proxy port — number input with tooltip "Port for the HTTP proxy to listen on. If not specified, ToolHive will automatically assign a random port"

Neither is mentioned in run-mcp-servers.mdx, which documents target port (lines 269-273) but not proxy port — these are distinct concepts (target port is the port the server inside the container listens on; proxy port is the port the HTTP proxy listens on).

Source in app (v0.30.0)

  • renderer/src/common/components/workloads/form-fields-proxy.tsx
  • renderer/src/features/mcp-servers/components/local-mcp/form-fields-base.tsx

Docs to update

  • docs/toolhive/guides-ui/run-mcp-servers.mdx (local + remote server configuration sections)

Introducing PR

stacklok/toolhive-studio#1408 — feat(workloads): add proxy_mode and proxy_port fields to MCP server forms

Parent

Part of #751.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions