Netlify

resmi

Netlify kaynaklarını doğal dil kullanarak oluşturun, derleyin, dağıtın ve yönetin.

Netlify MCP ile neler yapabilirsiniz?

  • Projeler oluşturun ve dağıtın — Asistanınızdan doğal dilde istemler kullanarak Netlify projeleri oluşturmasını, yönetmesini ve dağıtmasını isteyin.
  • Erişim denetimlerini yönetin — Netlify projelerinizin güvenlik ayarlarını düzenlemek için proje erişim denetimlerini değiştirin.
  • Eklentileri yönetin — Netlify eklentilerini projelerinize yükleyin veya kaldırın.
  • Ortam değişkenlerini yönetin — Projeleriniz için ortam değişkenleri ve gizli anahtarlar oluşturun ve yönetin.
  • Dağıtımları görüntüleyin — Dağıtım durumunu, dalı, hataları ve bağlantıları görmek için "Projemin son dağıtımlarını göster" diye sorun.
  • Hesap bilgilerini alın — Kullanıcı ve ekip bilgilerini alın, form gönderimlerini etkinleştirin veya yönetin.

Barındırılan MCP Sunucusu

npx add-mcp 'https://netlify-mcp.netlify.app/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Netlify MCP Server

Netlify MCP Server, kod ajanlarının Netlify API'sini ve CLI'yi kullanmasını sağlamak için Model Context Protocol (MCP) standardını izler; böylece doğal dildeki istemlerle yeni projeler oluşturabilir, derleme yapabilir, dağıtım gerçekleştirebilir ve Netlify kaynaklarınızı yönetebilirler.


Genel Bakış

Model Context Protocol, kod ajanlarını MCP sunucularına bağlamak için ortaya çıkan standart bir protokoldür. Ajanların doğal dil kullanarak kaynakları yönetmesine ve görevleri gerçekleştirmesine olanak tanır. Netlify MCP Server, ajanlarınıza API erişimi, CLI araçları, istemler ve daha fazlasını sağlayan bir köprü görevi görür.

Netlify MCP Server'a aşağıdakiler de dahil olmak üzere çeşitli MCP istemcileriyle bağlanabilirsiniz:


Kullanım Alanları

Netlify MCP Server ile AI ajanlarınız şunları yapabilir:

  • Netlify projeleri oluşturabilir, yönetebilir ve dağıtabilir
  • Proje güvenliğini artırmak için erişim denetimlerini değiştirebilir
  • Netlify uzantılarını yükleyebilir veya kaldırabilir
  • Kullanıcı ve ekip bilgilerini alabilir
  • Form gönderimlerini etkinleştirebilir ve yönetebilir
  • Ortam değişkenleri ve gizli anahtarlar oluşturabilir ve yönetebilir
  • ve daha fazlası...

Ön Koşullar

  • Node.js 22 veya üzeri Şu komutla kontrol edin: node --version
  • Bir Netlify hesabı
  • Bir MCP istemcisi (ör. Windsurf, Cursor, Claude, Copilot)

İpucu: En iyi deneyim için Netlify CLI'yi global olarak yükleyin: npm install -g netlify-cli


MCP Yapılandırması

Üretim MCP sunucusu için aşağıdaki yapılandırmayı kullanın:

Tek tıklamayla yükleme sunan düzenleyiciler:

Install MCP Server on Cursor

Add MCP Server netlify to LM Studio

Install on VS Code

Install on VS Code Insiders Edition

Install on Goose

  • bağlantı görüntülenmez veya açılmazsa tarayıcınızda şu bağlantıyı kullanın: goose://extension?cmd=npx&arg=-y&arg=%40netlify%2Fmcp&id=netlify&name=Netlify&description=Build%2C%20deploy%2C%20and%20manage%20sites%20with%20Netlify's%20official%20MCP%20server.

MCP yapılandırma dosyaları için yapılandırma:

{
  "mcpServers": {
    "netlify": {
      "command": "npx",
      "args": [
        "-y",
        "@netlify/mcp"
      ]
    }
  }
}

Yerel geliştirme için Yerel MCP yapılandırmasını ayarlama bölümüne bakın.


Sorun Giderme

Node Sürümü

  • En iyi sonuçlar için Node.js 22 veya üzerini kullanın.

  • nvm kullanıyorsanız şu komutu çalıştırın:

    nvm install 22
    nvm use 22
    

Netlify kimlik doğrulama sorunlarını giderme

{
  "mcpServers": {
    "netlify-mcp": {
      "command": "npx",
      "args": ["-y", "@netlify/mcp"],
      "env": {
        "NETLIFY_PERSONAL_ACCESS_TOKEN": "YOUR-PAT-VALUE"
      }
    }
  }
}

PAT'nizi deponuza commit etmeyin! Sorun çözüldükten sonra PAT'nizi yapılandırmadan kaldırın.


Yeni Bir Personal Access Token (PAT) Oluşturma

  1. Netlify kontrol panelinde kullanıcı simgenizi seçin.
  2. User settings > OAuth > New access token bölümüne gidin.
  3. Token'ınızı kopyalayın ve yukarıda açıklandığı gibi (geçici olarak) MCP yapılandırmanıza ekleyin.
  4. MCP istemcinizi yeniden başlatın veya yenileyin.

Dağıtım kartı (barındırılan MCP)

MCP Apps uyumlu bir istemciye şunu sorun: “Projemin son dağıtımlarını göster.” netlify-open-deployments aracı bir siteId (ve isteğe bağlı olarak deployId) alır ve durum, dal, etiketli oluşturulma zamanı, hatalar ve bağlantılarla birlikte eşleşen en fazla beş dağıtımı, ayrıca projenin ekibini ve kontrol paneli bağlantısını gösterir. Proje listesini duruma göre filtreleyin. Araçlar ayrıca status kabul eder; sonuç sayısı sınırlandırılmadan önce filtreleme Netlify tarafından uygulanır. Filtreler belirli bir deployId için geçerli değildir. Görüntülenen bir dağıtım etkin olduğu sürece kart her beş saniyede bir yenilenir ve dağıtımlar tamamlandığında veya gizli kaldığı süre de dahil olmak üzere 15 dakika geçtikten sonra durur. Yenile düğmesi manuel olarak yeniden kontrol eder ve otomatik güncellemeler için yeni bir 15 dakikalık süre başlatır. Filtrelerin uygulanması da yeni bir süre başlatır. MCP Apps desteği olmayan istemciler metin özeti alır.

Bu özellik mevcut Netlify OAuth bağlantısını kullanır ve ortam değişkeni ya da frontend derleme adımı eklemez. Dağıtım yaptıktan sonra istemcinin MCP araç kataloğunu yenileyin. Bu ilk sürüm derleme günlüklerini veya birden fazla projede aramayı içermez; derleme ayrıntılarının tamamı için karttaki Netlify'de aç bağlantısını kullanın.

ChatGPT'de hızlı bir test yapmak için dağıtılmış bir önizlemenin /mcp uç noktasına bağlanın, çalışan bir dağıtımı olan projeyi açın ve kartın dağıtım tamamlanana kadar güncellendiğini doğrulayın. Ayrıca boş bir projeyi, başarısız bir dağıtımı ve MCP Apps desteği olmayan bir istemcideki metin yedek çıktısını da kontrol edin.

Kaynaklar