Railway MCP

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

Railway MCP Server triển khai Model Context Protocol (MCP). Máy chủ cho phép trợ lý AI tạo dự án, triển khai mẫu, quản lý môi trường, tải biến xuống và triển khai lại dịch vụ.

Máy chủ chạy tại mcp.railway.com. Kết nối 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, sử dụng lại thông tin xác thực railway login để không cần xác thực lần thứ hai.
• Bằng 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 thông 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 các kỹ năng của tác nhân, MCP và xác thực bằng một lệnh. 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 để xem cấu hình thủ công cho từng trình soạn thảo, danh sách công cụ hiện có và các lưu ý về bảo mật.

Cấu hình cho từng trình soạn thảo

Nếu bạn muốn tự cấu hình trình soạn thảo hoặc muốn kiểm tra nội dung mà railway mcp install ghi, hãy 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 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 lệnh này bất cứ lúc nào để cập nhật.

Tìm hiểu về MCP

Model Context Protocol (MCP) xác định một tiêu chuẩn về cách các ứng dụng AI (máy chủ) 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ủ: Các ứng dụng như Cursor, VS Code, Claude Code hoặc Windsurf kết nối với máy chủ MCP.
• Máy khách: Lớp bên trong máy chủ duy trì các kết nối một-một với từng máy chủ MCP.
• Máy chủ MCP: Các chương trình độc lập (như Railway MCP Server) cung cấp 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 hạ tầng của Railway. Lệnh railway mcp kết nối với máy chủ 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 sẽ kết nối trực tiếp.

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

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

Ví dụ sử dụng

Dùng các câu lệnh mô tả kết quả Railway mà bạn muốn tác nhân 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
  

• Tải biến môi trường xuống

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

• Gỡ lỗi một lần triển khai bị lỗ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 hiện có

Railway MCP Server cung cấp các công cụ sau. Trợ lý AI sẽ chọn công cụ dựa trên yêu cầu của bạn. 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ị viên; thao tác xóa có tính phá hủy được đánh dấu ở cấp giao thức)
• Lần triển khai
  • redeploy
  • accept-deploy: xác nhận các thay đổi đã chuẩn bị và triển khai (có tính phá hủy; máy khách yêu cầu xác nhận)
• Tác nhân
  • railway-agent: chuyển yêu cầu bằng ngôn ngữ tự nhiên cho tác nhân AI của Railway để thực hiện 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ụ
• Tác vụ của tác nhân đám mây (xem Tác vụ)
  • run-cloud-agent-task: giao việc cho tác nhân đám mây (khởi chạy tác nhân mới sẽ bị tính phí; máy khách yêu cầu xác nhận)
  • check-cloud-agent-task, list-cloud-agent-tasks, get-cloud-agent-transcript
  • respond-cloud-agent-task, cancel-cloud-agent-task
  • list-cloud-agent-models

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

CLI cũng đi kèm một máy chủ MCP chạy trong tiến trình dành cho các máy không thể truy cập mcp.railway.com, chẳng hạn như trên các mạng bị hạn chế lưu lượng đi ra. Khởi chạy 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. Máy chủ giao tiếp trực tiếp với Railway API bằng thông tin xác thực CLI của bạn, đánh dấu các công cụ có tính 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 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à lần 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
• Khả năng 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

Lưu ý về bảo mật

Railway MCP Server gọi Railway API thay mặt bạn. Hãy lưu ý 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 có thời hạn dài.
• Phạm vi OAuth. Với OAuth, bạn chọn những không gian làm việc và dự án mà máy khách có thể truy cập. Mã thông báo có thời hạn ngắn và có thể thu hồi trong phần cài đặt tài khoản Railway.
• Các thao tác có tính phá hủy được đánh dấu ở cấp giao thức. Máy khách hỗ trợ các gợi ý này sẽ yêu cầu xác nhận.
• Không chấp nhận mã thông báo dự án. Máy chủ yêu cầu danh tính người dùng để phục vụ việc tính phí và lưu vết kiểm toán.

Bạn vẫn nên:

• Xem xét các thao tác mà LLM yêu cầu trước khi phê duyệt, đặc biệt là các thao tác có tính phá hủy (redeploy, accept-deploy, railway-agent và 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ỉ người dùng đáng tin cậy mới có thể gọi máy chủ MCP.
• Tránh rủi ro cho môi trường production bằng cách giới hạn việc sử dụng ở các môi trường không trọng yếu khi có thể.

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

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