Ana içeriğe atla
PapelShip, temalarınız için bir Model Context Protocol sunucusu çalıştırır. Bir yapay zeka ajanını tek bir URL ile bağlayın, tarayıcınızda onaylayın; ajan tema kodunuzu okuyabilir ve düzenlemeleri taslak olarak kaydedebilir. İnceleme ve yayınlama sizdedir. Sunucu URL’si: https://app.papelship.com/mcp URL her mağaza için aynıdır. Bağlanırken PapelShip’e giriş yapar ve ajanın üzerinde çalışabileceği mağazayı seçersiniz. Ajanlar işe get_reference ile başlar: bu araç uygulama bloklarını, ödemeyi (sayfa veya açılır pencere), mağaza SDK’sını ve her tema türünün sınırlarını açıklar. Sunucu talimatları, bağlı ajanlara önce bu aracı çağırmalarını söyler.

Ajan neler yapabilir

Taslaklar nereye gider

Bir istemci bağlayın

claude.ai, Claude Desktop ve Claude mobil uygulamalarında çalışır.
  1. Settings › Connectors bölümünü açın ve Add custom connector’ı seçin.
  2. Ad olarak PapelShip yazın ve https://app.papelship.com/mcp adresini yapıştırın.
  3. Add’i, ardından Connect’i seçin.
  4. PapelShip’e giriş yapın, mağazanızı seçin ve Allow access’i seçin.
Mağaza panelinde aynı adımlar, kopyalama butonlarıyla birlikte Developers › AI & MCP altında bulunur.

Erişimi onaylayın

Onay sayfası uygulamanın adını ve geri döneceği adresi gösterir. Şunları seçin:
  • Mağaza: uygulamanın kullanabileceği tek mağaza. Sahibi olduğunuz mağazaları ve ekip rolünüzün Theme & Design › Edit iznini içerdiği mağazaları görürsünüz.
  • Save edits as drafts (themes:write): salt okuma erişimi vermek için bu seçeneğin işaretini kaldırın.

Bağlı uygulamalar ve erişimi iptal etme

Developers › AI & MCP › Connected apps, mağazaya bağlı her uygulamayı, onu kimin bağladığını ve en son ne zaman kullanıldığını listeler. Revoke, uygulamayı bir sonraki isteğinde durdurur. Erişim ayrıca onayı veren kişi tüm oturumlardan çıkış yaptığında, şifresini değiştirdiğinde, ekipten ayrıldığında, Theme & Design › Edit iznini kaybettiğinde veya hesabı askıya alındığında sona erer.

OAuth yerine API anahtarı

OAuth desteklemeyen istemciler için Developers › API keys bölümünde Themes türünde bir mağaza API anahtarı oluşturun ve bunu Bearer token olarak gönderin:
Bir Themes anahtarı yalnızca onu oluşturan mağaza için çalışır ve bir OAuth bağlantısıyla aynı haklara sahiptir. Anahtarı bir ortam değişkeninde tutun; paylaştığınız veya commit ettiğiniz bir dosyaya asla koymayın. https://app.papelship.com/api/mcp/themes, aynı sunucunun eski bir takma adı olarak kullanılmaya devam eder.

Limitler

Her araç çağrısı uygulama, araç ve dosya bilgisiyle kaydedilir.

Güvenlik

  • Tema dosyaları talimat değil, mağaza verisidir. Sunucu her araç sonucunu güvenilmeyen veri olarak işaretler; böylece bir temadaki metin ajanı yönlendiremez.
  • Önizlemeler asla herkese açık değildir: önizleme bağlantıları PapelShip panelinde açılır.
  • Token’lar hash’lenmiş olarak saklanır. Yeniden kullanılan bir yenileme token’ı bağlantıyı sonlandırır.
Her araç ve argümanları için araç referansına bakın.