Railway MCP

npx add-mcp 'https://mcp.railway.com'

Máy chủ Railway MCP triển khai Giao thức Ngữ cảnh Mô hình (MCP). Nó cho phép các trợ lý AI tạo dự án, triển khai mẫu, quản lý môi trường, kéo biến và triển khai lại dịch vụ.

Máy chủ chạy tại mcp.railway.com. Kết nối với nó theo một trong hai cách:

• Thông qua CLI (mặc định). Lệnh railway mcp kết nối trình soạn thảo của bạn với mcp.railway.com thông qua Railway CLI, tái sử dụng thông tin xác thực railway login của bạn để không cần xác thực lần thứ hai.
• Với OAuth. Các trình soạn thảo hỗ trợ OAuth kết nối trực tiếp với https://mcp.railway.com mà không cần CLI.

Lưu ý: Kết nối qua CLI yêu cầu phiên bản CLI 5.44.0 trở lên.

Bắt đầu nhanh

Cài đặt Railway CLI và cấu hình kỹ năng agent, MCP và xác thực trong một lệnh duy nhất. Chọn các tùy chọn để tạo lệnh thiết lập:

Nếu CLI đã được cài đặt, hãy bỏ qua bước khởi tạo và chạy:

railway setup agent          # connect through the CLI (default)
railway setup agent --oauth  # connect with OAuth

Đọc tiếp để biết cấu hình thủ công theo từng trình soạn thảo, danh sách công cụ có sẵn và các cân nhắc bảo mật.

Cấu hình theo trình soạn thảo

Nếu bạn muốn cấu hình trình soạn thảo thủ công hoặc muốn kiểm tra những gì railway mcp install ghi, hãy sử dụng bộ chọn để chuyển đổi giữa kết nối CLI, OAuth và chạy máy chủ cục bộ:

railway mcp install hợp nhất mục nhập máy chủ Railway vào các cấu hình hiện có mà không xóa các máy chủ MCP khác. Chạy lại bất kỳ lúc nào để cập nhật.

Hiểu về MCP

Giao thức Ngữ cảnh Mô hình (MCP) định nghĩa một tiêu chuẩn cho cách các ứng dụng AI (máy chủ) có thể tương tác với các công cụ và nguồn dữ liệu bên ngoài thông qua kiến trúc máy khách-máy chủ.

• Máy chủ (Hosts): Các ứng dụng như Cursor, VS Code, Claude Code hoặc Windsurf kết nối với các máy chủ MCP.
• Máy khách (Clients): Lớp bên trong các máy chủ duy trì kết nối một-một với từng máy chủ MCP.
• Máy chủ (Servers): Các chương trình độc lập (như Máy chủ Railway MCP) cung cấp các công cụ và quy trình làm việc để quản lý các hệ thống bên ngoài.

Máy chủ Railway MCP chạy trên cơ sở hạ tầng của Railway. Lệnh railway mcp kết nối với nó qua stdio và đính kèm thông tin xác thực từ phiên railway login của bạn vào mỗi yêu cầu. Các trình soạn thảo hỗ trợ OAuth kết nối trực tiếp thay thế.

Điều kiện tiên quyết

Kết nối với máy chủ Railway MCP yêu cầu tài khoản Railway. Kết nối CLI mặc định cũng yêu cầu Railway CLI đã cài đặt và phiên railway login để có thể tái sử dụng các thông tin xác thực đó. OAuth không yêu cầu CLI.

Ví dụ sử dụng

Sử dụng các lời nhắc mô tả kết quả Railway mà bạn muốn agent tạo ra.

• Tạo và triển khai ứng dụng mới

  Create a Next.js app in this directory and deploy it to Railway.
  Also assign it a domain.
  

• Triển khai từ mẫu

  Deploy a Postgres database
  

• Kéo biến môi trường

  Pull environment variables for my project and save them to a .env file
  

• Gỡ lỗi triển khai thất bại (sử dụng công cụ railway-agent)

  Use the railway agent to figure out why my backend service is
  crashing on deploy
  

• Triển khai lại dịch vụ

  Redeploy my api service in the production environment
  

• Quản lý cờ tính năng

  List feature flags for project <projectId>
  

  Set the checkout-v2 feature flag to true on project <projectId>
  

