Railway MCP
resmiRailway 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
.envdosyası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 mcpkomutu, düzenleyicinizi Railway CLI üzerindenmcp.railway.comadresine bağlar verailway loginkimlik 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.comadresine 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-agentaracı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-flagset-feature-flag,delete-feature-flag(yönetici; yıkıcı silme işlemi protokol düzeyinde işaretlenir)
- Dağıtımlar
redeployaccept-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-transcriptrespond-cloud-agent-task,cancel-cloud-agent-tasklist-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_servicevescale_service - Ortamlar ve dağıtımlar:
create_environment,link_environment,environment_status,list_deploymentsvedeploy - Değişkenler:
list_variables,set_variablesveadd_reference_variable - Alan adları:
generate_domain,list_domains,domain_status,update_domain,delete_domainveretry_domain_certificate - Ağ iletişimi:
list_tcp_proxies,get_tcp_proxy,create_tcp_proxy,remove_tcp_proxy,private_network_statusveprivate_network_update - Şablonlar:
search_templatesvedeploy_template - Depolama:
create_bucket,remove_bucket,create_volume,update_volumeveremove_volume - Gözlemlenebilirlik:
get_logs,service_metrics,http_requests,http_error_ratevehttp_response_time - Belgeler:
docs_searchvedocs_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 mcpkomutu,railway loginkimlik 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-agentve yerel sunucununremove_service,delete_domain,remove_tcp_proxy,remove_bucketveremove_volumeiş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.