Railway MCP

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.

Railway iki MCP sunucusu sunar:

• Yerel MCP, makinenizde Railway CLI üzerinden çalışır ve yerel CLI bağlamını kullanır.
• Uzak MCP, mcp.railway.com adresinde çalışır. OAuth kullanarak doğrudan bağlanın veya railway login oturumunuzdaki kimlik bilgilerini yeniden kullanmak için railway mcp proxy komutunu çalıştırın.

Hızlı başlangıç

Railway CLI'yı kurun ve aracı 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 şu komutu çalıştırın:

railway setup agent                  # Local MCP
railway setup agent --remote         # Remote MCP through the CLI proxy
railway setup agent --remote --oauth # Remote MCP 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, yerel stdio, CLI proxy üzerinden Uzak MCP ve OAuth ile Uzak MCP arasında geçiş yapmak için seçiciyi kullanın:

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

MCP'yi Anlamak

Model Context Protocol (MCP), yapay zeka uygulamalarının (ana bilgisayarların) 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 (Hosts): MCP sunucularına bağlanan Cursor, VS Code, Claude Code veya Windsurf gibi uygulamalar.
• İstemciler (Clients): Ana bilgisayarlar içinde bireysel MCP sunucularıyla bire bir bağlantıları sürdüren katman.
• Sunucular (Servers): Harici sistemleri yönetmek için araçlar ve iş akışları sunan bağımsız programlar (Railway MCP Sunucusu gibi).

Yerel MCP sunucusu, doğal dil isteklerini Railway CLI tarafından desteklenen CLI iş akışlarına çevirir. Uzak MCP, Railway'in altyapısında çalışır ve OAuth'u destekler. CLI proxy, railway login oturumunuzdaki kimlik bilgilerini Uzak MCP'ye ileterek başka bir bağlantı yolu sağlar.

Ön koşullar

Sunucu ve kimlik doğrulama yöntemi, hangi yerel araçlara ve kimlik bilgilerine ihtiyacınız olduğunu belirler.

• Yerel MCP, kurulu ve kimliği doğrulanmış bir Railway CLI gerektirir.
• Uzak MCP, bir Railway hesabı gerektirir. Doğrudan OAuth, CLI gerektirmez. CLI proxy, bu kimlik bilgilerini yeniden kullanabilmek için kurulu bir CLI ve bir railway login oturumu gerektirir.

Örnek kullanım

Aracını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ımda hata ayıklama (yalnızca uzak railway-agent aracı)

  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>
  

Mevcut 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.

Yerel MCP

Yerel MCP, Railway CLI üzerinden çalışır ve şu araçları 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ğ: 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

Uzak MCP

Uzak MCP aşağıdaki araçları sunar. Ç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: hazırlanan değişiklikleri işleyin ve dağıtın (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 dil isteğini Railway'in yapay zeka aracısına iletin

Güvenlik hususları

Railway MCP Sunucusu, sizin adınıza CLI komutlarını çalıştırır veya Railway API'lerini çağırır. Yerel MCP, yıkıcı araçları protokol düzeyinde ipuçlarıyla işaretler ve confirm: true gerektirmeden önce bir önizleme döndürür. Yine de şunları yapmalısınız:

• Eylemleri gözden geçirin: LLM tarafından istenen eylemleri onaylamadan önce, özellikle yıkıcı olanları (remove_service, delete_domain, remove_tcp_proxy, remove_bucket, remove_volume, redeploy, accept-deploy ve railway-agent) gözden geçirin.
• 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.

Uzak MCP için:

• CLI proxy kimlik doğrulaması. Proxy, railway login kimlik bilgilerinizi okur ve yeniler. Düzenleyici yapılandırması uzun ömürlü bir Railway kimlik bilgisi içermez.
• OAuth kapsamı. Doğrudan OAuth ile istemcinin erişebileceği çalışma alanlarını ve projeleri 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. Uzak MCP, faturalandırma ve denetim izleri için bir kullanıcı kimliği gerektirir.

Özellik istekleri

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