如何将 Railway 远程 MCP 连接到 Cursor
约 1 分钟即可把 Railway 的远程 MCP 服务端接入 Cursor。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。
Streamable HTTPhttps://mcp.railway.com/mcp
Install in Cursor →
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"railway": {
"url": "https://mcp.railway.com/mcp"
}
}
}claude mcp add --transport http railway https://mcp.railway.com/mcp
Install in VS Code →
Or add to .vscode/mcp.json:
{
"servers": {
"railway": {
"type": "http",
"url": "https://mcp.railway.com/mcp"
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://mcp.railway.com/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"railway": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.railway.com/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"railway": {
"serverUrl": "https://mcp.railway.com/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"railway": {
"url": "https://mcp.railway.com/mcp"
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.railway] url = "https://mcp.railway.com/mcp"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"railway": {
"type": "streamableHttp",
"url": "https://mcp.railway.com/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"railway": {
"httpUrl": "https://mcp.railway.com/mcp"
}
}
}接入步骤
- 打开 MCP 设置 — Cursor → Settings → MCP,或直接编辑全局
~/.cursor/mcp.json/ 项目级.cursor/mcp.json。 - 添加服务端 — 点击本页一键 deeplink 自动安装,或在
mcpServers下加入"railway": { "url":https://mcp.railway.com/mcp}。 - 完成认证 — 首次调用时客户端会打开 Railway 的 OAuth 授权页面——点击允许后工具即可用。
- 验证 — 在 在线 Inspector 中粘贴
https://mcp.railway.com/mcp并运行 initialize + tools/list 验证连通性。
🧰 工具预览(17)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| list_projects ~28 tok | 🟢 Read | List Railway projects. | — |
| get_project ~28 tok | 🟢 Read | Get a Railway project. | — |
| create_project ~29 tok | 🟠 Write | Create a Railway project. | — |
| list_services ~29 tok | 🟢 Read | List services in a project. | — |
| deploy_service ~30 tok | 🟠 Write | Trigger a service deployment. | — |
| list_deployments ~30 tok | 🟢 Read | List service deployments. | — |
| get_deployment_logs ~29 tok | 🟢 Read | Get deployment logs. | — |
| list_variables ~30 tok | 🟢 Read | List environment variables. | — |
| set_variable ~29 tok | 🟠 Write | Set an environment variable. | — |
| create_database ~30 tok | 🟠 Write | Provision a database service. | — |
| list_volumes ~26 tok | 🟢 Read | List volumes. | — |
| get_metrics ~27 tok | 🟢 Read | Get service metrics. | — |
| list_environments ~30 tok | 🟢 Read | List project environments. | — |
| create_environment ~29 tok | 🟠 Write | Create an environment. | — |
| restart_service ~28 tok | 🟠 Write | Restart a service. | — |
| get_service ~26 tok | 🟢 Read | Get a service. | — |
| get_domain ~27 tok | 🟢 Read | Get a service domain. | — |