Railway MCP

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

Railway предлагает два MCP-сервера:

• Локальный MCP работает через Railway CLI на вашей машине и использует локальный контекст CLI.
• Удалённый MCP работает по адресу mcp.railway.com. Подключайтесь напрямую через OAuth или запустите railway mcp proxy, чтобы переиспользовать учётные данные из вашей railway login сессии.

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

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

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

railway setup agent                  # Local MCP
railway setup agent --remote         # Remote MCP through the CLI proxy
railway setup agent --remote --oauth # Remote MCP with OAuth

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

Настройка для каждого редактора

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

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

Понимание MCP

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

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

Локальный MCP-сервер преобразует запросы на естественном языке в рабочие процессы CLI на основе Railway CLI. Удалённый MCP работает на инфраструктуре Railway и поддерживает OAuth. Прокси CLI предоставляет ещё один путь подключения, передавая учётные данные из вашей railway login сессии в удалённый MCP.

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

Сервер и метод аутентификации определяют, какие локальные инструменты и учётные данные вам нужны.

• Локальный MCP требует установленный и аутентифицированный Railway CLI.
• Удалённый MCP требует учётную запись Railway. Прямой OAuth не требует CLI. Прокси CLI требует установленный CLI и railway login сессию, чтобы переиспользовать эти учётные данные.

Примеры использования

Используйте подсказки, описывающие желаемый результат в 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 предоставляет следующие инструменты. Ваш ИИ-ассистент выбирает инструменты на основе вашего запроса.

Локальный MCP

Локальный MCP работает через Railway CLI и предоставляет эти инструменты:

• Учётная запись: 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

Удалённый MCP

Удалённый 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 для многошаговых операций, таких как анализ журналов, отладка и настройка сервисов

Вопросы безопасности

Сервер Railway MCP выполняет команды CLI или вызывает API Railway от вашего имени. Локальный MCP помечает разрушающие инструменты подсказками на уровне протокола и возвращает предварительный просмотр перед запросом confirm: true. Вам следует:

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

Для удалённого MCP:

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

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

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