Railway MCP

resmi

Railway MCP Sunucusu, Railway projeleriniz ve altyapınızla doğal dil etkileşimi sağlar. IDE'nize veya yapay zeka asistanınıza proje oluşturma, şablon dağıtma, ortamları yönetme, değişkenleri çekme, hizmetleri yeniden dağıtma ve daha fazlasını yapmasını söyleyebilirsiniz.

Railway MCP ile neler yapabilirsiniz?

  • Projeler oluşturun ve dağıtın — Asistanınızdan yeni bir proje oluşturmasını veya Railway'e Postgres veritabanı gibi bir şablon dağıtmasını isteyin.
  • Ortam değişkenlerini alın — Bir projenin ortam değişkenlerini alın ve yerel bir .env dosyasına kaydedin.
  • Hizmetleri yeniden dağıtın — Asistandan seçilen bir ortamda belirli bir hizmeti yeniden dağıtmasını isteyin.
  • Başarısız dağıtımlarda hata ayıklayın — Çöken bir hizmetin günlüklerini analiz etmek gibi çok adımlı sorun giderme işlemlerini Railway'in yapay zekâ aracısına devredin.
  • Özellik bayraklarını yönetin — Bir proje için özellik bayraklarını listeleyin, alın, ayarlayın veya silin.
  • Bulut aracısı görevlerini çalıştırın — Bulut aracısı görevlerini başlatın, kontrol edin, yanıtlayın veya iptal edin ve konuşma dökümlerini alın.

Barındırılan MCP Sunucusu

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

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Railway MCP Sunucusu, Model Context Protocol (MCP) protokolünü uygular. Yapay zekâ asistanlarının projeler oluşturmasına, şablonları dağıtmasına, ortamları yönetmesine, değişkenleri çekmesine ve hizmetleri yeniden dağıtmasına olanak tanır.

Sunucu mcp.railway.com adresinde çalışır. İki yoldan biriyle bağlanın:

  • CLI üzerinden (varsayılan). railway mcp komutu, düzenleyicinizi Railway CLI üzerinden mcp.railway.com adresine bağlar ve railway login kimlik bilgilerinizi yeniden kullanarak ikinci bir kimlik doğrulama gereksinimini ortadan kaldırır.
  • OAuth ile. OAuth'u destekleyen düzenleyiciler, CLI olmadan doğrudan https://mcp.railway.com adresine bağlanır.

Not: CLI üzerinden bağlanmak için CLI sürümünün 5.44.0 veya üzeri olması gerekir.

Hızlı başlangıç

Railway CLI'yi yükleyin ve aracı becerilerini, MCP'yi ve kimlik doğrulamayı tek bir komutla yapılandırın. Kurulum komutunu oluşturmak için seçenekleri belirleyin:

CLI zaten yüklüyse başlangıç adımını atlayıp şu komutu çalıştırın:

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

Düzenleyici başına manuel yapılandırma, kullanılabilir araç listesi ve güvenlik konuları için okumaya devam edin.

Düzenleyici başına yapılandırma

Bir düzenleyiciyi manuel olarak yapılandırmayı tercih ediyorsanız veya railway mcp install komutunun neler yazdığını incelemek istiyorsanız, CLI bağlantısı, OAuth ve sunucuyu yerel olarak çalıştırma arasında geçiş yapmak için seçiciyi kullanın:

railway mcp install, diğer MCP sunucularını kaldırmadan Railway sunucu girdisini mevcut yapılandırmalara ekler. Güncellemek için komutu istediğiniz zaman yeniden çalıştırın.

MCP'yi anlama

Model Context Protocol (MCP), yapay zekâ uygulamalarının (ana bilgisayarların) istemci-sunucu mimarisi aracılığıyla harici araçlarla ve veri kaynaklarıyla nasıl etkileşim kurabileceğini tanımlayan bir standarttır.

  • Ana bilgisayarlar: MCP sunucularına bağlanan Cursor, VS Code, Claude Code veya Windsurf gibi uygulamalar.
  • İstemciler: Ana bilgisayarların içinde, her bir MCP sunucusuyla bire bir bağlantıları sürdüren katman.
  • Sunucular: Harici sistemleri yönetmeye yönelik araçları ve iş akışlarını sunan bağımsız programlar (Railway MCP Sunucusu gibi).

Railway MCP sunucusu Railway'in altyapısında çalışır. railway mcp komutu, sunucuya stdio üzerinden bağlanır ve her isteğe railway login oturumunuzun kimlik bilgilerini ekler. OAuth'u destekleyen düzenleyiciler bunun yerine doğrudan bağlanır.

Ön koşullar

Railway MCP sunucusuna bağlanmak için bir Railway hesabı gerekir. Varsayılan CLI bağlantısı ayrıca yüklü bir Railway CLI ve bu kimlik bilgilerini yeniden kullanabilmesi için bir railway login oturumu gerektirir. OAuth için CLI gerekmez.

Kullanım örnekleri

