Railway MCP Server

Railway MCP Sunucusu, Railway projeleriniz ve altyapınızla doğal dilde etkileşim kurmanızı sağlayan bir Model Bağlam Protokolü (MCP) sunucusudur. IDE'nize veya yapay zeka asistanınıza projeler oluşturmasını, şablonları dağıtmasını, ortamları yönetmesini, değişkenleri çekmesini, servisleri yeniden dağıtmasını ve daha fazlasını söyleyin.

Railway iki bağlantı yöntemi sunar:

• Yerel MCP — makinenizde Railway CLI üzerinden çalışır. CLI'ın kimlik doğrulamasını ve proje bağlamını paylaştığı için çoğu kodlama ajanı iş akışında önerilir.
• Uzak MCP — mcp.railway.com adresinde barındırılan bir uç nokta. Yerel kurulum veya CLI gerekmez; istemciler tarayıcıda OAuth ile kimlik doğrular.

Hızlı başlangıç

Railway CLI'ı kurun ve ajan desteğini — beceriler, MCP ve kimlik doğrulama — tek bir komutla yapılandırın. Kurmak istediklerinize göre komutu özelleştirmek için seçenekleri değiştirin:

CLI zaten kuruluysa, önyüklemeyi atlayın ve şunu çalıştırın:

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

Editör bazında manuel yapılandırma, mevcut araç listesi ve güvenlik hususları için okumaya devam edin.

Editör bazında yapılandırma

Bir editörü elle bağlamayı tercih ederseniz — veya railway mcp install'in tam olarak ne yazdığını görmek isterseniz — yerel stdio yapılandırması ile uzak HTTP yapılandırması arasında geçiş yapmak için düğmeyi kullanın:

railway mcp install, diğer MCP sunucularını kaldırmadan Railway sunucu girişini mevcut yapılandırmalarla birleştirir. Güncellemek için istediğiniz zaman yeniden çalıştırın.

MCP'yi Anlamak

Model Bağlam Protokolü (MCP), yapay zeka uygulamalarının (ana bilgisayarlar) bir istemci-sunucu mimarisi aracılığıyla harici araçlar ve veri kaynaklarıyla nasıl etkileşim kurabileceğine dair bir standart tanımlar.

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

Yerel Railway MCP Sunucusu, doğal dildeki istekleri Railway CLI tarafından desteklenen CLI iş akışlarına dönüştürür. Uzak MCP sunucusu Railway'in altyapısında çalışır ve OAuth ile kimlik doğrular.

Ön koşullar

• Yerel MCP — Railway CLI'ı kurun ve kimlik doğrulayın.
• Uzak MCP — bir Railway hesabı. Yerel kurulum gerekmez.

Örnek kullanım

• Yeni bir uygulama oluşturun ve dağıtın

  Create a Next.js app in this directory and deploy it to Railway.
  Also assign it a domain.
  

• Bir şablondan dağıtın

  Deploy a Postgres database
  

• Ortam değişkenlerini çekin

  Pull environment variables for my project and save them to a .env file
  

• Başarısız bir dağıtımda hata ayıklayın (yalnızca uzak railway-agent aracı)

  Use the railway agent to figure out why my backend service is
  crashing on deploy
  

• Bir servisi yeniden dağıtın

  Redeploy my api service in the production environment
  

Mevcut MCP araçları

Railway MCP Sunucusu, özenle seçilmiş bir araç seti sunar. Yapay zeka asistanınız, isteğinizin bağlamına göre bunları otomatik olarak çağırır.

Yerel MCP

Yerel sunucu Railway CLI üzerinden çalışır ve daha geniş bir CRUD araç seti sunar:

• Durum
  • check-railway-status — CLI kurulumunu ve kimlik doğrulamasını doğrulayın
• Projeler ve servisler
  • list-projects, create-project-and-link
  • list-services, link-service
  • deploy — bir servisi dağıtın
  • deploy-template — Railway Şablon Kütüphanesi'nden dağıtın
• Ortamlar
  • create-environment, link-environment
• Yapılandırma
  • list-variables, set-variables
  • generate-domain
• Gözlemlenebilirlik
  • get-logs

Uzak MCP

Uzak sunucu, odaklanmış bir araç seti ve güçlü bir ajan giriş noktası sunar. Karmaşık her şey için railway-agent'e devredin.

• Hesap
  • whoami
• Projeler
  • list-projects, create-project, list-services
• Dağıtımlar
  • redeploy
  • accept-deploy — hazırlanmış değişiklikleri commit'leyin ve dağıtın (yıkıcıdır; istemciler onay ister)
• Ajan
  • railway-agent — günlük analizi, hata ayıklama ve servis yapılandırması gibi çok adımlı işlemler için doğal dildeki bir isteği Railway'in yapay zeka ajanına iletin

Güvenlik hususları

Railway MCP Sunucusu sizin adınıza CLI komutları çalıştırır veya Railway API'lerini çağırır. Yıkıcı işlemler yerel sunucunun araç listesinden kasıtlı olarak hariç tutulmuştur, ancak yine de şunları yapmalısınız:

• LLM tarafından istenen eylemleri onaylamadan önce gözden geçirin, özellikle yıkıcı olanları (redeploy, accept-deploy, railway-agent).
• Erişimi kısıtlayın, böylece yalnızca güvenilir kullanıcılar MCP sunucusunu çağırabilir.
• Üretim risklerinden kaçının, mümkünse kullanımı kritik olmayan ortamlarla sınırlayın.

Özellikle uzak sunucu için:

• OAuth kapsamı. Onay verdiğinizde, istemcinin hangi çalışma alanlarına ve projelere erişebileceğini siz seçersiniz. Token'lar kısa ömürlüdür ve Railway hesap ayarlarınızdan iptal edilebilir.
• Yıkıcı eylemler protokol düzeyinde işaretlenmiştir. Bu ipuçlarına saygı duyan istemciler onay isteyecektir.
• Proje token'ları kabul edilmez. Uzak MCP sunucusu, faturalandırma ve denetim izleri için bir kullanıcı kimliği gerektirir.

Özellik istekleri

Railway MCP Sunucusu geliştirilme aşamasındadır. Aktif olarak daha fazla araç ve özellik ekliyoruz. Bir özellik isteğiniz varsa, geri bildiriminizi bu Central Station gönderisine bırakın.