not_found döner. Yazma araçları (save_draft, propose_edit) yalnızca bağlantıda themes:write kapsamı olduğunda listelenir.
Sonuçlar, güvenilmeyen veri bloğuna sarılmış JSON’dur. Hatalar, code alanı olan araç hatalarıdır: invalid_input, not_found, forbidden, conflict, limit, busy, unsupported veya internal.
Tipik iş akışı
- Platformun neleri desteklediğini öğrenmek için
get_reference(konuoverview, ardından tema türüyle birlikte örneğincommerceveyaapp_blocks). - Kopyayı bulmak için
list_themes, ardındanlist_files,read_fileveyasearch. - Okumanızdan gelen
baseHashilesave_draft. - Dosyayı
validateile doğrulayın; yüklenen bir tasarım içinscançalıştırın. preview_linkalın ve bağlantıyı kullanıcıya verin. Kullanıcı panelde yayınlar.
Okuma araçları
get_reference
Düzenleyicinin vevalidate’in kullandığı aynı kayıt defterinden üretilen platform referansı. Mağaza verisi içermez.
Kompakt JSON döndürür. Örneğin
{ "topic": "app_blocks", "name": "buy_now" }; bloğun türleri, zorunluluk bayrakları ve takma adlarıyla argümanlarını, davranışını ve tema türüne göre desteğini döndürür.
Kaynaklar
Aynı referans MCP kaynakları olarak da kullanılabilir (resources/list, resources/read, resources/templates/list):
list_themes
Mağazanın tema kopyaları: Liquid temaları, yüklenen tasarımlar ve tema kod paketleri;id, name, kind, live ve updatedAt ile birlikte. Argümanı yoktur.
list_files
En fazla 400 adet
files (path, size, kind, contentHash) ve truncated döndürür.
read_file
content, contentHash, startLine, endLine ve totalLines döndürür. İkili medya dosyaları içerik olmadan binary: true döndürür.
read_files
Her biri
content ve contentHash içeren files döndürür, toplamda en fazla 1 MB. Eksik dosyalarda missing: true bulunur; boyut bütçesini aşan dosyalarda skipped bulunur.
search
path, line, column ve satır önizlemesi içeren eşleşmeler döndürür.
get_schema
path olmadan: config/settings_schema.json içindeki tema ayarları ve adı, ayar id’leri ve blok türleriyle birlikte her bölüm. path ile: bölümün tam {% schema %} JSON’u. Her iki yanıt da sectionObject içerir: bölüm alanları ve section.css_id notu.
validate
path ve proposalId olmadan, tüm kopyayı yayınlamada olduğu gibi doğrular. valid ve problems (path, line, column, message, severity) döndürür. Tema kod paketlerinde CSS’te veya id=/for= içinde ham bir section.id bir warning’dir (valid değerini asla false yapmaz). Ayrıca bilinmeyen uygulama bloklarını, bilinmeyen veya yanlış türde argümanları (bir “bunu mu demek istediniz” önerisiyle), tema türünün desteklemediği blokları, bilinmeyen PapelShip çağrılarını ve orada hiç çalışmayan SDK çağrılarını (örneğin Liquid tema sayfalarındaki satır içi script’leri) işaretler.
scan
Tasarım güvenlik tarayıcısının deneme çalıştırması. Hiçbir şey kaydedilmez. Liquid temaları
unsupported döner.
preview_link
PapelShip panelindeki önizlemeye giden bir bağlantı olan
url döndürür. Kullanıcının giriş yapmış olması gerekir. Kopyanın kaydedilmiş (taslak) dosyalarını gösterir. Tıklamaları, geçişleri ve bağlantıları bu sayfada test edin; görsel düzenleyici tuvali tıklamada seçim yapar.
Yazma araçları
save_draft
themes:write gerektirir.
content veya edits argümanlarından tam olarak birini gönderin. Kayıtlar düzenleyici kayıtları gibi doğrulanır; geçersiz bir dosya ilk sorunla birlikte invalid_input döner.
Her sonuç, düzenleyici tanılamalarından gelen
problems alanını içerir, örneğin kod paketlerindeki section.css_id uyarısı.
propose_edit
themes:write gerektirir. save_draft ile aynı argümanların yanı sıra zorunlu, tek satırlık bir summary alır; note kullanılmaz. Asla kaydetmez: öneri, sahibinin kod düzenleyicide kabul etmesini bekler ve 24 saat sonra süresi dolar. Her değişikliğin sahibi tarafından incelenmesini istediğinizde kullanın.
Protokol
- Taşıma: Streamable HTTP, JSON yanıtlar, oturum yok.
GETisteği405döner. - Protokol sürümleri:
2025-11-25,2025-06-18,2025-03-26,2024-11-05. - Toplu istekler: en fazla 10 mesaj. Her mesaj hız limitine dahil edilir.
- Yetkilendirme:
https://app.papelship.com/.well-known/oauth-protected-resource/mcpadresinden keşfedilen PKCE’li OAuth 2.1 ya da Bearer token olarak gönderilen bir Themes API anahtarı.