Summary
Add first-class proxy support to the allagents mcp add workflow so users can opt into mcp-remote directly from the CLI, without manually editing workspace.yaml to add mcpProxy:.
Example target UX:
allagents mcp add ediprod https://ediprod.mcp.wtg.zone --proxy
Optionally:
allagents mcp add ediprod https://ediprod.mcp.wtg.zone --proxy --client claude,codex,copilot
Motivation
Upstream allagents now has a dedicated mcp command surface, which is the right direction for MCP-only workflows. However, the current proxy path is still driven by workspace.yaml:
mcpProxy:
clients:
- claude
- codex
That works, but it is not ergonomic for users who just want to add one server through the CLI and have it use the built-in mcp-remote rewrite immediately.
Today the user has to:
- add the MCP server
- edit
workspace.yaml
- add
mcpProxy.clients or per-server overrides
- sync again
For one-off installs, that is more ceremony than necessary.
Why this belongs on mcp add
I think this should be a flag on mcp add, not a separate mcp proxy command group.
allagents mcp add <name> <commandOrUrl> --proxy
Reasons:
- proxying is a transport/detail of the server definition, not a separate top-level object
- it composes naturally with existing flags like
--client, --transport, --env, and --header
- it matches user intent: “add this MCP server, but proxy it”
- it avoids splitting similar workflows across
mcp add and a separate proxy namespace
Proposed Behavior
mcp add --proxy
When --proxy is used with an HTTP server:
- the server should be added normally via
mcp add
- the workspace config should record that this server should be proxied for the selected clients
- the built-in proxy rewrite should be applied during post-mutation sync
- the proxy metadata file should be created automatically if needed
Interaction with --client
If --client is present:
allagents mcp add ediprod https://ediprod.mcp.wtg.zone --proxy --client claude,codex
then proxying should apply only to those clients.
If --client is omitted, I would expect proxying to apply to all MCP-capable configured clients, same as the rest of mcp add behavior.
Config representation
Internally, this can still persist to workspace.yaml via the existing mcpProxy structure. The point is not to avoid persistence — it is to avoid requiring the user to hand-edit that structure.
In other words, this issue is about CLI ergonomics, not changing the config model.
Acceptance Criteria
Related Context
Example Use Case
Enterprise/internal MCP servers like ediprod and wtgkb often work best through a local proxy for clients that struggle with HTTP auth or OAuth callback flows. allagents already has the machinery for this via mcp-remote; this request is to expose that path directly in the command users already expect to use.
Summary
Add first-class proxy support to the
allagents mcp addworkflow so users can opt intomcp-remotedirectly from the CLI, without manually editingworkspace.yamlto addmcpProxy:.Example target UX:
Optionally:
Motivation
Upstream
allagentsnow has a dedicatedmcpcommand surface, which is the right direction for MCP-only workflows. However, the current proxy path is still driven byworkspace.yaml:That works, but it is not ergonomic for users who just want to add one server through the CLI and have it use the built-in
mcp-remoterewrite immediately.Today the user has to:
workspace.yamlmcpProxy.clientsor per-server overridesFor one-off installs, that is more ceremony than necessary.
Why this belongs on
mcp addI think this should be a flag on
mcp add, not a separatemcp proxycommand group.Reasons:
--client,--transport,--env, and--headermcp addand a separate proxy namespaceProposed Behavior
mcp add --proxyWhen
--proxyis used with an HTTP server:mcp addInteraction with
--clientIf
--clientis present:then proxying should apply only to those clients.
If
--clientis omitted, I would expect proxying to apply to all MCP-capable configured clients, same as the rest ofmcp addbehavior.Config representation
Internally, this can still persist to
workspace.yamlvia the existingmcpProxystructure. The point is not to avoid persistence — it is to avoid requiring the user to hand-edit that structure.In other words, this issue is about CLI ergonomics, not changing the config model.
Acceptance Criteria
allagents mcp add <name> <url> --proxyworks for HTTP MCP servers--proxyautomatically enables the existingmcp-remoterewrite path--proxy --client claude,codexscopes proxying to those clientsworkspace.yamledit is required for the common casemcp-remote-based proxy implementationRelated Context
src/core/mcp-proxy.tsExample Use Case
Enterprise/internal MCP servers like
ediprodandwtgkboften work best through a local proxy for clients that struggle with HTTP auth or OAuth callback flows.allagentsalready has the machinery for this viamcp-remote; this request is to expose that path directly in the command users already expect to use.