Otopilot
SEO Hata Düzenleyici

MCP Server Entegrasyonu

Hazırlayan Son güncelleme:

Bu Sayfa Ne Yapar

MCP sunucusu, Claude Desktop ve Cursor gibi Model Context Protocol destekleyen yapay zekâ asistanlarının projenizin hazır SEO düzeltmelerini ve blog içeriklerini araç olarak çağırmasını sağlar; asistanınıza "sitemdeki SEO düzeltmelerini getir" demeniz yeterli olur. Panelle sitenin kodu arasında gidip gelmek yerine düzeltmeyi kod düzenleyicinizin içinde, asistanla birlikte uygulamak isteyen geliştiriciler için tasarlanmıştır.

MCP bağlantısı ayrı bir anahtar istemez; Otopilot API ile aynı proje anahtarını kullanır. Kurulum, Kanal & Kurulum görünümündeki MCP Server kartından ya da Otopilot API kurulum ekranındaki MCP kurulumu düğmesinden açılan MCP Sunucusu penceresinde yapılır. Pencerede istemci sekmeleri (Cursor, Claude Desktop, Yerel (stdio)), üç adımlık yönerge, anahtarı içeren yapılandırma bloğu ve Kopyala düğmesi, Bağlantıyı test et düğmesi ve Sık hatalar kutusu bulunur.

Sunucu altı araç sunar: test_connection anahtarı doğrulayıp bağlı projeyi döner; get_seo_fixes uygulanmaya hazır düzeltmeleri cursor ile sayfalı olarak döner (tek seferde 1–500, varsayılan 100) ve isteğe bağlı olarak tek bir sayfa adresine süzülebilir; report_applied uygulanan kimlikleri ve gerekirse yayın adreslerini bildirir; get_status mod, aktif kanal, son çekim ve durum sayılarını döner; get_content yayına hazır blog içeriklerini, report_content_applied ise içeriğin sitede yayınlanıp yayınlanmadığını bildirir. Çağrılar API uçlarıyla aynı istek sınırlarına ve IP kısıtına tabidir.

Kılavuz, SEO düzeltmelerini asistanla uygulamak isteyen geliştiriciler ve ileri düzey kullanıcılar içindir. Kurulum bitince asistanınız projenizi tanır, düzeltmeleri çekip sitenizin kodunda uygulayabilir ve uyguladığını bildirebilir; bildirilen düzeltmeler Düzeltmeler sekmesinde Uygulandı olur.

Sık karşılaşılan sınır, Claude'un web arayüzüdür: oradaki "özel bağlayıcı ekle" yalnız OAuth kabul ettiği için bu sunucu web arayüzünden eklenemez. Yapılandırma bloğu anahtarı açık metin olarak içerdiği için ayar dosyanızı bir depoya göndermeyin.

Anlatılan sayfayı panelde aç(giriş yapınca açılır)

Ön Koşullar

  • Projede bir API anahtarı olmalıdır; yoksa pencere "Önce bir API anahtarı oluşturun." der ve anahtarı Otopilot API kurulum ekranında API anahtarı üret ile oluşturmanız gerekir.
  • MCP destekleyen bir istemci gerekir: Cursor, Claude Desktop ya da yerel stdio sunucusu çalıştırabilen başka bir istemci.
  • Düzeltme araçlarının sonuç vermesi için projede SEO Hata Düzeltme açık olmalıdır; kapalıyken düzeltme araçları 403 döner.
  • Anahtarı görme ve yapılandırma bloğunu açma yetkisi proje sahibindedir.

