MCP Server

Grafikit MCP Server Dokümantasyonu

AI istemcileri için baskıya hazırlama adaptörü

Grafikit MCP, ChatGPT, Claude, Cursor, Codex ve diğer MCP uyumlu istemcilerin sticker baskı dosyası hazırlama araçlarına standart bir protokol üzerinden erişmesini sağlar.

  • MCP endpoint
  • Print-ready dosya hazırlığı
  • Kullanıcı onayı olmadan sipariş yok

Grafikit MCP nedir?

Kısa cevap: Grafikit MCP, AI istemcilerinin Grafikit’in baskıya hazırlama araçlarını MCP protokolüyle çağırabilmesi için kullanılan ayrı bir teknik servistir. Servis mcp.grafikit.com üzerinde çalışır; ana grafikit.com sitesi yalnızca bu servisin insanlara yönelik dokümantasyonunu yayınlar.

AI istemcileri neden MCP adaptörüne ihtiyaç duyar?

  • AI tarafından üretilen SVG, PNG veya yüklenmiş görseller doğrudan üretime hazır olmayabilir.
  • Sticker ve etiket işlerinde ölçü, taşma payı, kesim çizgisi, tabaka yerleşimi ve önizleme gerekir.
  • AI istemcilerinin bu hazırlık adımlarını tutarlı ve makine-okunabilir bir araç listesiyle çağırması gerekir.
  • Kullanıcının ürün, ölçü, malzeme ve dosya beklentisi netleşmeden gerçek sipariş başlatılmamalıdır.

Grafikit MCP hangi çıktıları hazırlar?

MCP katmanı, AI istemcisinden gelen dosya veya SVG girdisini Grafikit Print API hazırlık akışına bağlar.

print-ready PDF
cutline SVG/PDF
preview PNG
production JSON
preflight bilgisi
hazırlık işi bağlantıları
MCP araçları hazırlık ve kontrol çıktısı üretir; kullanıcı açıkça onay vermeden ücretli sipariş oluşturmaz.

MCP kullanım akışı

İstemci endpointi keşfeder

MCP uyumlu istemci https://mcp.grafikit.com/.well-known/mcp.json veya yapılandırılmış endpoint bilgisiyle servisi tanır.

Araç listesini alır

İstemci /mcp endpointi üzerinden initialize ve tools/list çağrılarıyla kullanılabilir baskıya hazırlama araçlarını görür.

Dosya veya SVG gönderir

AI istemcisi SVG markup, ChatGPT dosya parametresi veya public HTTPS artwork URL ile uygun aracı çağırır.

Hazırlık çıktısını alır

Grafikit MCP, Print API sonucunu güvenli şekilde döndürür: önizleme, baskı dosyası, kesim dosyası ve üretim notları.

Kullanıcı onayı beklenir

Hazırlanan çıktılar sipariş anlamına gelmez. Üretim veya ödeme ancak kullanıcı onayıyla ilerler.

Desteklenen ürünler

  • Sticker
  • Etiket
  • UV DTF
  • SVG kaynaklı baskı dosyaları
  • Yüklenmiş artwork dosyaları
  • Public HTTPS artwork URL’leri

Bağlantı bilgileri

AI veya MCP uyumlu bir istemci yapılandırırken MCP endpoint olarak https://mcp.grafikit.com/mcp adresini kullanın. Keşif dosyası https://mcp.grafikit.com/.well-known/mcp.json adresindedir. Root adresi olan https://mcp.grafikit.com/ insanlara yönelik bu dokümantasyon sayfasına yönlenir; MCP çağrıları için /mcp endpointi kullanılmalıdır.

Mevcut MCP tool'ları

Grafikit MCP şu anda sticker baskı dosyası hazırlığına odaklanan dört public tool yayımlar. AI istemcisi önce kullanıcının elindeki girdiye bakmalı, sonra uygun tool'u seçmelidir.

AI tarafından üretilen SVG'den baskı dosyası oluşturma

create_print_file_from_svg

Ne zaman kullanılır? AI asistanı tasarımı inline SVG markup olarak üretebiliyorsa veya kullanıcı SVG içeriğini metin olarak sağlıyorsa kullanılır.

