DeployVeraDocs

TEKNİK REFERANS

AI ajanlarından yayın (MCP)

Barındırılan DeployVera MCP sunucusunu Claude Code, Cursor, VS Code veya Codex’ten kullanma: kurulum, giriş, yetkiler, onaylar ve sınırlar.

Son kontrol: Markdown

Nedir

DeployVera, https://mcp.deployvera.com/mcp adresinde barındırılan bir MCP (Model Context Protocol) sunucusu çalıştırır (Streamable HTTP). Claude Code, Cursor, VS Code veya Codex içindeki bir AI ajanı bu sunucuya bağlandığında oturum açılan hesabın projelerini listeleyebilir, dağıtım başlatabilir, build’in bitmesini bekleyebilir, build ve çalışma loglarını okuyabilir, başarısız bir build’i açıklayabilir, geri alma yapabilir ve ortam değişkenlerini yönetebilir.

Ajan her zaman giriş yapan hesabın veya tokenın yetkisiyle çalışır, bundan fazlasıyla değil. Paket satın alma veya değiştirme, ödeme, faturalama, hesap ayarları ve yönetim işlemleri ajana açık değildir; bunlar müşteri panelinde kalır. Sunucu MCP kayıt defterinde com.deployvera/mcp, npm’de deployvera-mcp adıyla, Claude bağlayıcı dizininde (https://claude.ai/directory/connectors/deployvera) ve GitHub’da (https://github.com/deployvera/deployvera-mcp) listelenir. Ajan, sahip olduğunuz ve boş uygulama yuvası bulunan bir pakette proje oluşturup dağıtabilir; proje oluşturma her zaman onayınızı ister, paket sipariş etmek ise panelde kalır.

Kurulum: Claude Code

Terminalde bir kez çalıştırılır. İlk araç çağrısında giriş için tarayıcı penceresi açılır (OAuth).

claude mcp add --transport http deployvera https://mcp.deployvera.com/mcp

Kurulum: Cursor

Tek tıkla kurulum: https://cursor.com/install-mcp?name=deployvera&config=eyJ1cmwiOiJodHRwczovL21jcC5kZXBsb3l2ZXJhLmNvbS9tY3AifQ%3D%3D

Elle eklemek için ~/.cursor/mcp.json dosyasına şu eklenir:

{
  "mcpServers": {
    "deployvera": {
      "url": "https://mcp.deployvera.com/mcp"
    }
  }
}

Kurulum: VS Code

VS Code MCP yapılandırmasına (mcp.json) sunucu eklenir:

{
  "servers": {
    "deployvera": {
      "type": "http",
      "url": "https://mcp.deployvera.com/mcp"
    }
  }
}

Kurulum: Codex

Sunucu ~/.codex/config.toml dosyasına eklenir; kişisel token (sonraki bölüme bakın) aşağıdaki adla ortam değişkeni olarak tanımlanır:

[mcp_servers.deployvera]
url = "https://mcp.deployvera.com/mcp"
bearer_token_env_var = "DEPLOYVERA_TOKEN"

Kurulum: stdio istemcisi

Yalnızca yerel süreç başlatabilen istemciler barındırılan adres yerine npm paketini kullanabilir. Beklediği token değişkeni depo README dosyasında anlatılır.

npx -y deployvera-mcp

Giriş: tarayıcıdan OAuth veya kişisel token

Varsayılan yol tarayıcıdan OAuth’tur: istemci DeployVera giriş ve izin ekranını açar, hesap sahibi hangi yetkilerin verileceğini seçer. Bağlı uygulamalar panelde Ayarlar > Yapay zekâ ajanı erişimi bölümünden kaldırılabilir.

Tarayıcı akışı olmayan istemciler için alternatif kişisel tokendır. Panelde Ayarlar > Yapay zekâ ajanı erişimi bölümünde oluşturulur, dvp_ ile başlar, yalnız bir kez gösterilir; bir adı, seçilmiş yetkileri ve geçerlilik süresi (30, 90 veya 365 gün) vardır ve her an iptal edilebilir; iptal edilen erişim hemen sona erer. Bir hesapta en fazla 10 etkin token bulunabilir. Authorization: Bearer dvp_... başlığıyla gönderilir. Parola gibi korunmalı ve bir depoya eklenmemelidir.

Yetkiler (scope)

Her token ve her OAuth girişi üç yetkiden bir alt küme taşır.

  • read: her zaman açık. Projeleri, veritabanlarını, build’leri, logları, ortam değişkenlerinin adlarını, kendi hizmetlerinizi, bağlanabilir depoları ve alan adı durumunu listeler.
  • deploy: dağıtım başlatma, build iptali, geri alma, proje oluşturma ve özel alan adı yönetimi.
  • env: ortam değişkeni yazma ve silme. Ajan bir değer yazabilir ama değeri hiçbir zaman geri okuyamaz.

Tarayıcıda onay

Beş işlem her zaman hesap sahibinin onayını ister: rollback, delete_env_var, create_project, set_domain ve remove_domain. Araç işlemi yapmak yerine bir onay bağlantısı döndürür. Hesap sahibi bağlantıyı açar (deployvera.com/approve), giriş yapar ve hesap parolası ile iki adımlı doğrulama koduyla onaylar. Ardından ajan aynı aracı onay kimliğiyle yeniden çağırır. Onay 10 dakika sonra geçersiz olur ve yalnız tek bir işlem için kullanılır; ajan kendi başına onaylayamaz, check_approval yalnızca durumu bildirir.

Bir token veya giriş, her dağıtım için de onay isteyecek şekilde ayarlanabilir. Bu seçenek Ayarlar > Yapay zekâ ajanı erişimi bölümünde token veya giriş başına belirlenir.

Araçlar

Sunucu 21 araç sunar.

  • list_projects, get_project: projeler ve güncel durumları.
  • list_databases, get_database_logs: yönetilen veritabanları (beta) ve logları.
  • deploy: bağlı bir projenin dağıtımını başlatır. deploy yetkisi gerekir.
  • get_build: build durumu; wait_seconds (0 ile 120) çağrının build bitene kadar beklemesini sağlar.
  • get_build_logs: build veya çalışma logları.
  • explain_build_failure: build’in neden başarısız olduğunun kısa açıklaması.
  • cancel_build: çalışan build’i durdurur.
  • rollback: önceki sürüme döner. Her zaman onay ister.
  • list_env_vars: yalnız adlar, değerler asla.
  • set_env_vars: değişken yazar. env yetkisi gerekir.
  • delete_env_var: değişkeni siler. Her zaman onay ister.
  • check_approval: bekleyen bir onayın durumu.
  • list_services: kendi hizmetleriniz; paket, durum ve boş uygulama yuvaları. Paylaşımlı hizmetler dahil değildir.
  • list_repositories: bağlı GitHub veya GitLab hesaplarında (etkinse Gitea’da) dağıtım yapabileceğiniz depolar. Token döndürülmez.
  • create_project: kendi hizmetlerinizden birinde bir Git deposundan proje oluşturur. Her zaman onay ister ve yalnızca hizmetin boş uygulama yuvası varsa çalışır; paket siparişi vermez veya değiştirmez.
  • start_domain_verification: özel alan adı için oluşturmanız gereken DNS kayıtlarını döndürür. Yönlendirmeyi değiştirmez, onay gerektirmez.
  • set_domain: DNS doğrulandıktan sonra özel alan adını bağlar. Her zaman onay ister.
  • remove_domain: özel alan adını ayırır. Her zaman onay ister.
  • check_domain: alan adının bağlı olup olmadığını ve her adın şu anda projeye yönlenip yönlenmediğini gösterir.

Güvenlik sınırları

Ajan paket satın alamaz veya değiştiremez, ödeme yapamaz, faturalamayı ve hesap ayarlarını değiştiremez ve hiçbir yönetici işlevini kullanamaz. Ortam değişkeni değerleri ajana asla döndürülmez. İstekler dakikada 120 ile sınırlıdır. Her işlem giriş yapan hesap adına çalışır ve panelde olduğu gibi projenin sahipliğine göre denetlenir.

Bununla birlikte bağlı bir ajan, verilen yetkiler içinde dağıtım başlatabilir. Yalnızca gereken yetkilerin verilmesi, kısa geçerlilik süresi seçilmesi, canlı projeler için her dağıtımda onayın açılması ve kullanılmayan tokenların iptal edilmesi önerilir.

Tipik akış

Kod gönderildikten sonra ajandan projeyi dağıtması istenir. Ajan deploy, ardından wait_seconds değeri 120 olan get_build çağırır. Build başarısız olursa explain_build_failure ve get_build_logs kullanılır. Geri alma yalnızca istendiğinde önerilir ve tarayıcıda onay bekler. Sık build hataları ve çözümleri /docs/tr/build-errors makalesindedir. Örnek istemlerle kısa bir anlatım https://deployvera.com/tr/claude-code-ile-deploy adresindedir.