Adım Adım Kullanım

  1. SEO Onarım ekranında Kanal & Kurulum görünümüne geçin ve Site ve geliştirici grubundaki MCP Server kartında Bağla düğmesine basın; kart sizi Otopilot API kurulum ekranına götürür. Orada MCP kurulumu düğmesine basarak MCP Sunucusu penceresini açın.
  2. Anahtar yoksa pencere "Önce bir API anahtarı oluşturun." uyarısı gösterir. Pencereyi kapatıp API anahtarı üret ile anahtarı oluşturun ve pencereyi yeniden açın.
  3. Kullandığınız istemcinin sekmesini seçin: Cursor, Claude Desktop ya da Yerel (stdio). Her sekme o istemcinin ayar dosyasına uygun bir yapılandırma bloğu üretir.
  4. Blok anahtarı içerdiği için önce gizlidir; "Yapılandırma bloğu anahtarı içerir. Göstermek için anahtarı açın." uyarısındaki Göster ile açın ve Kopyala ile alın.
  5. Bloğu istemcinizin mcpServers ayarına yapıştırın. Yerel stdio kullanıyorsanız sunucuyu npx tsx mcp/server.ts komutuyla çalıştırın ve SEOPANEL_API_URL ile SEOPANEL_API_KEY ortam değişkenlerini verin.
  6. Asistanı tamamen kapatıp yeniden başlatın; araç listesi yalnız açılışta okunur. Araçlar görünmüyorsa bloğun ayar dosyasında doğru yerde olduğunu kontrol edin.
  7. Paneldeki Bağlantıyı test et düğmesine basın. "Bağlantı başarılı" mesajı projenizin alan adını göstermelidir; asistanda test_connection aracını çalıştırdığınızda da aynı proje dönmelidir.
  8. Asistana get_seo_fixes ile düzeltmeleri çektirin. İlk çağrıda since verilmez; sonraki çağrılarda dönen cursor kullanılır. Tek bir sayfa üzerinde çalışıyorsanız url parametresiyle yalnız o sayfanın düzeltmelerini isteyin.
  9. Asistan düzeltmeyi kodunuzda uyguladıktan sonra report_applied ile kimlikleri bildirsin; blog yazısı ya da yeni sayfa için urls ile yayın adresini de göndersin. Durumu get_status ile kontrol edin.
  10. Blog içeriklerini de asistanla yayınlıyorsanız get_content ile yayına hazır içerikleri alın ve yayından sonra report_content_applied ile sonucu (başarılıysa adresiyle) bildirin.

MCP araçları

  • test_connection — API anahtarını doğrular ve bağlı projeyi (kimlik, alan adı) döner; durum değiştirmez.
  • get_seo_fixes — Uygulanmaya hazır düzeltmeleri döner (mutations, removedIds, cursor, hasMore). limit 1 ile 500 arasındadır, varsayılan 100'dür; url ile tek sayfaya süzülebilir.
  • report_applied — Siteye uygulanan düzeltmelerin kimliklerini bildirir; urls ile yayın adresi eklenebilir, tekrar bildirim zararsızdır.
  • get_status — Mod, aktif kanal, son çekim zamanı, düzeltmelerin alınıp alınmadığı, durum sayıları ve bildirilen API sürümünü döner.
  • get_content — Yayına hazır blog içeriklerini döner (items, cursor, hasMore; tek seferde en fazla 50).
  • report_content_applied — Bir içeriğin sitede yayınlandığını (adres ile) ya da yayınlanamadığını (hata koduyla) bildirir.

Ekrandaki öğeler

  • MCP Server kartı — Site ve geliştirici grubunda; Yapay zekâ asistanı rozetiyle görünür ve Otopilot API kurulumuna götürür.
  • MCP kurulumu — Otopilot API kurulum ekranında MCP Sunucusu penceresini açar.
  • MCP adresi — Otopilot API kurulum ekranında MCP uç adresi ve Kopyala düğmesi.
  • Cursor, Claude Desktop, Yerel (stdio) — İstemciye göre yapılandırma bloğu üreten sekmeler.
  • Yapılandırma bloğu — Anahtarı içeren JSON blok; Göster ile açılır, Kopyala ile alınır.
  • Bağlantıyı test et — Anahtarı doğrular; başarıda alan adını, başarısızlıkta hata metnini yazar.
  • Sık hatalar — Araç görünmüyor, yetki hatası ve IP reddi için kısa yanıtlar; altında Claude web arayüzü notu.
  • Kapat — Pencereyi kapatır.

Sonuçları nasıl yorumlarsınız

  • Panel testi "Bağlantı başarılı" ve doğru alan adını gösteriyorsa anahtar ve adres doğrudur; asistanda araçlar görünmüyorsa sorun yalnız istemci yapılandırmasındadır.
  • get_seo_fixes boş liste ve bir emptyReason dönüyorsa uygulanacak düzeltme yoktur; neden alanı otomatik düzeltmenin kapalı olduğunu ya da düzeltmelerin henüz hazırlanmadığını söyler.
  • get_status yanıtındaki durum sayıları Düzeltmeler sekmesindeki süzgeç sayılarıyla aynı kaynaktan gelir; asistanın bildirdiği kimlikler Uygulandı sayısını artırmalıdır.
  • report_applied sonrası kartlar Uygulandı olur, yeniden taramada değer sitede bulunursa Doğrulandı'ya geçer; geçmiyorsa uygulama sitede gerçekten yapılmamış olabilir.

