Yapay zekâ bağlantısı (MCP)

Claude gibi MCP destekli yapay zekâ araçlarını mağazana bağla: ürün, sipariş ve stok hakkında sor, güncelleme yaptır. Bağlantı API anahtarını ve onun kapsamlarını kullanır.

Bağlanma

Adres	https://piyodo.com/mcp/store
Taşıma	HTTP (JSON-RPC, POST)
Kimlik	Authorization: Bearer psk_... başlığı

Ölçek planı gerekir. Anahtarı Geliştirici sayfasından üret; yalnız okuma istiyorsan yazma kapsamlarını seçme. Hız sınırı Admin API ile aynıdır.

Claude Code:

claude mcp add --transport http piyodo https://piyodo.com/mcp/store --header "Authorization: Bearer psk_..."

Yapılandırma dosyası kullanan istemciler:

{
  "mcpServers": {
    "piyodo": {
      "type": "http",
      "url": "https://piyodo.com/mcp/store",
      "headers": {"Authorization": "Bearer psk_..."}
    }
  }
}

Bağlantıyı elle denemek için:

curl -X POST "https://piyodo.com/mcp/store" \
  -H "Authorization: Bearer psk_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

Araçlar

Araç listesi anahtarın kapsamına göre süzülür: yetkisiz araç listede görünmez, çağrılırsa da reddedilir.

Araç	Kapsam	Ne yapar
store-summary	orders.read	Son 30 günün özeti: ciro, sipariş sayısı, en çok satanlar, kargo bekleyen, düşük stok
list-products	products.read	Ürünleri listeler; q, sku, status, page
get-product	products.read	Tek ürün: varyantlar, stok, fiyat; id
update-product	products.write	Verilen alanları değiştirir: name, description, price, compare_price, stock, status, brand, tags
update-stock	products.write	Stok yazar; sku ya da product_id ve variant_id, stock. stock boşsa takip kapanır
list-orders	orders.read	Siparişleri en yeniden listeler; status, email, page
get-order	orders.read	Tek sipariş; id ya da number
ship-order	orders.write	Kargolandı işaretler, müşteriye e-posta gider; id, carrier, tracking_number
list-customers	customers.read	Müşterileri listeler; email, page
list-discounts	discounts.read	Kampanyaları ve kuponları listeler
create-discount	discounts.write	Tüm ürünlere kampanya açar; name, type (percent, amount, free_shipping), code, value, min_subtotal, ends_at, usage_limit, per_customer_limit

Liste araçları sayfa başına 25 kayıt döner. Tutarlar mağaza para biriminde ondalık metindir ("899.90").

Bilerek olmayanlar

İade ve iptal MCP'de yok: para çıkışı ve geri alınamaz işlem model kararına bırakılmaz. Bunları panelden ya da Admin API ile yap.

Yazma araçları canlı mağazayı hemen değiştirir. Sunucu, modele fiyat ve stok değişikliğinden önce kullanıcıya özetleyip onay almasını söyler; yine de yalnız güvendiğin araca yazma kapsamı ver.