# Настройка Railway MCP сервера для Claude Desktop
## 🚀 Быстрая настройка
### 1. Получите Railway токен
1. Зайдите на [Railway](https://railway.app)
2. Войдите в аккаунт
3. Перейдите в **Account Settings** → **Tokens**
4. Создайте новый токен
5. Скопируйте токен (он понадобится для настройки)
### 2. Найдите конфигурационный файл Claude Desktop
#### macOS:
```bash
~/Library/Application\ Support/Claude/claude_desktop_config.json
```
#### Windows:
```bash
%APPDATA%/Claude/claude_desktop_config.json
```
### 3. Обновите конфигурацию
Откройте файл `claude_desktop_config.json` и добавьте следующую конфигурацию:
```json
{
"mcpServers": {
"railway": {
"command": "node",
"args": ["/Users/dk/Documents/Marvin/railway-mcp-server/dist/index.js"],
"env": {
"RAILWAY_TOKEN": "YOUR_RAILWAY_TOKEN_HERE"
}
}
}
}
```
**⚠️ Важно**: Замените путь в `args` на **абсолютный путь** к вашему проекту!
### 4. Перезапустите Claude Desktop
Закройте и перезапустите Claude Desktop, чтобы изменения вступили в силу.
## ✅ Проверка работы
После перезапуска Claude Desktop попробуйте следующие команды:
### Просмотр проектов
```
Покажи мне все мои Railway проекты
```
### Проверка деплоев
```
Покажи статус деплоев в проекте Marvin
```
### Просмотр логов
```
Покажи логи последнего деплоя backend сервиса
```
## 🛠️ Команды Railway MCP
| Команда | Описание |
|---------|----------|
| `Покажи все проекты` | Список всех Railway проектов |
| `Покажи проект {название}` | Детали конкретного проекта |
| `Покажи логи деплоя {id}` | Логи конкретного деплоя |
| `Перезапусти сервис {название}` | Перезапуск сервиса |
| `Отмени деплой {id}` | Отмена деплоя |
| `Установи переменную {название}={значение}` | Обновление переменной окружения |
## 🔧 Отладка
### Проблема: "Railway MCP server не найден"
1. **Проверьте путь**: Убедитесь, что путь в `args` абсолютный и правильный
2. **Проверьте сборку**: Запустите `npm run build` в папке проекта
3. **Проверьте токен**: Убедитесь, что Railway токен корректный
### Проблема: "Unauthorized"
1. **Проверьте токен**: Создайте новый токен в Railway
2. **Проверьте формат**: Токен должен быть в формате `railway_xxx`
### Проблема: "Module not found"
1. **Установите зависимости**: Запустите `npm install`
2. **Пересоберите проект**: Запустите `npm run build`
### Логи отладки
Запустите инспектор для отладки:
```bash
cd /Users/dk/Documents/Marvin/railway-mcp-server
npm run inspector
```
Откройте браузер по указанному URL для интерактивного тестирования.
## 📖 Примеры использования
### Мониторинг деплоев
```
Claude: Проверь статус всех моих деплоев и сообщи о проблемах
```
### Управление переменными
```
Claude: Обнови DATABASE_URL для production сервиса
```
### Анализ логов
```
Claude: Найди ошибки в логах последнего деплоя frontend
```
### Экстренные действия
```
Claude: Сервис не отвечает, перезапусти его немедленно
```
## 🔄 Обновление
Для обновления MCP сервера:
```bash
cd /Users/dk/Documents/Marvin/railway-mcp-server
git pull
npm install
npm run build
```
Затем перезапустите Claude Desktop.
---
**🎉 Готово!** Теперь Claude может управлять вашими Railway деплоями напрямую!