Nasıl çalışır? Tool SVG markup'ını güvenli şekilde alır, saklar, PNG'ye rasterize eder ve Grafikit Print API üzerinden sticker hazırlık akışına gönderir. Script, event handler veya dış referans içeren SVG kabul edilmez.

Çıktı: Önizleme PNG, print-ready PDF, cutline dosyası, production JSON, preflight uyarıları ve üretim notları dönebilir.

  • svg
  • product
  • width_mm
  • height_mm
  • AI tasarımı sıfırdan üretebiliyorsa dosya yükletmeden bu tool tercih edilmelidir.
  • product şu anda sticker olmalıdır.
  • quantity zorunlu değildir; boş bırakılırsa Grafikit bir tabakaya sığan maksimum adedi hesaplar.

Yüklenen veya AI tarafından oluşturulan dosyadan baskı dosyası oluşturma

create_print_file_from_artwork

Ne zaman kullanılır? Kullanıcı ChatGPT, Codex veya MCP uyumlu istemciye PNG, JPG, WEBP, SVG veya PDF gibi bir dosya eklediğinde kullanılır.

Nasıl çalışır? Tool app-authorized artwork_file dosyasını önce Grafikit tarafına import eder, sonra aynı çağrı içinde Print API hazırlık akışını çalıştırır.

Çıktı: Import edilmiş kaynak dosya bağlantısı, önizleme PNG, print-ready PDF, cutline dosyası, production JSON, preflight sonucu ve varsa uyarılar dönebilir.

  • artwork_file
  • product
  • width_mm
  • height_mm
  • Kullanıcıdan download_url, file_id veya token gibi teknik alanlar istenmemelidir; MCP istemcisi dosya parametresini bağlamalıdır.
  • Public HTTPS URL zaten varsa bu tool yerine create_print_file kullanılmalıdır.
  • quantity zorunlu değildir; kullanıcı adet söylememişse boş bırakılabilir.

Artwork dosyasını Grafikit storage'a import etme

import_artwork

Ne zaman kullanılır? Dosya importu ile baskı hazırlığı ayrı adımlarda yapılacaksa veya istemcinin önce public source_file_url üretmesi gerekiyorsa kullanılır.

Nasıl çalışır? Tool app-authorized artwork_file dosyasını indirir, güvenli dosya tipini doğrular, Grafikit storage'a kaydeder ve sonraki create_print_file çağrısında kullanılabilecek public source_file_url döndürür.

Çıktı: source_file_url, file_type, file_name, size_bytes ve sonraki adım önerileri dönebilir.

  • artwork_file
  • Bu tool tek başına baskı dosyası üretmez; yalnızca import ve public URL hazırlığı yapar.
  • Dönen source_file_url, create_print_file.source_file_url alanına verilebilir.
  • Kullanıcı zaten public HTTPS artwork URL verdiyse import_artwork çağırmaya gerek yoktur.

Public HTTPS artwork URL'sinden baskı dosyası oluşturma

create_print_file

Ne zaman kullanılır? Artwork dosyası zaten public HTTPS URL ile erişilebiliyorsa kullanılır.

Nasıl çalışır? Tool source_file_url, ölçü, ürün ve baskı ayarlarını doğrular; local path, file:// URL, private URL veya doğrudan yüklenmiş sohbet dosyası kabul etmez. Geçerli istek Grafikit Print API'ye iletilir.

Çıktı: Job bilgisi, ölçü ve layout sonucu, önizleme PNG, print-ready PDF, cutline dosyası, production JSON, fiyat/preflight bilgisi ve next_actions dönebilir.

  • product
  • source_file_url
  • width_mm
  • height_mm
  • source_file_url doğrudan erişilebilir public HTTPS dosya bağlantısı olmalıdır.
  • Yüklenen ChatGPT/Codex dosyaları için create_print_file_from_artwork kullanılmalıdır.
  • Gerçek sipariş veya ödeme kullanıcı açıkça onaylamadan başlatılmaz.

