Depo müdürü Claude Desktop'ı açar ve şunu yazar: "45123 numaralı siparişin kargo etiketini Depo-A yazıcısında 5 kopya yazdır." Üç saniye sonra yazıcı çalışmaya başlar. Tarayıcı sekmesi yok, kopyala-yapıştır yok, şablon araması yok — sadece bir cümle.
İşte LabelInn MCP sunucusu bunu mümkün kılıyor. Model Context Protocol konuşan her AI istemcisi — Claude Desktop, Cursor, GitHub Copilot Chat'li VS Code, ya da OpenAI veya Anthropic SDK'ları ile yazılmış kendi ajanınız — yazıcılarınızı, etiket tasarımlarınızı ve tüm iş geçmişinizi yapısal araç çağrıları ile kontrol edebilir.
Bu rehber MCP'nin ne olduğunu, LabelInn MCP sunucusunun neyi açtığını, 3 dakikada nasıl kurulduğunu ve depo ekipleri, geliştiriciler ve operasyon yöneticileri için ne tür akışlar sağladığını anlatıyor.
Kısaca MCP Nedir?
MCP (Model Context Protocol) Anthropic tarafından geliştirilen, AI istemcilerini dış araçlara ve verilere bağlamak için açık bir standarttır. Her sağlayıcı için özel function-calling kodu yazmak yerine MCP sunucusunu bir kez çalıştırırsınız ve MCP destekli her istemci kullanabilir. Yani LLM'ler ile gerçek dünya arasındaki evrensel sürücü katmanı diye düşünebilirsiniz.
Bir MCP sunucusu üç şeyi sunar:
- Araçlar (Tools) — AI'ın yapabileceği eylemler (bu etiketi yazdır, bu işi iptal et)
- Kaynaklar (Resources) — AI'ın okuyabileceği veriler (yazıcı filo durumu, son işler, tasarım kataloğu)
- İstem şablonları (Prompts) — kullanıcının başlatabileceği önceden yazılmış akışlar
İstemci (Claude Desktop, Cursor vb.) LLM mantığını yürütür. Sunucu gerçek işi yapar. Sunucuyu bir kez kurarsınız; her şey LabelInn API anahtarınızla yetkilendirilir.
LabelInn MCP Sunucusu Ne Sunar?
@labelinn/mcp-server 2.1 sürümü, LabelInn'in tüm yüzeyini kapsayan 12 araç modülü içerir. Öne çıkanlar:
Yazdırma ve İş Araçları
print_label— kayıtlı bir tasarımı değişken ile yazdırprint_zpl— ham ZPL'i doğrudan yazıcıya gönder (ileri kullanıcılar için)print_image— URL'den PNG/PDF yazdırbatch_print— tek çağrıda 100'e kadar iş gönderlist_jobs/get_job/cancel_job/reprint_job— tam iş döngüsü
Filo Araçları
list_printers— şirketin tüm yazıcıları, lokasyon bazındaget_printer_status— çevrimiçi/çevrimdışı, kuyruk derinliği, son hata, ribbon seviyesi (destekleyen modellerde)get_printer_details— model, firmware, yetenekler, desteklenen medya boyutları
Tasarım Araçları
list_designs/get_design/get_design_variables— şablon kütüphanenizi okuyunclone_design/create_design/update_design— programatik şablon yazımıadd_design_element/update_design_element/delete_design_element— element bazlı düzenlemerender_design_preview— yazdırmadan önizleme alınpublish_design/list_design_snapshots— sürüm kontrolü ve geri alma
Bağlayıcı ve Veri Araçları
ingest_data— CSV, JSON, XML veya Excel'i yazdırma kaynağı olarak beslelist_connector_sources— kayıtlı veri kaynaklarınız (Google Sheet, FTP klasörü, API)print_from_connector— kaynaktan oku ve tek çağrıda yazdırget_usage_stats— günlük kota, aylık baskı sayısı, filo kullanımı
Kaynaklar (yalnızca okuma — AI gezebilir)
labelinn://printers— canlı filo listesilabelinn://designs— aranabilir tasarım kataloğulabelinn://usage— anlık API kotası ve tüketim hızılabelinn://jobs/recent— son 20 yazdırma işi ve durumları
LabelInn MCP Sunucusunu Kurun (3 Dakika)
Ön Koşullar
- Bilgisayarınızda Node.js 18+ (sunucu yerel olarak çalışır)
- Pro veya üzeri bir LabelInn aboneliği (API erişimi gerekli)
- Bir API anahtarı — LabelInn panelinden Ayarlar → API Anahtarları bölümünden oluşturun
Adım 1: Sunucuyu Yükleyin
Sunucu npm üzerinde yayınlandı. Klonlamaya veya derlemeye gerek yok:
npm install -g @labelinn/mcp-server
Adım 2: AI İstemcinize Bağlayın
Claude Desktop — macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json ya da Windows'ta %APPDATA%\Claude\claude_desktop_config.json dosyasını düzenleyin:
{
"mcpServers": {
"labelinn": {
"command": "npx",
"args": ["-y", "@labelinn/mcp-server"],
"env": {
"LABELINN_API_KEY": "sk_live_..."
}
}
}
}
Cursor — Settings → MCP Servers → Add new MCP server bölümünü açın ve aynı JSON bloğunu yapıştırın (Cursor aynı şemayı kullanır).
VS Code + GitHub Copilot Chat — sunucuyu .vscode/mcp.json dosyanıza ya da Copilot Chat MCP seçicisinden ekleyin.
Adım 3: Yeniden Başlatın ve Test Edin
İstemcinizi yeniden başlatın. Claude Desktop'ta sohbet kutusunda küçük bir çekiç simgesi ve "labelinn" yazısı görmelisiniz. Şunu yazın:
"Şu anda hangi LabelInn yazıcılarım çevrimiçi?"
Claude list_printers çağırır, her biri için get_printer_status çalıştırır ve özetler. Cevabı görüyorsanız bağlantı hazır.
Henüz API anahtarınız yok mu? MCP sunucusu Pro plan veya üzerini gerektirir. 14 gün ücretsiz Pro deneme — kredi kartı gerekmez. Hemen ücretsiz kayıt ol →
MCP Sunucusunun Açtığı Akışlar
1. Depo Müdürü Yazıcılarıyla Konuşur
Sahadaki müdür SaaS arayüzünü öğrenmek zorunda kalmaz. Depodaki iPad'de Claude'u açar:
"Son 3 başarısız işi çevrimiçi olan ColorWorks yazıcısında yeniden yazdır."
Claude list_jobs ile başarısız işleri çeker, list_printers ile çevrimiçi ColorWorks'ü bulur, reprint_job ile her birini yeniden gönderir — her adımı Türkçe açıklar. Bir hata olursa müdür sebebi kendi dilinde görür.
2. Geliştirici Şablon Üzerinde Çalışıyor
Cursor'da yeni bir ürün etiketi tasarlıyorsunuz. LabelInn web canvas'ına geçmek yerine:
"'shipping-pro' tasarımını klonla, başlığı '{order_id} — {customer_name}' yap, {tracking_url}'e işaret eden bir QR kodu ekle ve önizleme oluştur."
Model clone_design, update_design_element, add_design_element ve render_design_preview çağrılarını yapar ve PNG'yi gösterir. Tıklayarak değil, konuşarak iterasyon yaparsınız.
3. ERP İçinde AI Ajanı
ERP'nizin içinde yaşayan bir asistan geliştiriyorsunuz. Siparişleri zaten biliyor. LabelInn MCP sunucusunu ekleyin ve aynı asistan artık yazdırabilir. Köprü kodu ya da webhook tesisatı yok — ajan yeni bir araç seti kazanır.
4. Denetçi Yazdırma Geçmişini İnceliyor
Bir denetçi şunu sormak istiyor: "Mart ayında B Lokasyonunda yazdırılan her işi göster, o anda aktif olan tasarım sürümüyle birlikte." Ajan labelinn://jobs/recent kaynağını okur, geçmiş üzerinde sayfalar arası gezinir, list_design_snapshots ile birleştirir ve raporu üretir. CSV ihracatı veya elle birleştirilen tablolar yok.
İzinler, Yetkilendirme ve Güvenlik
API anahtarları yetkilendirme katmanıdır. Kapsamı dar anahtarlar öneriyoruz:
- Sadece-okuma anahtar — analitik, filo görünümü, salt-okunur asistanlar için
- Sadece-yazdırma anahtar — depo istemcisi için (tasarım yazma yok, anahtar rotasyonu yok)
- Tam-erişim anahtar — yalnızca güvenilen geliştirici makineleri için
Her araç çağrısı API anahtarının parmak iziyle ve araç adıyla LabelInn denetim günlüğüne işlenir. Bir anahtar tehlikeye girerse Ayarlar → API Anahtarları bölümünden iptal edin; o anahtarı kullanan tüm aktif MCP oturumları bir sonraki çağrıda kapanır.
MCP sunucusu yerel çalışır — istemleriniz ve tasarım verileriniz üçüncü tarafa gitmez. Yalnızca AI istemcinizin LLM sağlayıcısına (Anthropic, OpenAI vb.) yaptığı çağrılar makinenizden çıkar; istemde yer almadığı sürece yazıcı verileriniz orada bulunmaz.
MCP Neyi Yapmaz?
Beklentileri dürüstçe ortaya koymak için:
- REST API'mizin yerini almaz. Günde 50.000 iş gönderen deterministik bir ERP entegrasyonu kuruyorsanız doğrudan REST API'yi kullanın — daha az hareketli parça, öngörülebilir gecikme.
- AI'a olmayan yazıcı, tasarım veya iş uydurmasına izin vermez. Her araç çağrısının argümanları hesabınızın gerçek durumuyla doğrulanır. Model bir cümle uydurabilir; var olmayan bir yazıcıya yazdıramaz.
- Hassas etiketler için insan onayının yerini almaz (regüle tıbbi alanlar, GS1 SGTIN seri havuzları). O akışlar LabelInn sunucusundaki onay politikalarından geçmeye devam eder.
Yol Haritası
- Hazır prompt kütüphanesi — sunucuyla birlikte gelen çok-adımlı şablonlar ("vardiya sonu raporu", "iş denetle", "yeni SKU kur")
- Akan önizlemeler — ajan, oluşturmanın sonunda değil oluşurken görüntüyü akıtabilecek
- Çok kiracılı anahtar yetkilendirmesi — yönetilen sağlayıcılar, ana anahtardan müşterileri için kapsamlı anahtar üretebilecek
Hemen Başlayın
LabelInn MCP sunucusu, ekibinizin kullandığı her AI asistanının arkasına etiket yazıcısını koymanın en hızlı yoludur. npm install'dan ilk AI ile yazdırılan etikete üç dakika. Pro plan ve üzeri API erişimini içerir; Enterprise planı günlük kota sınırını kaldırır.
AI'nızı Yazdıran Yapın
LabelInn MCP sunucusu desteklediğimiz her yazıcıda çalışır — Zebra, TSC, Brother, Epson ColorWorks gibi 50+ termal model. 14 gün ücretsiz Pro deneme — kredi kartı yok.
Pro Denemeyi Ücretsiz Başlat →