Railway MCP

公式

Railway MCP Serverを使用すると、Railwayのプロジェクトやインフラストラクチャに対して自然言語で操作できます。IDEやAIアシスタントに指示して、プロジェクトの作成、テンプレートのデプロイ、環境の管理、変数の取得、サービスの再デプロイなどを行うことができます。

railway.com で表示このMCPを試すスポンサー

Railway MCPで何ができますか？

  • プロジェクトの作成とデプロイ — create-project と deploy_template を使用して、新規プロジェクトの作成や Postgres などのテンプレートのデプロイを依頼します。
  • 環境変数の管理 — list_variables と set_variables を使用して、変数を .env ファイルにプルしたり、環境ごとに設定したりします。
  • サービスの再デプロイまたはデバッグ — redeploy で再デプロイをトリガーするか、railway-agent を使用してサービスがクラッシュする原因を診断します。
  • フィーチャーフラグの制御 — list-feature-flags と set-feature-flag を使用して、checkout-v2 などのフラグを一覧表示、表示、または切り替えます。
  • ドメインとネットワーキングの処理 — generate_domain でドメインを生成するか、TCP プロキシとプライベートネットワークを管理します。
  • サービスのスケーリングと設定 — update_service と scale_service を使用して、サービス設定を更新したり、インスタンスをスケーリングしたりします。

ホスト型 MCP サーバー

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

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

Railway MCP Serverは、Model Context Protocol (MCP)を実装しています。これにより、AIアシスタントがプロジェクトの作成、テンプレートのデプロイ、環境の管理、変数の取得、サービスの再デプロイを行うことができます。

サーバーはmcp.railway.comで実行されます。次の2つの方法のいずれかで接続できます：

  • CLI経由（デフォルト）。railway mcpコマンドは、Railway CLIを通じてエディタをmcp.railway.comに接続し、railway loginの認証情報を再利用するため、追加の認証は不要です。
  • OAuthを使用。OAuthをサポートするエディタは、CLIなしでhttps://mcp.railway.comに直接接続します。

注： CLI経由で接続するには、CLIバージョン5.44.0以降が必要です。

クイックスタート

Railway CLIをインストールし、エージェントスキル、MCP、認証を1つのコマンドで設定します。セットアップコマンドを生成するオプションを選択してください：

CLIがすでにインストールされている場合は、ブートストラップをスキップして次を実行します：

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

エディタごとの手動設定、利用可能なツール一覧、セキュリティに関する考慮事項については、以下をお読みください。

エディタごとの設定

エディタを手動で設定したい場合、またはrailway mcp installが書き込む内容を確認したい場合は、セレクタを使用してCLI接続、OAuth、サーバーをローカルで実行の間で切り替えてください：

railway mcp installは、他のMCPサーバーを削除せずに、Railwayサーバーのエントリを既存の設定にマージします。更新が必要な場合はいつでも再実行できます。

MCPについて

Model Context Protocol (MCP) は、AIアプリケーション（ホスト）がクライアント・サーバーアーキテクチャを通じて外部ツールやデータソースと対話する方法の標準を定義します。

  • ホスト：Cursor、VS Code、Claude Code、Windsurfなど、MCPサーバーに接続するアプリケーション。
  • クライアント：ホスト内のレイヤーで、個々のMCPサーバーとの1対1の接続を維持します。
  • サーバー：外部システムを管理するためのツールとワークフローを公開するスタンドアロンプログラム（Railway MCP Serverなど）。

Railway MCPサーバーはRailwayのインフラストラクチャ上で実行されます。railway mcpコマンドはstdio経由で接続し、各リクエストにrailway loginセッションの認証情報を添付します。OAuthをサポートするエディタは、代わりに直接接続します。

前提条件

Railway MCPサーバーに接続するには、Railwayアカウントが必要です。デフォルトのCLI接続では、インストール済みのRailway CLIとrailway loginセッションも必要です（認証情報を再利用するため）。OAuthではCLIは不要です。

使用例

