Yapay Zeka Asistanınızı LabelGrid'e Bağlayın (MCP)

Temmuz 2026’da güncellendi.

LabelGrid, kendi yapay zeka asistanınızı LabelGrid hesabınıza bağlayıp gündelik dilde çalışabilmeniz için resmi bir MCP (Model Context Protocol) sunucusu yayımlar. REST çağrıları yazmak yerine yapay zekanızdan bir yayın taslağı hazırlamasını, onu doğrulamasını, inceleme durumunu kontrol etmesini veya analizlerinizi getirmesini isteyebilirsiniz; arka planda LabelGrid API’sini kullanır.

Sunucu, @labelgrid/mcp adlı npm paketidir ve github.com/labelgrid/labelgrid-mcp adresinde MIT lisansı altında açık kaynaktır. Claude Desktop, Claude Code, Cursor veya MCP uyumlu herhangi bir istemciyle çalışır.

Neler yapabilirsiniz

Bağlantı kurulduktan sonra yapay zeka asistanınızdan şunları isteyebilirsiniz:

• Taslak yayınlar ve parçalar oluşturma ve güncelleme — meta verileri sohbet ederek oluşturun
• Yayınlarınıza ve parçalarınıza ses, kapak görseli ve lisans belgesi yükleme
• Yayınları göndermeden önce doğrulama — sorunlar erken ortaya çıksın
• İnceleme sorunlarını, kalite raporlarını ve teslimat durumunu kontrol etme
• Akış analizlerini, telif geliri ekstrelerini ve dökümlerini çekme
• Asenkron bildirimler için webhook yönetimi
• Yayınları dağıtıma gönderme veya kaldırma — yalnızca bu işlemleri açıkça etkinleştirdiğinizde kullanılabilir (bkz. Güvenlik ve izinler)

Sunucu arka planda sekiz araç grubuna yayılmış derli toplu bir birleştirilmiş araç kümesi sunar: account, reference, catalog, releases, insights, finance, webhooks ve distribution. Araçların çoğu, neyin üzerinde işlem yapacağını verdiğiniz bir argümandan belirler; örneğin tek bir katalog arama aracı etiketleri, sanatçıları, söz yazarlarını, yayıncıları, yayınları ve parçaları kapsar. Türler, diller ve bölgeler gibi referans veriler ayrıca MCP kaynağı olarak da sunulur. Dosya yüklemeleri catalog ve distribution araç gruplarının parçasıdır. Yapay zeka istemciniz kendisine sunulan araçları tam olarak listeler; böylece güncel yüzeyi her zaman istemcinin içinden görebilirsiniz.

---

Neye ihtiyacınız var

1. API erişimi olan bir LabelGrid hesabı. API erişimi, LabelGrid’in API planlarının bir parçasıdır; nasıl edineceğiniz için bkz. API’ye Genel Bakış.
2. Bir API jetonu. LabelGrid panonuzda Profil → API Jetonları altından oluşturun.
3. Yapay zeka istemcinizi çalıştıran bilgisayarda Node.js 20 veya üzeri.

---

Kurulum

LabelGrid’i yapay zeka istemcinizin MCP yapılandırmasına ekleyin:

{
  "mcpServers": {
    "labelgrid": {
      "command": "npx",
      "args": ["-y", "@labelgrid/mcp"],
      "env": {
        "LABELGRID_API_TOKEN": "your-api-token"
      }
    }
  }
}

your-api-token yerine panonuzdaki jetonu yazın, ardından istemcinizi yeniden başlatın.

Claude Code için tek bir komut yeterlidir:

claude mcp add labelgrid -e LABELGRID_API_TOKEN=your-api-token -- npx -y @labelgrid/mcp

Dikkat

Bu komut jetonunuzu komut satırına koyar; kabuğunuz jetonu geçmişine kaydeder ve makinedeki diğer kullanıcılar onu işlem listesinden okuyabilir. Sonrasında jetonu geçmişinizden temizleyin veya bunun yerine yukarıdaki JSON yapılandırmasına ekleyin.

---

Rehberli kurulum

