Railway MCP

Máy chủ Railway MCP triển khai Model Context Protocol (MCP). Nó cho phép 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ụ.

Railway cung cấp hai máy chủ MCP:

• Local MCP chạy thông qua Railway CLI trên máy của bạn và sử dụng ngữ cảnh CLI cục bộ.
• Remote MCP chạy tại mcp.railway.com. Kết nối trực tiếp bằng OAuth, hoặc chạy railway mcp proxy để tái sử dụng thông tin xác thực từ phiên railway login của bạ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. Chọn các tùy chọn để tạo lệnh thiết lập:

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

railway setup agent                  # Local MCP
railway setup agent --remote         # Remote MCP through the CLI proxy
railway setup agent --remote --oauth # Remote MCP 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 stdio cục bộ, Remote MCP qua proxy CLI và Remote MCP với OAuth:

railway mcp install hợp nhất mục nhập máy chủ Railway vào 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

Model Context Protocol (MCP) định nghĩa một tiêu chuẩn cho cách các ứng dụng AI (host) 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ủ.

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

Máy chủ Local MCP dịch các yêu cầu ngôn ngữ tự nhiên thành quy trình CLI được hỗ trợ bởi Railway CLI. Remote MCP chạy trên hạ tầng của Railway và hỗ trợ OAuth. Proxy CLI cung cấp một đường kết nối khác bằng cách chuyển thông tin xác thực từ phiên railway login của bạn đến Remote MCP.

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

Máy chủ và phương thức xác thực quyết định bạn cần những công cụ cục bộ và thông tin xác thực nào.

• Local MCP yêu cầu Railway CLI đã được cài đặt và xác thực.
• Remote MCP yêu cầu tài khoản Railway. OAuth trực tiếp không yêu cầu CLI. Proxy CLI yêu cầu 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 đó.

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 (công cụ railway-agent chỉ dành cho remote)

  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

Railway MCP Server cung cấp các công cụ sau. Trợ lý AI của bạn sẽ chọn công cụ dựa trên yêu cầu của bạn.

Local MCP

Local MCP chạy thông qua Railway CLI và cung cấp các công cụ sau:

• 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

Remote MCP

Remote MCP cung cấp các công cụ sau. 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 đã lưu 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 để 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ụ

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

Railway MCP Server chạy các lệnh CLI hoặc gọi API Railway thay mặt bạn. Local MCP đá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. 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 (remove_service, delete_domain, remove_tcp_proxy, remove_bucket, remove_volume, redeploy, accept-deploy, và railway-agent).
• Hạn chế quyền truy cập để đảm bảo chỉ 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 hạn chế sử dụng trong các môi trường không quan trọng khi có thể.

Đối với Remote MCP:

• Xác thực proxy CLI. Proxy đọ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 trực tiếp, 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. Remote MCP yêu cầu danh tính người dùng cho mục đích thanh toán và nhật ký kiểm toán.

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.