Örnek senaryo

örnek.com, Next.js ile yazılmış bir yazılım ajansı sitesi; geliştirici Cursor kullanıyor. Otopilot API kurulumunda anahtarı ürettikten sonra MCP kurulumu penceresini açıyor, Cursor sekmesindeki bloğu Göster ile açıp kopyalıyor ve projenin MCP ayar dosyasına ekliyor. Cursor'ı yeniden başlatınca araç listesinde altı araç görünüyor; paneldeki Bağlantıyı test et "Bağlantı başarılı: örnek.com" yazıyor.

Geliştirici asistana hizmetler sayfası için düzeltmeleri istiyor; asistan get_seo_fixes'i url parametresiyle çağırıp iki kural getiriyor: yeni meta açıklama ve eksik yapısal veri. Asistan değişiklikleri sayfanın generateMetadata fonksiyonuna ve JSON-LD bileşenine yazıyor, geliştirici farkı inceleyip yayına alıyor ve asistan report_applied ile iki kimliği bildiriyor. Paneldeki kartlar Uygulandı oluyor; bir sonraki taramadan sonra Doğrulandı durumuna geçiyor.

İpuçları

  • Asistana tek seferde tüm siteyi değil, url parametresiyle sayfa sayfa düzeltme çektirin; değişiklikleri incelemek kolaylaşır.
  • Yapılandırma dosyanızı sürüm kontrolünün dışında tutun ya da anahtarı ortam değişkeninden okuyun; blok anahtarı açık metin içerir.
  • Asistanın uyguladığı değişikliği yayına almadan report_applied çağırmayın; bildirim "sitede uygulandı" anlamına gelir.
  • Sürekli ve zamanlanmış senkron gerekiyorsa MCP yerine Otopilot API ile bir cron görevi kurun; MCP asistanla etkileşimli çalışmaya uygundur.
  • Asistanın çalıştığı makinenin IP adresi değişiyorsa IP kısıtını açmadan önce bunu hesaba katın.

Sık yapılan hatalar

  • MCP sunucusunu Claude web arayüzündeki özel bağlayıcı ekranından eklemeye çalışmak.
  • Bloğu yapıştırıp istemciyi yeniden başlatmadan araçları aramak.
  • Anahtarı yeniledikten sonra yapılandırma bloğunu güncellemeyi unutmak.

Sık Karşılaşılan Sorunlar

  • Araç görünmüyor: Yapılandırma bloğu eksik, yanlış dosyaya yapıştırılmış ya da asistan yeniden başlatılmamıştır. Bloğu kontrol edip istemciyi tamamen kapatıp açın.
  • Yetki hatası: Bloktaki anahtar paneldekiyle aynı değildir; anahtar yenilenmiş olabilir. Güncel anahtarla bloğu yeniden kopyalayın; Yeniden üret diğer bağlantıları da koparır.
  • Bağlantı kurulamadı: Panel testi hata metniyle birlikte döner; çoğunlukla anahtar iptal edilmiş, adres yanlış yazılmış ya da proje etkin değildir. Hata metnine göre anahtarı ya da adresi düzeltin.
  • Bu API anahtarı yalnız izin verilen IP adreslerinden kullanılabilir; istek … adresinden geldi ve listede yok.: API kurulumunda IP kısıtı açıktır ve asistanın çalıştığı makinenin adresi listede değildir. Adresi IP kısıtı listesine ekleyin ya da kısıtı kapatın.
  • Bu proje için SEO Hata Düzeltme açık değil.: Düzeltme araçları 403 döner. Kanal & Kurulum görünümünden otomatik düzeltmeyi açın; test_connection bu sırada da çalışır.
  • Geçersiz "limit" — 1 ile 500 arasında bir tam sayı bekleniyor.: get_seo_fixes çağrısında limit aralık dışındadır. Değeri 1 ile 500 arasında verin ya da hiç vermeyip varsayılan 100'ü kullanın.
  • Claude web arayüzündeki "özel bağlayıcı ekle" yalnızca OAuth kabul eder; bu yüzden oradan eklenemez.: Bu sunucu anahtarla çalışır, OAuth desteklemez. Claude Desktop ya da Cursor gibi yerel ayar dosyası kullanan bir istemci tercih edin.

İlgili Kılavuzlar

Bu adımları kendi sitenizde uygulayın

Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.

Tüm rehberler