Sunucuyu jeton olmadan başlatırsanız hata vermez; bunun yerine rehberli kurulum modunda açılır. LabelGrid’i istemcinize LABELGRID_API_TOKEN değeri olmadan ekleyin, sonra yapay zekanıza “LabelGrid’i kur” deyin; jeton oluşturma adımlarında ve jetonu nereye ekleyeceğiniz konusunda size yol gösterir. Kurulum akışı, asistana sizi istemcinizin yapılandırma dosyasına yönlendirmesini ve jetonu asla sohbette istememesini söyler — jetonu orada tutun ve istense bile konuşmaya yapıştırmayın.

---

Güvenlik ve izinler

Sunucu, yapay zekanızın ne kadarını yapabileceğine siz karar verebilesiniz diye üç izin kademesi kullanır:

• Okuma işlemleri her zaman kullanılabilir. Yapay zekanız yayınlara, parçalara, incelemelere, analizlere, ekstrelere ve teslimat durumuna istediği zaman bakabilir.
• Güvenli yazma işlemleri varsayılan olarak açıktır. Taslak oluşturma ve düzenleme, meta veri güncelleme ve webhook yönetimi kurulumdan itibaren etkindir. Bunları LABELGRID_ENABLE_WRITES=false ile kapatabilir veya LABELGRID_READ_ONLY=true ile her şeyi salt okunur hale getirebilirsiniz.
• Sonuç doğuran işlemler varsayılan olarak kapalıdır. Bir yayını dağıtıma gönderme, bir yayını kaldırma ve değiştirilemez dosya yüklemeleri için LABELGRID_ENABLE_FULL_WRITES=true ve ayrıca proje README dosyasında belgelenen açık bir onay cümlesi gerekir.

Hesabınıza ilişkin tüm korumalar (doğrulama, plan limitleri ve hız sınırları) LabelGrid’in sunucularında uygulanır. Hangi izinleri verirseniz verin, yapay zeka bunları aşamaz.

---

Yapay zeka istemcinizin gördükleri

Sunucu kendi makinenizde çalışır ve LabelGrid API’siyle sizin jetonunuzu kullanarak konuşur. LabelGrid ile, yapay zekanızın yapmasını istediği API çağrıları dışında hiçbir bağlantısı yoktur ve LabelGrid konuşmalarınızı almaz.

Veri akışı ters yönde işler ve bu konuda bilinçli olmakta fayda var: yapay zekanızın sunucu üzerinden okuduğu her şey — yayın meta verileri, inceleme sorunları, analizler, telif geliri ekstreleri — yapılandırdığınız yapay zeka istemcisine, oradan da o istemcinin kullandığı modele aktarılır. Kataloğunuz ve hesap verileriniz konusunda güvendiğiniz bir istemci seçmek ve kendi sözleşmeleriniz gerektiriyorsa bu akışı açıklamak sizin sorumluluğunuzdadır.

Bunun iki pratik sonucu var:

• Verilerinizin bir kısmı hiçbir zaman bir yapay zeka sağlayıcısına ulaşmamalıysa, yapay zekanın onu sormayacağına güvenmek yerine LABELGRID_TOOLSETS ile o alanı tümüyle dışarıda bırakın. Sunulmayan bir araç çağrılamaz.
• Finansal veriler de bu kapsamdadır. finance araç grubu ekstreleri ve telif geliri dökümlerini okur; bunların konuşmaya girmesini istemiyorsanız bu grubu dışarıda bırakın.

---

Hangi araçların kullanılabileceğini sınırlama

Hesabınızın yalnızca bir bölümünü açmak istiyorsanız, sunucunun hangi araç alanlarını sunacağını sınırlamak için LABELGRID_TOOLSETS değerini ayarlayın. Bu, yapay zekayı seçtiğiniz alanlara odaklı tutar. webhooks araç grubu varsayılan olarak kapalıdır; açmak için LABELGRID_TOOLSETS içine ekleyin.

---

Sorun giderme

