SnapDeploy MCP

resmi

SnapDeploy uygulamalarını (AWS üzerinde Docker konteynerleri) Claude Code, Cursor, Codex veya Gemini CLI'den dağıtın ve yönetin: derlemeler, günlükler, ortam değişkenleri, eklentiler, alan adları.

SnapDeploy MCP ile neler yapabilirsiniz?

  • GitHub deposu dağıt — Asistanınızdan bir depoyu SnapDeploy’a dağıtmasını isteyin ve deploy aracı üzerinden canlı bir URL alın.
  • Ortam değişkenlerini yönet — Asistanınıza bir kapsayıcı için ortam değişkenlerini ayarlamasını veya kontrol etmesini söyleyin; değerler (set) olarak maskelenir.
  • Dağıtım durumunu izle — Herhangi bir SnapDeploy kapsayıcısı için gerçek zamanlı durum, günlükler veya dağıtım geçmişi talep edin.
  • Kapsayıcı yaşam döngüsünü kontrol et — Sohbet arayüzünden ayrılmadan bir kapsayıcıyı isteğe bağlı olarak başlatın, durdurun veya uyandırın.
  • Kaynak sağla — Yönetilen veritabanları oluşturun veya doğrudan konuşma üzerinden dağıtımlarınıza özel alan adları atayın.

Dokümantasyon

@snapdeploy/mcp

Yapay zeka asistanınızdan SnapDeploy konteynerlerini dağıtın ve yönetin — Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Gemini CLI veya stdio üzerinden Model Context Protocol konuşan herhangi bir istemci.

"bu repoyu SnapDeploy'a dağıt" deyin ve canlı bir URL alın. Derlemeler, günlükler, ortam değişkenleri, yönetilen veritabanları ve özel alan adları — sohbetten çıkmadan.

Kurulum

  1. snapdeploy.dev adresinde oturum açın, API Anahtarları'nı açın ve deploy kapsamına sahip bir token oluşturun (sayfa aşağıdaki snippet'leri token'ınız zaten doldurulmuş olarak üretir).
  2. Sunucuyu istemcinize ekleyin:

Claude Code

claude mcp add --scope user snapdeploy -e SNAPDEPLOY_API_KEY=sd_pat_your_token -- npx -y @snapdeploy/mcp

Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Gemini CLI (~/.gemini/settings.json), Claude Desktop ve diğer JSON yapılandırmalı istemciler:

{
  "mcpServers": {
    "snapdeploy": {
      "command": "npx",
      "args": ["-y", "@snapdeploy/mcp"],
      "env": { "SNAPDEPLOY_API_KEY": "sd_pat_your_token" }
    }
  }
}

Codex CLI (~/.codex/config.toml):

[mcp_servers.snapdeploy]
command = "npx"
args = ["-y", "@snapdeploy/mcp"]
env = { SNAPDEPLOY_API_KEY = "sd_pat_your_token" }

Claude Code eklentisi (token bir yapılandırma dosyası yerine güvenli depolamada saklanır):

/plugin marketplace add AAR-Labs/snapdeploy-mcp
/plugin install snapdeploy@snapdeploy

Oturumu yeniden başlatın; snapdeploy araçları görünür. Deponuz GitHub'da olmalı ve GitHub'ın SnapDeploy'a bir kez bağlanması gerekir (bağlayıcı, bağlı değilse bağlantıyı döndürür).

Araçlar

KapsamAraçlar
readlist_apps get_status get_logs get_deployments check_quota list_repos detect_env_vars
deploydeploy set_env start_container stop_container wake_container
managecreate_database add_domain assign_always_on

Kapsamlar iç içe geçer (read ⊂ deploy ⊂ manage); sunucu, herhangi bir araç çalışmadan önce bunları zorunlu kılar. Silme aracı yoktur ve sunucu, her token için silme işlemlerini, abonelik iptallerini ve şifre değişikliklerini reddeder — bunlar için panoda veya mobil uygulamada oturum açmış bir kişi gerekir.

Güvenlik modeli

  • Asla yıkıcı bir şey yok. Aynı token ile ham bir API çağrısına yükselen bir aracı bile 403 INTERACTIVE_SESSION_REQUIRED alır.
  • Sırlar asla modele ulaşmaz. Ortam değişkeni değerleri (set) olarak geri döner ve kimlik bilgileri maskelenir — yalnızca bu bağlayıcıda değil, sunucuda.
  • Kapsamlı, süreli, iptal edilebilir token'lar kendi hız sınırlarıyla birlikte gelir. API Anahtarları sayfasında iptal edin ve o andan itibaren her istek 401 döndürür.
  • Yeniden denemeye dayanıklı dağıtımlar. On dakika içindeki aynı istekler, başka bir derleme başlatmak yerine orijinal dağıtımı döndürür.
  • Plan sınırları iletilir, yeniden denenmez. 402/429 yanıtları SnapDeploy'un kendi mesajını ve yükseltme bağlantısını taşır ve asistana yeniden denememesi söylenir.

Ortam değişkenleri

DeğişkenGerekliAnlam
SNAPDEPLOY_API_KEYevetKapsamlı token (sd_pat_…) veya eski API anahtarı
SNAPDEPLOY_READ_ONLYhayır1 yalnızca okuma araçlarını gösterir
SNAPDEPLOY_BASE_URLhayırVarsayılan https://snapdeploy.dev

Bağlantılar

MIT © AAR Labs