Các công cụ MCP có sẵn

Máy chủ Railway MCP cung cấp các công cụ sau. Trợ lý AI của bạn chọn công cụ dựa trên yêu cầu của bạn. Sử dụng railway-agent cho các thao tác nhiều bước.

• Tài khoản
  • whoami
• Dự án
  • list-projects, create-project, list-services
• Cờ tính năng
  • list-feature-flags, get-feature-flag
  • set-feature-flag, delete-feature-flag (quản trị; xóa phá hủy được đánh dấu ở cấp giao thức)
• Triển khai
  • redeploy
  • accept-deploy: cam kết các thay đổi đã sắp xếp và triển khai (phá hủy; máy khách nhắc xác nhận)
• Agent
  • railway-agent: chuyển yêu cầu ngôn ngữ tự nhiên cho agent AI của Railway cho các thao tác nhiều bước như phân tích nhật ký, gỡ lỗi và cấu hình dịch vụ

Chạy máy chủ cục bộ

CLI cũng đi kèm một máy chủ MCP trong tiến trình cho các máy không thể truy cập mcp.railway.com, ví dụ trên các mạng hạn chế egress. Khởi động nó bằng railway mcp local hoặc ghi cấu hình cho các trình soạn thảo được hỗ trợ bằng railway mcp install --local. Nó nói chuyện trực tiếp với API Railway bằng thông tin xác thực CLI của bạn, đánh dấu các công cụ phá hủy bằng gợi ý cấp giao thức và trả về bản xem trước trước khi yêu cầu confirm: true.

Máy chủ cục bộ cung cấp một bộ công cụ khác với mcp.railway.com:

• Tài khoản: whoami
• Dự án và dịch vụ: list_workspaces, list_projects, create_project, list_services, create_service, remove_service, connect_service_source, disconnect_service_source, link_service, get_service_config, update_service và scale_service
• Môi trường và triển khai: create_environment, link_environment, environment_status, list_deployments và deploy
• Biến: list_variables, set_variables và add_reference_variable
• Tên miền: generate_domain, list_domains, domain_status, update_domain, delete_domain và retry_domain_certificate
• Mạng: list_tcp_proxies, get_tcp_proxy, create_tcp_proxy, remove_tcp_proxy, private_network_status và private_network_update
• Mẫu: search_templates và deploy_template
• Lưu trữ: create_bucket, remove_bucket, create_volume, update_volume và remove_volume
• Quan sát: get_logs, service_metrics, http_requests, http_error_rate và http_response_time
• Tài liệu: docs_search và docs_fetch

Cân nhắc bảo mật

Máy chủ Railway MCP gọi các API Railway thay mặt bạn. Hãy ghi nhớ những điểm sau:

• Xác thực CLI. Lệnh railway mcp đọc và làm mới thông tin xác thực railway login của bạn. Cấu hình trình soạn thảo không chứa thông tin xác thực Railway dài hạn.
• Phạm vi OAuth. Với OAuth, bạn chọn không gian làm việc và dự án mà máy khách có thể truy cập. Token có thời hạn ngắn và có thể thu hồi từ cài đặt tài khoản Railway của bạn.
• Các hành động phá hủy được đánh dấu ở cấp giao thức. Các máy khách tôn trọng các gợi ý này sẽ nhắc xác nhận.
• Token dự án không được chấp nhận. Máy chủ yêu cầu danh tính người dùng cho mục đích thanh toán và kiểm toán.

Bạn vẫn nên:

• Xem xét các hành động do LLM yêu cầu trước khi phê duyệt, đặc biệt là các hành động phá hủy (redeploy, accept-deploy, railway-agent và các công cụ remove_service, delete_domain, remove_tcp_proxy, remove_bucket và remove_volume của máy chủ cục bộ).
• Hạn chế quyền truy cập để chỉ những người dùng đáng tin cậy mới có thể gọi máy chủ MCP.
• Tránh rủi ro sản xuất bằng cách giới hạn việc sử dụng trong các môi trường không quan trọng khi có thể.

Yêu cầu tính năng

Chia sẻ yêu cầu tính năng trên bài đăng Railway MCP Server Central Station.