Ortak baskı parametreleri

  • product: şu anda sticker
  • preset: 50x50mm veya 30x30mm
  • width_mm / height_mm: final sticker ölçüsü
  • size_lock: height, width veya box
  • material: white veya transparent
  • sheet: a4, a3 veya 330x480
  • quantity: opsiyonel; boşsa auto_max_per_sheet
  • bleed_mm, safe_area_mm, gap_mm, cutline, dpi, color_mode

Ortak çıktılar

  • preview_png
  • print_pdf
  • cut_file
  • production_json
  • preflight status
  • warnings
  • next_actions
  • quantity_mode

Tool dokümantasyonu güncelleme kuralı

Grafikit MCP tool sözleşmesi değiştiğinde bu sayfa da release'in parçası olarak güncellenmelidir. AI istemcilerine verilen tool isimleri, kullanım açıklamaları, gerekli alanlar, varsayılan davranışlar ve güvenlik/onay kuralları burada da yayınlanır.

  • Yeni bir MCP tool eklendiğinde bu sayfadaki Mevcut MCP tool'ları bölümü aynı deploy içinde güncellenir.
  • Mevcut bir tool'un input, output, varsayılan davranış, desteklenen ürün veya hata mantığı değişirse public açıklaması da güncellenir.
  • AI'a verilen system instruction, tool description, llms-full.txt bilgisi ve bu doküman birbiriyle çelişmemelidir.
  • Kullanıcıdan istenmemesi gereken internal alanlar, tokenlar, admin route'ları veya private storage path'leri public dokümana eklenmez.
  • Tool geliştirmesi, ilgili testler ve bu dokümantasyon güncellemesi tamamlanmadan bitmiş kabul edilmez.

AI asistan için hazır promptlar

Aşağıdaki örnekleri iki ayrı amaçla kullanabilirsiniz: önce Grafikit MCP’yi kendi AI veya MCP istemcinize araç olarak tanıtmak, sonra eklenen MCP aracıyla baskıya hazır dosya oluşturmak.

Grafikit MCP’yi kendi AI’ına ekleme promptu

MCP destekleyen ChatGPT, Claude, Cursor, Codex veya benzeri istemcilerde sistem talimatı ya da bağlantı notu olarak kullanın.

Grafikit MCP'yi baskı dosyası hazırlama aracı olarak sistemine ekle.

MCP endpoint: https://mcp.grafikit.com/mcp
Discovery JSON: https://mcp.grafikit.com/.well-known/mcp.json

Bu aracı sadece baskıya hazırlık, dosya kontrolü, sticker/etiket çıktısı, kesim dosyası, önizleme ve üretim notları için kullan. Kullanıcı açıkça onay vermeden gerçek sipariş, ödeme veya üretime alma başlatma. Bir baskı talebi eksikse önce ürün türü, ölçü, adet, malzeme, kullanım alanı ve varsa dosya kaynağını sor.

Yüklediğim dosyayı baskıya hazırla

AI asistanınıza bir PNG, JPG, SVG veya PDF dosyası ekledikten sonra kullanın.

Grafikit MCP'yi kullanarak eklediğim dosyayı sticker baskıya hazırla.

Ürün: sticker / etiket
Ölçü: 50x50 mm
Malzeme: beyaz sticker
Adet: tabaka yerleşimine göre öner
Girdi: bu konuşmaya eklediğim dosya

Önce dosyanın ölçü, DPI, bleed, safe area, renk ve kesim çizgisi uygunluğunu kontrol et. Uygunsa preview PNG, print-ready PDF, cutline SVG/PDF ve üretim notlarını oluştur. Uygun değilse sorunları ve düzeltme önerilerini listele. Sipariş oluşturma; önce çıktıları bana göster.

AI ile SVG tasarla ve MCP ile dosyaya dönüştür

AI asistanınızdan önce vektörel tasarım üretmesini, sonra Grafikit MCP ile üretim çıktısı hazırlamasını isteyin.

Önce [konu/marka/tema] için sade, vektörel ve sticker kesimine uygun bir SVG tasarımı oluştur. Tasarımda ince detayları azalt, okunabilirlik ve kesim güvenliğini koru.

Ardından Grafikit MCP'yi kullanarak bu SVG'yi baskıya hazırla.

