Railway MCP

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

Сервер Railway MCP реализует протокол контекста модели (MCP). Он позволяет ИИ-ассистентам создавать проекты, развёртывать шаблоны, управлять окружениями, получать переменные и повторно развёртывать сервисы.

Сервер работает по адресу mcp.railway.com. Подключиться к нему можно одним из двух способов:

• Через CLI (по умолчанию). Команда railway mcp подключает ваш редактор к mcp.railway.com через Railway CLI, повторно используя ваши учётные данные railway login, поэтому дополнительная аутентификация не требуется.
• Через OAuth. Редакторы с поддержкой OAuth подключаются напрямую к https://mcp.railway.com без CLI.

Примечание: для подключения через CLI требуется версия CLI 5.44.0 или новее.

Быстрый старт

Установите Railway CLI и настройте навыки агента, MCP и аутентификацию одной командой. Выберите параметры, чтобы сформировать команду настройки:

Если CLI уже установлен, пропустите начальную настройку и выполните:

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

Читайте дальше, чтобы узнать о ручной настройке для отдельных редакторов, доступных инструментах и мерах безопасности.

Настройка для отдельных редакторов

Если вы предпочитаете настроить редактор вручную или хотите проверить, что записывает railway mcp install, воспользуйтесь переключателем, чтобы выбрать подключение через CLI, OAuth или локальный запуск сервера:

railway mcp install добавляет запись сервера Railway в существующие конфигурации, не удаляя другие MCP-серверы. Запускайте команду повторно в любое время, чтобы обновить конфигурацию.

Что такое MCP

Протокол контекста модели (MCP) определяет стандарт взаимодействия ИИ-приложений (хостов) с внешними инструментами и источниками данных на основе архитектуры клиент-сервер.

• Хосты: приложения, такие как Cursor, VS Code, Claude Code или Windsurf, которые подключаются к MCP-серверам.
• Клиенты: уровень внутри хостов, поддерживающий отдельные подключения к каждому MCP-серверу.
• Серверы: автономные программы (например, 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 предоставляет следующие инструменты. ИИ-ассистент выбирает инструменты в зависимости от вашего запроса. Для многоэтапных операций используйте 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 для выполнения многоэтапных операций, таких как анализ журналов, отладка и настройка сервисов
• Задачи облачного агента (см. раздел Задачи)
  • run-cloud-agent-task: передать работу облачному агенту (запуск нового агента тарифицируется; клиенты запрашивают подтверждение)
  • check-cloud-agent-task, list-cloud-agent-tasks, get-cloud-agent-transcript
  • respond-cloud-agent-task, cancel-cloud-agent-task
  • list-cloud-agent-models

Локальный запуск сервера

В CLI также входит встроенный MCP-сервер для компьютеров, которые не могут подключиться к mcp.railway.com, например в сетях с ограниченным исходящим трафиком. Запустите его командой railway mcp local или создайте конфигурацию для поддерживаемых редакторов с помощью railway mcp install --local. Сервер напрямую взаимодействует с API Railway, используя учётные данные CLI, помечает разрушительные инструменты подсказками на уровне протокола и показывает предварительный просмотр перед запросом 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 вызывает API Railway от вашего имени. Учитывайте следующее:

• Аутентификация через CLI. Команда railway mcp считывает и обновляет ваши учётные данные railway login. Конфигурация редактора не содержит долгосрочных учётных данных Railway.
• Область доступа OAuth. При использовании OAuth вы выбираете рабочие пространства и проекты, к которым клиент может получить доступ. Срок действия токенов ограничен; их можно отозвать в настройках учётной записи Railway.
• Разрушительные действия помечаются на уровне протокола. Клиенты, учитывающие эти подсказки, запрашивают подтверждение.
• Токены проектов не принимаются. Для выставления счетов и ведения аудита серверу требуется идентификатор пользователя.

Вам также следует:

• Проверять действия, запрошенные LLM, прежде чем подтверждать их, особенно разрушительные (redeploy, accept-deploy, railway-agent и remove_service, delete_domain, remove_tcp_proxy, remove_bucket и remove_volume локального сервера).
• Ограничивать доступ, чтобы вызывать MCP-сервер могли только доверенные пользователи.
• Снижать риски для production, по возможности ограничивая использование некритичными окружениями.

Запросы функций

Оставляйте запросы функций в публикации Центральная станция Railway MCP Server.