Railway MCP Server

Railway MCP Server — это сервер Model Context Protocol (MCP), который позволяет взаимодействовать с вашими проектами и инфраструктурой Railway на естественном языке. Попросите вашу IDE или AI-ассистента создавать проекты, разворачивать шаблоны, управлять окружениями, получать переменные, перевыпускать сервисы и многое другое.

Railway предлагает два способа подключения:

• Локальный MCP — работает через Railway CLI на вашей машине. Рекомендуется для большинства сценариев с агентами кодирования, так как использует аутентификацию и контекст проекта CLI.
• Удалённый MCP — размещённая конечная точка mcp.railway.com. Не требует локальной установки или CLI; клиенты аутентифицируются через OAuth в браузере.

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

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

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

railway setup agent          # local MCP
railway setup agent --remote # remote MCP

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

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

Если вы предпочитаете подключить редактор вручную — или хотите увидеть, что именно записывает railway mcp install — используйте переключатель для выбора между локальной конфигурацией stdio и удалённой HTTP-конфигурацией:

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

Понимание MCP

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

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

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

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

• Локальный MCP — установите и аутентифицируйте Railway CLI.
• Удалённый MCP — учётная запись 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
  

Доступные инструменты MCP

Railway MCP Server предоставляет тщательно отобранный набор инструментов. Ваш AI-ассистент вызывает их автоматически в зависимости от контекста вашего запроса.

Локальный MCP

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

• Статус
  • check-railway-status — проверить установку CLI и аутентификацию
• Проекты и сервисы
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — развернуть сервис
  • deploy-template — развернуть из Библиотеки шаблонов Railway
• Окружения
  • create-environment, link-environment
• Конфигурация
  • list-variables, set-variables
  • generate-domain
• Наблюдаемость
  • get-logs

Удалённый MCP

Удалённый сервер предоставляет сфокусированный набор инструментов плюс мощную точку входа агента. Для всего сложного делегируйте railway-agent.

• Учётная запись
  • whoami
• Проекты
  • list-projects, create-project, list-services
• Развёртывания
  • redeploy
  • accept-deploy — зафиксировать поэтапные изменения и развернуть (разрушающее действие; клиенты запрашивают подтверждение)
• Агент
  • railway-agent — передать запрос на естественном языке AI-агенту Railway для многошаговых операций, таких как анализ логов, отладка и конфигурация сервисов

Соображения безопасности

Railway MCP Server выполняет команды CLI или вызывает API Railway от вашего имени. Разрушающие операции намеренно исключены из списка инструментов локального сервера, но вам всё равно следует:

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

Для удалённого сервера особенно:

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

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

Railway MCP Server находится в разработке. Мы активно добавляем новые инструменты и функции. Если у вас есть запрос на функцию, оставьте свой отзыв в этом посте Central Station.