• Jeton geçersiz veya reddedildi — jetonu panonuzda Profil → API Jetonları altından yeniden oluşturun ve MCP yapılandırmanızda güncelleyin.
• “API Jetonları” sayfasını göremiyorsunuz — hesabınızın henüz API erişimi yok. Nasıl etkinleştireceğiniz için bkz. API’ye Genel Bakış.
• Sunucunun bağlandığından emin değilsiniz — sunucu başlarken durumunu yazdırır, istemcinizin MCP günlüklerine bakın.
• Bağlantıyı kesmek istiyorsunuz — jetonu panonuzdan istediğiniz zaman iptal edin. Bu, bu sunucu dahil o jetonu kullanan her şeyi anında durdurur. Hesabınızdaki diğer jetonlar etkilenmez; bu nedenle kullanımdan kaldırmak istediğiniz her jetonu ayrı ayrı iptal edin ve değeri MCP yapılandırmanızdan da kaldırın.

---

SSS

”LabelGrid’in bir MCP sunucusu var mı?”

Evet. LabelGrid, resmi MCP sunucusunu @labelgrid/mcp adlı npm paketi olarak yayımlar; github.com/labelgrid/labelgrid-mcp adresinde MIT lisansı altında açık kaynaktır. Claude Desktop, Claude Code, Cursor veya MCP uyumlu herhangi bir yapay zeka istemcisini LabelGrid hesabınıza bağlar; böylece doğal dilde çalışabilirsiniz.

”Bununla neler yapabilirim?”

Taslak yayınlar ve parçalar oluşturup güncelleme; ses, kapak görseli ve lisans belgesi yükleme; yayınları göndermeden önce doğrulama; inceleme sorunlarını, kalite raporlarını ve teslimat durumunu kontrol etme; akış analizlerini, telif geliri ekstrelerini ve dökümlerini çekme; webhook’ları yönetme. Yayınları dağıtıma gönderme ve kaldırma yalnızca bunları açıkça etkinleştirdiğinizde kullanılabilir.

”Hesabımı bir yapay zekaya yönettirmek güvenli mi?”

Sunucunun üç izin kademesi vardır. Okuma işlemleri her zaman kullanılabilir; güvenli yazma işlemleri (taslaklar, meta veriler, webhook’lar) varsayılan olarak açıktır ve kapatılabilir; sonuç doğuran işlemler (dağıtıma gönderme, kaldırma, değiştirilemez dosya yüklemeleri) varsayılan olarak kapalıdır ve tam yazma iznini etkinleştirmenizle birlikte açık bir onay gerektirir. Doğrulama, plan limitleri ve hız sınırları dahil tüm hesap korumaları LabelGrid’in sunucularında uygulanır ve yapay zeka tarafından aşılamaz.

İzinler yapay zekanın ne yapabileceğini belirler. Ne görebileceğini ise ayrıca değerlendirin: sunucu üzerinden okuduğu her şey yapay zeka istemcinize ve onun arkasındaki modele ulaşır. Bkz. Yapay zeka istemcinizin gördükleri.

”Bir API planına ihtiyacım var mı?”

Evet. MCP sunucusu LabelGrid herkese açık API’si üzerinden bağlanır; bu nedenle hesabınızın API erişimi olmalıdır ve API erişimi LabelGrid’in API planlarının bir parçasıdır. Erişimi nasıl edineceğiniz için bkz. API’ye Genel Bakış.

”Hangi yapay zeka uygulamaları destekleniyor?”

Claude Desktop, Claude Code ve Cursor dahil MCP uyumlu her istemci.

---

İlgili

• API’ye Genel Bakış ve Hızlı Başlangıç — API erişimini nasıl edinir ve kimlik doğrulamayı nasıl yaparsınız
• LabelGrid Komut Satırı Aracı (CLI) — aynı işlemler, terminalinizden veya bir betikten
• Webhook’lar — asenkron olay bildirimleri
• npm üzerinde @labelgrid/mcp
• GitHub’da labelgrid-mcp

---

Yardıma mı ihtiyacınız var?

MCP sunucusu hakkında sorularınız varsa destek ekibimizle iletişime geçin.