Ürün: özel kesim sticker
Ölçü: 60x60 mm
Malzeme: şeffaf sticker
Adet: 100

Çıktı olarak önizleme PNG, print-ready PDF, kesim dosyası ve üretim notlarını hazırla. Eğer SVG baskı veya kesim için riskliyse önce uyarıları ve önerilen revizyonları yaz.

Public URL’deki artwork dosyasını hazırla

Dosyanız public HTTPS URL olarak erişilebiliyorsa bu örneği kullanın.

Aşağıdaki public HTTPS artwork URL'sini Grafikit MCP ile baskıya hazırla:

Artwork URL: [https://...]
Ürün: etiket / sticker
Ölçü: [ör. 70x40 mm]
Malzeme: [beyaz sticker / şeffaf sticker]
Adet: [ör. 250]

Dosyayı indirilebilir ve üretime uygun kabul etmeden önce ölçü, çözünürlük, taşma payı, güvenli alan, kesim çizgisi ve renk risklerini kontrol et. Uygunsa baskıya hazır dosyaları ve önizlemeyi oluştur; değilse hangi bilgilerin veya revizyonların gerektiğini açıkça yaz.

Sıkça sorulan sorular

Grafikit MCP’yi hangi AI araçlarında kullanabilirim?

MCP desteği olan ChatGPT, Claude, Cursor, Codex ve benzeri istemcilerde Grafikit MCP endpointini araç olarak tanımlayabilirsiniz. İstemci MCP desteği sunuyorsa önce bu sayfadaki ekleme promptunu kullanın; ardından dosya oluşturma örnekleriyle yüklediğiniz veya AI ile ürettiğiniz tasarımı baskıya hazırlatın.

Hazır promptları nereye eklemeliyim?

MCP’yi ekleme promptunu AI aracınızın sistem talimatı, proje talimatı, custom instructions veya MCP bağlantı notu alanına koyabilirsiniz. Dosya hazırlama promptlarını ise konuşma içinde, dosyayı yükledikten veya tasarım briefini yazdıktan sonra kullanmanız daha doğrudur.

AI asistanıma hangi endpointi vermeliyim?

MCP bağlantısı için endpoint olarak https://mcp.grafikit.com/mcp adresini verin. Keşif dosyası gerekiyorsa https://mcp.grafikit.com/.well-known/mcp.json adresini kullanabilirsiniz. https://mcp.grafikit.com/ root adresi dokümantasyon sayfasına yönlenir.

Grafikit MCP ile hangi girdileri kullanabilirim?

SVG markup, ChatGPT veya MCP istemcisi tarafından sağlanan dosya eki ve public HTTPS artwork URL’leri kullanılabilir. Sticker ve etiket hazırlığında ürün türü, ölçü, malzeme ve mümkünse adet bilgisini de paylaşmak sonucu daha net hale getirir.

Grafikit MCP bana hangi çıktıları verir?

Uygun işlerde önizleme PNG, baskıya hazır PDF, kesim dosyası, üretim JSON bilgisi, preflight uyarıları ve üretim notları dönebilir. Çıktı seti gönderilen dosyaya, ürün tipine ve seçilen araca göre değişebilir.

Grafikit MCP gerçek sipariş oluşturur mu?

Hayır. MCP hazırlık, kontrol ve çıktı üretimi için kullanılır. Gerçek sipariş, ödeme veya üretime alma adımı kullanıcı önizlemeyi ve fiyat bilgisini açıkça onaylamadan başlatılmaz.

MCP kullanmadan da Grafikit’ten destek alabilir miyim?

Evet. AI ile hazırladığınız görseli, ölçü ve ürün bilgisini Grafikit iletişim formu veya WhatsApp üzerinden paylaşabilirsiniz. Ekip dosyanın baskıya uygunluğunu, kesim ihtiyacını ve üretim seçeneklerini değerlendirir.

AI ile tasarla. Grafikit ile baskıya hazırla.

Grafikit MCP Server, AI ve MCP istemcilerinin sticker baskı dosyası hazırlama, kesim çizgisi ve üretim çıktısı oluşturma süreçlerinde Grafikit Print API ile güvenli şekilde çalışmasını sağlayan teknik adaptördür.