Railway MCP

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

Railway MCP Sunucusu, Model Context Protocol (MCP) protokolünü uygular. Yapay zeka 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 şekilde bağlanabilirsiniz:

• CLI üzerinden (varsayılan). railway mcp komutu, düzenleyicinizi Railway CLI aracılığıyla mcp.railway.com adresine bağlar ve railway login kimlik bilgilerinizi yeniden kullanır; böylece ikinci bir kimlik doğrulama gerekmez.
• OAuth ile. OAuth 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 5.44.0 veya üzeri gerekir.

Hızlı başlangıç

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

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

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

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

Düzenleyici bazında yapılandırma

Bir düzenleyiciyi manuel olarak yapılandırmayı tercih ediyorsanız veya railway mcp install komutunun ne 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, Railway sunucu girişini mevcut yapılandırmalara diğer MCP sunucularını kaldırmadan ekler. Güncellemek için istediğiniz zaman yeniden çalıştırın.

MCP'yi anlama

Model Context Protocol (MCP), yapay zeka uygulamalarının (ana bilgisayarlar) harici araçlar ve veri kaynaklarıyla istemci-sunucu mimarisi üzerinden 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 içinde, bireysel MCP sunucularıyla bire bir bağlantılar kuran katman.
• Sunucular: Harici sistemleri yönetmek için araçlar ve iş akışları sunan bağımsız programlar (Railway MCP Sunucusu gibi).

Railway MCP sunucusu, Railway'in altyapısında çalışır. railway mcp komutu, stdio üzerinden bağlanır ve her isteğe railway login oturumunuzdan kimlik bilgileri ekler. OAuth 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 kurulu bir Railway CLI ve bu kimlik bilgilerini yeniden kullanabilmek için bir railway login oturumu gerektirir. OAuth, CLI gerektirmez.

Örnek kullanım

Ajanın üretmesini istediğiniz Railway sonucunu tanımlayan istemler kullanın.

• Yeni bir uygulama oluşturma ve dağıtma

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

• Ş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ımı 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 zeka 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şaretlenmiştir)
• Dağıtımlar
  • redeploy
  • accept-deploy: aşamalı değişiklikleri işler ve dağıtır (yıkıcı; istemciler onay ister)
• Ajan
  • railway-agent: günlük analizi, hata ayıklama ve hizmet yapılandırması gibi çok adımlı işlemler için doğal dil isteğini Railway'in yapay zeka ajanına iletir

Sunucuyu yerel olarak çalıştırma

CLI ayrıca, örneğin egress kısıtlı ağlarda, mcp.railway.com adresine ulaşamayan makineler için süreç içi bir MCP sunucusu da içerir. railway mcp local ile başlatın veya desteklenen düzenleyiciler için yapılandırmayı railway mcp install --local ile yazın. CLI kimlik bilgilerinizi kullanarak doğrudan Railway API'siyle konuşur, yıkıcı araçları protokol düzeyinde ipuçlarıyla işaretler ve confirm: true gerektirmeden önce bir önizleme döndürür.

Yerel sunucu, mcp.railway.com adresinden farklı bir araç seti 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ğ oluşturma: 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
• Dokümantasyon: docs_search ve docs_fetch

Güvenlik hususları

Railway MCP Sunucusu, sizin adınıza Railway API'lerini çağırır. Şu noktaları aklınızda 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 hangi çalışma alanlarına ve projelere erişebileceğini siz seçersiniz. Belirteçler kısa ömürlüdür ve Railway hesap ayarlarınızdan iptal edilebilir.
• Yıkıcı eylemler protokol düzeyinde işaretlenir. Bu ipuçlarına saygı gösteren istemciler onay ister.
• Proje belirteçleri kabul edilmez. Sunucu, faturalandırma ve denetim izleri için bir kullanıcı kimliği gerektirir.

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

• Eylemleri gözden geçirin LLM tarafından istenen eylemleri 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).
• Erişimi kısıtlayın yalnızca güvenilir kullanıcıların MCP sunucusunu çağırabilmesini sağlamak için.
• Üretim risklerinden kaçının mümkün olduğunda kullanımı kritik olmayan ortamlarla sınırlayarak.

Özellik istekleri

Özellik isteklerinizi Railway MCP Sunucusu Merkez İstasyonu gönderisi üzerinden paylaşın.