Skip to content

docs(mcp): document the CLI proxy transport and refresh the remote tool list - #1256

Draft
codyde wants to merge 1 commit into
mainfrom
cody/mcp-proxy-docs
Draft

docs(mcp): document the CLI proxy transport and refresh the remote tool list#1256
codyde wants to merge 1 commit into
mainfrom
cody/mcp-proxy-docs

Conversation

@codyde

@codyde codyde commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Draft — documents the railway mcp proxy work now merged in the CLI (railwayapp/cli#1026) and the remote MCP tools merged in backboard.

What changed in the product

  • The CLI gained a railway mcp proxy transport: a local stdio bridge to mcp.railway.com that authenticates with your existing railway login. railway mcp install --remote now installs this proxy, so the hosted server no longer requires a browser OAuth step for CLI users.
  • The direct-URL OAuth flow is still available via railway mcp install --remote --oauth (and remains the only option for editors without the CLI).
  • The remote MCP server's tool set expanded well beyond what the docs listed.

Docs updates

content/docs/cli/mcp.md

  • Add the proxy subcommand.
  • New "Transports" section covering local / remote-proxy / remote-oauth and how each authenticates.
  • Document the --oauth flag; update --remote's description.
  • Updated installed-entries table (proxy writes args: ["mcp", "proxy"]) and examples.

content/docs/ai/mcp-server.md

  • Reframe "Remote MCP" so it covers both the CLI proxy (no browser) and OAuth.
  • Refresh the remote tool list to match the shipped registry — it was missing service CRUD, config/metrics, domains, workspaces, and docs search/fetch. Verified against packages/backboard/.../mcp/tools/index.ts on backboard master.
  • Add a CLI-proxy credential-handling note to the security section.

src/components/mcp-install-guide.tsx

  • Correct the remote-mode caption, which still stated --remote authenticates via OAuth.

Reviewer note / open question

The interactive <McpInstallGuide /> has a two-mode (Local / Remote) toggle, where "Remote" shows the direct-URL config for each editor — which is now specifically the --remote --oauth path. I fixed the caption to reconcile this, but did not restructure the per-editor toggle to add a distinct "proxy" configuration, since that's a larger component change. Worth deciding whether the interactive guide should surface the proxy stdio config (args: ["mcp", "proxy"]) per editor, or whether the prose + cli/mcp.md table is enough.

Verification

  • Component typechecks clean (tsc --noEmit).
  • cli/mcp.md follows the no-em-dash house style; ai/mcp-server.md edits match that file's existing bullet style.
  • Tool names verified against the merged backboard registry (26 http-surface tools).

🤖 Generated with Claude Code

…ol list

The Railway CLI now supports a `railway mcp proxy` transport that bridges the
hosted MCP server (mcp.railway.com) over stdio using your existing
`railway login`, so `railway mcp install --remote` no longer requires a
browser OAuth step. The direct-URL OAuth flow moves to
`railway mcp install --remote --oauth`.

- cli/mcp.md: add the `proxy` subcommand, document the three install
  transports (local / remote-proxy / remote-oauth), the `--oauth` flag, the
  updated installed-entries table, and examples.
- ai/mcp-server.md: clarify that remote connections use the CLI proxy (no
  browser) or OAuth; refresh the remote tool list to match the shipped
  server registry (workspaces, service CRUD, config, metrics, domains, docs
  search/fetch); add a CLI-proxy credential-handling note to the security
  section.
- mcp-install-guide.tsx: correct the remote-mode caption, which still said
  `--remote` authenticates via OAuth.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@railway-app

railway-app Bot commented Jul 28, 2026

Copy link
Copy Markdown

🚅 Deployed to the docs-pr-1256 environment in 🪄 *.railway.com

Service Status Web Updated (UTC)
Docs Frontend ✅ Success (View Logs) Web Jul 28, 2026 at 12:20 am
7 services not affected by this PR
  • devicons
  • OG
  • Frontend Redis
  • Blog
  • Turnout
  • Meilisearch
  • Geofeed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant