Railway MCP

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

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

Сервер работает на 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

Model Context Protocol (MCP) определяет стандарт того, как AI-приложения (хосты) могут взаимодействовать с внешними инструментами и источниками данных через клиент-серверную архитектуру.

• Хосты: Приложения, такие как Cursor, VS Code, Claude Code или Windsurf, которые подключаются к MCP-серверам.
• Клиенты: Слой внутри хостов, который поддерживает одно-к-одному соединения с отдельными MCP-серверами.
• Серверы: Автономные программы (например, Railway MCP Server), которые предоставляют инструменты и рабочие процессы для управления внешними системами.

Сервер Railway MCP работает на инфраструктуре Railway. Команда railway mcp подключается к нему через stdio и прикрепляет учетные данные из вашей сессии railway login к каждому запросу. Редакторы, поддерживающие OAuth, подключаются напрямую.

Предварительные требования

Для подключения к серверу Railway MCP требуется Railway account. Подключение через 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 предоставляет следующие инструменты. Ваш 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: передать запрос на естественном языке AI-агенту Railway для многошаговых операций, таких как анализ логов, отладка и настройка сервисов

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

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

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

Делитесь запросами функций в Railway MCP Server Central Station post.