İ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.
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 arka plan kaldırma, sticker print/cut, 13x18 davetiye ve A5 broşür hazırlama araçlarına standart bir protokol üzerinden erişmesini sağlar.
- Streamable HTTP MCP endpoint
- Ürün odaklı print/cut 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; arka plan kaldırma, sticker, davetiye ve broşür hazırlama araçlarını yayınlar. MCP bağlantısı kuramayan istemciler aynı developer key ile REST fallback endpointini kullanabilir.
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, davetiye ve broşür işlerinde ölçü, taşma payı, kesim/trim çizgisi, tabaka yerleşimi ve önizleme gerekir.
- Opak raster görsellerde arka plan kaldırma işlemi baskı hazırlığından önce ayrı bir kaynak dosya adımı gerektirebilir.
- 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 app-authorized dosya, inline SVG veya public HTTPS artwork URL girdisini Grafikit Print API hazırlık akışına bağlar.
transparent PNG source_file_url
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ışı
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.
MCP yoksa REST fallback kullanır
İstemci MCP bağlantısı kuramıyor ama HTTPS REST çağrısı yapabiliyorsa https://api.grafikit.com/print/developer/prepare endpointini aynı Authorization: Bearer grf_mcp_live_... developer key ile kullanabilir.
Dosya veya SVG gönderir
AI istemcisi tam olarak bir kaynak seçer: app-authorized artwork_file, inline SVG markup veya public HTTPS source_file_url.
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 ve etiket print/cut hazırlığı
- 13x18 cm davetiye, kart ve invite hazırlığı
- A5 broşür, flyer ve handout hazırlığı
- Opak raster görseller için arka plan kaldırma
- SVG kaynaklı baskı dosyaları
- Yüklenmiş veya AI tarafından oluşturulmuş 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. MCP bağlantısı kurulamayan ama HTTPS REST çağrısı yapabilen istemciler için fallback endpoint https://api.grafikit.com/print/developer/prepare adresidir. Bu REST endpoint aynı developer key ile Authorization: Bearer grf_mcp_live_... header'ı kullanır. 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.
MCP endpoint
https://mcp.grafikit.com/mcp
Discovery JSON
https://mcp.grafikit.com/.well-known/mcp.json
API gateway
https://api.grafikit.com/
REST fallback
https://api.grafikit.com/print/developer/prepare
AI Print sayfası
Mevcut MCP tool'ları
Grafikit MCP şu anda arka plan kaldırma, ürün odaklı print/cut hazırlığı ve generic fallback akışları için sekiz public tool yayımlar. AI istemcisi önce kullanıcının ürünü ve elindeki girdiyi belirlemeli, sonra uygun tool'u seçmelidir.
Opak raster görselden transparan PNG üretme
remove_background- artwork_file
- Kullanıcı arka planı korumak istiyorsa bu tool çağrılmamalıdır.
- Varsayılan engine auto, refine none olmalıdır; farklı motor seçimi yalnızca açık ihtiyaç varsa yapılır.
- Dönen source_file_url, ürün odaklı hazırlama tool'larında source_file_url olarak kullanılabilir.
Sticker print/cut dosyası hazırlama
prepare_sticker_print_cut_file- width_mm
- height_mm
- Width ve height zorunludur; sticker preset verildiğinde istemci yine kullanıcı niyetindeki final ölçüyü netleştirmelidir.
- Kullanıcı özellikle adet istemediyse requested_quantity gönderilmez; Grafikit tabakaya sığan maksimum yerleşimi hesaplar.
- Şeffaf veya arka planı kaldırılmış kaynaklarda alpha channel kesim çizgisi için kullanılabilir.
13x18 davetiye, kart veya invite dosyası hazırlama
prepare_invitation_13x18_print_cut_file- Varsayılan ölçü 130x180 mm, varsayılan preset 13x18cm'dir.
- Kullanıcı farklı ölçü isterse width_mm ve height_mm ile açıkça belirtilmelidir.
- Bu tool sticker yerine davetiye/kart niyeti net olduğunda seçilmelidir.
A5 broşür veya flyer baskı dosyası hazırlama
prepare_a5_brochure_print_file- Varsayılan ölçü 148x210 mm, varsayılan preset a5'tir.
- Kesim/trim ve registration mark ayarları gerektiğinde tool parametreleriyle yönetilir.
- Ürün niyeti A5 broşür/flyer değilse uygun ürün odaklı tool veya generic fallback seçilmelidir.
Generic fallback: SVG'den baskı dosyası oluşturma
create_print_file_from_svg- svg
- product
- width_mm
- height_mm
- Sticker, davetiye veya A5 broşür için önce ürün odaklı tool tercih edilmelidir.
- Bu tool generic fallback olarak çalışır; ürün parametresi gerektirir.
- quantity zorunlu değildir; boş bırakılırsa Grafikit bir tabakaya sığan maksimum adedi hesaplar.
Generic fallback: yüklenen dosyadan baskı dosyası oluşturma
create_print_file_from_artwork- artwork_file
- product
- width_mm
- height_mm
- Sticker, davetiye veya A5 broşür için önce ürün odaklı tool tercih edilmelidir.
- 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- artwork_file
- Bu tool tek başına baskı dosyası üretmez; yalnızca import ve public URL hazırlığı yapar.
- Dönen source_file_url, ürün odaklı hazırlama tool'larına veya create_print_file.source_file_url alanına verilebilir.
- Kullanıcı zaten public HTTPS artwork URL verdiyse import_artwork çağırmaya gerek yoktur.
Generic fallback: public HTTPS artwork URL'sinden baskı dosyası oluşturma
create_print_file- product
- source_file_url
- width_mm
- height_mm
- source_file_url doğrudan erişilebilir public HTTPS dosya bağlantısı olmalıdır.
- Sticker, davetiye veya A5 broşür için önce ürün odaklı tool tercih edilmelidir.
- 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
- artwork kaynağı: artwork_file, svg veya source_file_url değerlerinden tam olarak biri
- product: generic fallback araçlarında ürün türü
- preset: 50x50mm, 30x30mm, 13x18cm veya a5 gibi tool'a göre değişen hazır ölçü
- width_mm / height_mm: final ürün ölçüsü
- size_lock: height, width veya box
- material: sticker işlerinde white veya transparent
- sheet: a4, a3 veya 330x480
- requested_quantity: ürün odaklı tool'larda opsiyonel; boşsa auto_max_per_sheet
- quantity: generic fallback araçlarında opsiyonel; kullanıcı açıkça adet istemediyse gönderilmez
- bleed_mm, safe_area_mm, gap_mm, cutline, dpi, color_mode
Ortak çıktılar
- source_file_url
- transparent PNG output
- preview_png
- production_pdf
- print_pdf
- cut_file
- production_json
- preflight status
- warnings
- price
- 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, ürün odaklı seçim kuralları, 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 veya ürün odaklı tool ismi değiştiğ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 üç amaçla kullanabilirsiniz: önce Grafikit MCP’yi kendi AI veya MCP istemcinize araç olarak tanıtmak, sonra ürüne uygun hazırlama tool'unu seçmek, gerekiyorsa arka plan kaldırma adımını baskı hazırlığından önce çalıştırmak.
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ü, arka plan kaldırma, sticker/etiket print-cut, 13x18 davetiye, A5 broşür, kesim/trim dosyası, önizleme ve üretim notları için kullan. Ürün niyeti belliyse önce ürün odaklı tool'u seç. 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.Arka planı kaldırıp sticker hazırlama
Opak raster görsel sticker olarak kesilecekse iki adımlı akış için kullanın.
Yüklediğim görselin arka planını kaldır ve ardından Grafikit MCP ile sticker baskıya hazırla.
Önce remove_background aracıyla transparan PNG source_file_url üret. Sonra bu source_file_url değerini prepare_sticker_print_cut_file aracına aktar.
Ürün: sticker / etiket
Ölçü: 50x50 mm
Malzeme: beyaz sticker
Adet: kullanıcı belirtmediyse otomatik tabaka yerleşimi
Sipariş oluşturma; önce önizleme, print PDF, cut file, preflight uyarıları ve üretim notlarını göster.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
Ürün niyeti sticker olduğu için prepare_sticker_print_cut_file aracını kullan. Önce dosyanın ölçü, DPI, bleed, safe area, renk ve kesim çizgisi uygunluğunu kontrol et. Uygunsa preview PNG, print-ready PDF, cut file 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 prepare_sticker_print_cut_file aracıyla 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]
Ürün sticker/etiket ise prepare_sticker_print_cut_file aracını kullan. 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?
Inline SVG markup, ChatGPT veya MCP istemcisi tarafından sağlanan app-authorized dosya eki ve public HTTPS artwork URL’leri kullanılabilir. Ürün odaklı tool'larda bu kaynaklardan tam olarak biri gönderilmelidir. Sticker, davetiye ve broşür hazırlığında ürün türü, ölçü, malzeme ve varsa adet bilgisini paylaşmak sonucu daha net hale getirir.
Grafikit MCP bana hangi çıktıları verir?
Uygun işlerde transparan PNG source_file_url, önizleme PNG, baskıya hazır PDF, kesim veya trim dosyası, üretim JSON bilgisi, layout, quantity_mode, fiyat, 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, 13x18 davetiye, A5 broşür ve arka plan kaldırma gibi baskıya hazırlık akışlarında Grafikit Print API ile güvenli şekilde çalışmasını sağlayan teknik adaptördür.
