# Railway MCP Server 可透過 CLI、OAuth 或本機模式管理部署與環境

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 原作者：Railway (@Railway) · 策展與摘要：EasyVibeCoding · 平台：X (Twitter) · 熱度：🔥 · 日期：2026-09-01

> 原始來源：https://x.com/Railway/status/2094504959773745521

## 證據與延伸閱讀

- [Railway MCP Server 可透過 CLI、OAuth 或本機模式管理部署與環境。](https://docs.railway.com/ai/mcp-server) — 官方文件 · 最後核對：2026-09-01 · 支持主張：The first-party docs add CLI reuse of railway login credentials, OAuth workspace/project scoping, a CLI 5.44.0 prerequisite, one-command agent setup, per-editor configuration, protocol-level destructive-action hints, and an in-process local server for restricted networks. Railway's root post reports rapid growth in MCP daily users and highlights logs, deployments, status, and Railway Agent as common calls.
- [Railway MCP daily users 成長數據...](https://x.com/Railway/status/2094504959773745521)

## 中文摘要

Railway MCP Server 可透過 CLI、OAuth 或本機模式管理部署與環境。

**核心功能**　Railway 文件指出，Railway MCP Server 執行於 [mcp.railway.com](https://mcp.railway.com)，遵循 Model Context Protocol，讓 Cursor、VS Code、Claude Code、Windsurf 等 AI 應用程式透過標準化的 client-server 架構呼叫 Railway 工具。AI assistant 可根據使用者以自然語言描述的目標，執行下列工作：

- 建立專案、從 template 部署應用程式、管理 environment 與 service。
- 讀取 environment variables、重新部署 service，以及管理 feature flags。
- 透過 `railway-agent` 將自然語言交給 Railway Agent，處理日誌分析、部署除錯與 service 設定等多步操作。
- 查詢日誌、部署與狀態；Railway 表示，這些以及與 Railway Agent 互動，是目前最常用的 tool calls。

**三種連線方式**　預設方式是由 `railway mcp` 透過 Railway CLI 連到遠端 MCP Server，並重用既有的 `railway login` 憑證，因此不需要第二次驗證；CLI 必須為 5.44.0 以上。支援 OAuth 的 editor 則可直接連到 `https://mcp.railway.com`，並將授權範圍限制在指定的 workspace 與 project；OAuth token 是短期憑證，也能從 Railway 帳戶設定撤銷。若機器無法連出，例如位於 egress 受限的網路，則可執行本機、in-process 的 MCP Server，直接使用 CLI 憑證呼叫 Railway API。

**快速設定**　已有 Railway CLI 的使用者可依連線需求執行：

1. 先確認 CLI 版本至少為 5.44.0，並完成 `railway login`。
2. 使用 CLI 連線：`railway setup agent`。
3. 改用 OAuth：`railway setup agent --oauth`。
4. 受限網路可啟動本機模式：`railway mcp local`，或用 `railway mcp install --local` 產生支援 editor 的設定。
5. 針對個別 editor，也可執行 `railway mcp install --agent cursor`、`railway mcp install --agent claude-code`、`railway mcp install --agent codex`、`railway mcp install --agent copilot`、`railway mcp install --agent factory-droid` 或 `railway mcp install --agent opencode`。其中 Windsurf、Cline 與 Devin 在文件中標示為僅支援 OAuth。

文件也提供一鍵 bootstrap：`curl -fsSL agents.railway.com | sh`。這是會下載並執行遠端內容的 `curl | sh` 指令，屬於需人工核對的高風險來源指令，不應在未檢查來源與內容前直接執行。

**工具與安全控制**　遠端 Server 提供 `whoami`、`list-projects`、`create-project`、`list-services`、`list-feature-flags`、`get-feature-flag`、`set-feature-flag`、`delete-feature-flag`、`redeploy`、`accept-deploy` 與 `railway-agent` 等工具。`delete-feature-flag` 是管理員限定的破壞性操作；`accept-deploy` 會提交 staged changes 並部署。客戶端若遵循 MCP 協定層的提示，會在破壞性呼叫前要求確認。

本機 Server 會在破壞性工具執行前回傳預覽，只有收到 `confirm: true` 才繼續；其工具集合也不同於遠端 `mcp.railway.com`，包含 `remove_service`、`delete_domain`、`remove_tcp_proxy`、`remove_bucket` 與 `remove_volume` 等高風險操作。Railway 明確建議使用者：

- 在核准前檢查 LLM 要執行的動作，尤其是 `redeploy`、`accept-deploy`、`railway-agent` 及本機模式的移除或刪除工具。
- 限制可存取 MCP Server 的使用者，只在可能的情況下於非關鍵 environment 使用。
- 不要把設定視為沒有風險：CLI 會讀取並更新 `railway login` 憑證，雖然 editor 設定不含長期 Railway 憑證；OAuth 則應只授權必要的 workspace 與 project。
- Project token 不被接受，Server 需要使用者身分，以支援 billing 與 audit trail。

**官方採用訊號與限制**　Railway 在官方貼文中稱，MCP daily users 從 June 到 July 成長超過 300%，July 到 August 又成長約 500%，並以此反駁「MCP 已經式微」的說法。不過，這些是 Railway 自行公布的採用情況，來源沒有提供分母或獨立的計算方法，不能直接視為第三方 benchmark。文件同樣未說明 production SLA、定價，以及使用者核准 agent 動作後對實際營運的影響。

**示範觀察**　影片展示了在 Claude Code 中完成 Railway MCP OAuth 授權的流程：先於 `/mcp` 選取 Railway Server，再於瀏覽器選擇 workspace 並授權，終端機隨後顯示已成功連線。畫面顯示的 Claude Code 版本為 v2.1.251，連線完成後顯示 42 tools；這些屬於示範畫面中的狀態，不應解讀為本文檔對所有 editor 或部署環境的固定規格。

<video src="https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1788237984461-6ahc6h2k.mp4" poster="https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/3b60ecf9704bf160.jpg" controls playsinline preload="metadata" style="max-width:100%;height:auto;display:block;margin:1rem 0"></video>
> Railway 網站主頁、專案管理介面與 Railway MCP Server 的安裝指引畫面，示範透過終端機連接 Claude Code 並完成 OAuth 驗證以啟用 Railway MCP 整合的完整流程。

## 媒體內容

**Railway 網站主頁、專案管理介面與 Railway MCP Server 的安裝指引畫面，示範透過終端機連接 Claude Code 並完成 OAuth 驗證以啟用 Railway MCP 整合的完整流程。**

**影片中的 Prompt 與操作**

操作步驟：

1. （00:06）點擊 Railway MCP Server 頁面的 Copy 按鈕複製終端機指令
2. （00:12）在終端機貼上並執行 `claude mcp add railway --transport http https://mcp.railway.com`
3. （00:15）在終端機輸入 `claude` 進入 Claude Code
4. （00:17）在 Claude Code 中輸入 `/mcp` 並選取 Railway MCP Server 執行 Authenticate
5. （00:21）在瀏覽器授權頁面點擊 Authorize 按鈕完成授權

## 標籤

新產品, CLI, Railway, Railway MCP Server, Claude Code