Aracı, gerçekleştirmesini istediğiniz Railway işlemini açıklayan istemlerle yönlendirin.

  • Yeni bir uygulama oluşturup dağıtma

    Create a Next.js app in this directory and deploy it to Railway.
    Also assign it a domain.
    
  • Bir şablondan dağıtma

    Deploy a Postgres database
    
  • Ortam değişkenlerini çekme

    Pull environment variables for my project and save them to a .env file
    
  • Başarısız bir dağıtımda hata ayıklama (railway-agent aracını kullanır)

    Use the railway agent to figure out why my backend service is
    crashing on deploy
    
  • Bir hizmeti yeniden dağıtma

    Redeploy my api service in the production environment
    
  • Özellik bayraklarını yönetme

    List feature flags for project <projectId>
    
    Set the checkout-v2 feature flag to true on project <projectId>
    

Kullanılabilir MCP araçları

Railway MCP Sunucusu aşağıdaki araçları sunar. Yapay zekâ asistanınız, isteğinize göre araçları seçer. Çok adımlı işlemler için railway-agent kullanın.

  • Hesap
    • whoami
  • Projeler
    • list-projects, create-project, list-services
  • Özellik bayrakları
    • list-feature-flags, get-feature-flag
    • set-feature-flag, delete-feature-flag (yönetici; yıkıcı silme işlemi protokol düzeyinde işaretlenir)
  • Dağıtımlar
    • redeploy
    • accept-deploy: hazırlanan değişiklikleri kaydedip dağıtma (yıkıcı; istemciler onay ister)
  • Aracı
    • railway-agent: günlük analizi, hata ayıklama ve hizmet yapılandırması gibi çok adımlı işlemler için doğal dildeki bir isteği Railway'in yapay zekâ aracısına iletme
  • Bulut aracısı görevleri (Görevler bölümüne bakın)
    • run-cloud-agent-task: işi bir bulut aracısına devretme (yeni bir aracı başlatma ücretlendirilir; istemciler onay ister)
    • check-cloud-agent-task, list-cloud-agent-tasks, get-cloud-agent-transcript
    • respond-cloud-agent-task, cancel-cloud-agent-task
    • list-cloud-agent-models

Sunucuyu yerel olarak çalıştırma

CLI, örneğin dışa giden bağlantıların kısıtlandığı ağlarda mcp.railway.com adresine erişemeyen makineler için işlem içi bir MCP sunucusu da içerir. Sunucuyu railway mcp local ile başlatın veya desteklenen düzenleyiciler için yapılandırmayı railway mcp install --local ile yazın. Sunucu, CLI kimlik bilgilerinizi kullanarak doğrudan Railway API'siyle iletişim kurar, yıkıcı araçları protokol düzeyindeki ipuçlarıyla işaretler ve confirm: true gerektirmeden önce bir önizleme sunar.

Yerel sunucu, mcp.railway.com sunucusundan farklı bir araç kümesi sunar:

  • Hesap: whoami
  • Projeler ve hizmetler: 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 ve scale_service
  • Ortamlar ve dağıtımlar: create_environment, link_environment, environment_status, list_deployments ve deploy
  • Değişkenler: list_variables, set_variables ve add_reference_variable
  • Alan adları: generate_domain, list_domains, domain_status, update_domain, delete_domain ve retry_domain_certificate
  • Ağ iletişimi: list_tcp_proxies, get_tcp_proxy, create_tcp_proxy, remove_tcp_proxy, private_network_status ve private_network_update
  • Şablonlar: search_templates ve deploy_template
  • Depolama: create_bucket, remove_bucket, create_volume, update_volume ve remove_volume
  • Gözlemlenebilirlik: get_logs, service_metrics, http_requests, http_error_rate ve http_response_time
  • Belgeler: docs_search ve docs_fetch

Güvenlik konuları

Railway MCP Sunucusu, sizin adınıza Railway API'lerini çağırır. Şu noktaları göz önünde bulundurun:

  • CLI kimlik doğrulaması. railway mcp komutu, railway login kimlik bilgilerinizi okur ve yeniler. Düzenleyici yapılandırması uzun ömürlü bir Railway kimlik bilgisi içermez.
  • OAuth kapsamı. OAuth ile istemcinin erişebileceği çalışma alanlarını ve projeleri siz seçersiniz. Belirteçlerin ömrü kısadır ve Railway hesap ayarlarınızdan iptal edilebilir.
  • Yıkıcı işlemler protokol düzeyinde işaretlenir. Bu ipuçlarına uyan istemciler onay ister.
  • Proje belirteçleri kabul edilmez. Sunucu, faturalandırma ve denetim kayıtları için kullanıcı kimliği gerektirir.

Yine de şunları yapmalısınız:

  • İşlemleri gözden geçirin: LLM'nin istediği işlemleri onaylamadan önce, özellikle yıkıcı olanları (redeploy, accept-deploy, railway-agent ve yerel sunucunun remove_service, delete_domain, remove_tcp_proxy, remove_bucket ve remove_volume işlemlerini) inceleyin.
  • Erişimi kısıtlayın: MCP sunucusunu yalnızca güvenilir kullanıcıların çağırabilmesini sağlayın.
  • Üretim risklerinden kaçının: Mümkün olduğunda kullanımı kritik olmayan ortamlarla sınırlayın.

Özellik istekleri

Özellik isteklerinizi Railway MCP Server Central Station gönderisinde paylaşın.