エージェントに生成させたいRailwayの成果を説明するプロンプトを使用してください。

  • 新しいアプリを作成してデプロイ

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

  • テンプレートからデプロイ

    Deploy a Postgres database

  • 環境変数を取得

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

  • 失敗したデプロイをデバッグ（railway-agentツールを使用）

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

  • サービスを再デプロイ

    Redeploy my api service in the production environment

  • フィーチャーフラグを管理

    List feature flags for project <projectId>

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

利用可能なMCPツール

Railway MCP Serverは以下のツールを公開しています。AIアシスタントはリクエストに基づいてツールを選択します。複数ステップの操作にはrailway-agentを使用してください。

  • アカウント
    • whoami
  • プロジェクト
    • list-projects、create-project、list-services
  • フィーチャーフラグ
    • list-feature-flags、get-feature-flag
    • set-feature-flag、delete-feature-flag（管理者用。破壊的な削除はプロトコルレベルでマークされます）
  • デプロイ
    • redeploy
    • accept-deploy：ステージングされた変更をコミットしてデプロイ（破壊的。クライアントは確認を求めます）
  • エージェント
    • railway-agent：ログ分析、デバッグ、サービス設定などの複数ステップ操作をRailwayのAIエージェントに自然言語リクエストとして渡します

サーバーをローカルで実行

CLIには、mcp.railway.comに到達できないマシン（たとえば、送信制限のあるネットワーク上）向けのインプロセスMCPサーバーも同梱されています。railway mcp localで起動するか、railway mcp install --localでサポートされているエディタの設定を書き込みます。CLIの認証情報を使用してRailway APIに直接通信し、破壊的なツールをプロトコルレベルのヒントでマークし、confirm: trueを要求する前にプレビューを返します。

ローカルサーバーはmcp.railway.comとは異なるツールセットを公開します：

  • アカウント： whoami
  • プロジェクトとサービス： 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、scale_service
  • 環境とデプロイ： create_environment、link_environment、 environment_status、list_deployments、deploy
  • 変数： list_variables、set_variables、 add_reference_variable
  • ドメイン： generate_domain、list_domains、domain_status、 update_domain、delete_domain、retry_domain_certificate
  • ネットワーキング： list_tcp_proxies、get_tcp_proxy、create_tcp_proxy、 remove_tcp_proxy、private_network_status、private_network_update
  • テンプレート： search_templates、deploy_template
  • ストレージ： create_bucket、remove_bucket、create_volume、 update_volume、remove_volume
  • 可観測性： get_logs、service_metrics、http_requests、 http_error_rate、http_response_time
  • ドキュメント： docs_search、docs_fetch

セキュリティに関する考慮事項

Railway MCP Serverは、お客様に代わってRailway APIを呼び出します。次の点に注意してください：

  • CLI認証。 railway mcpコマンドは、railway loginの認証情報を読み取り、更新します。エディタの設定には、長期有効なRailway認証情報は含まれません。
  • OAuthスコープ。 OAuthでは、クライアントがアクセスできるワークスペースとプロジェクトを選択できます。トークンは短期間有効で、Railwayアカウント設定から取り消すことができます。
  • 破壊的な操作はプロトコルレベルでマークされます。これらのヒントを尊重するクライアントは、確認を求めます。
  • プロジェクトトークンは受け付けられません。 サーバーは、請求と監査証跡のためにユーザーIDを必要とします。

また、次のことを行う必要があります：

  • 操作を確認：LLMが要求した操作を承認する前に確認します。特に破壊的な操作（redeploy、accept-deploy、railway-agent、およびローカルサーバーのremove_service、delete_domain、remove_tcp_proxy、remove_bucket、remove_volume）を確認します。
  • アクセスを制限：信頼できるユーザーのみがMCPサーバーを呼び出せるようにします。
  • 本番環境のリスクを回避：可能な限り、重要でない環境での使用に制限します。

フィーチャーリクエスト

フィーチャーリクエストは、Railway MCP Server Central Stationの投稿で共有してください。