Entegrasyon

MCP Sunucusu

Model Context Protocol (MCP) sunucusu ile yapay zeka ajanları (Claude, vb.) mağazanıza bağlanıp ürün, sipariş ve müşteri işlemlerini doğal dille yapabilir. Sunucu, Commerce API'nin üzerinde çalışır — aynı API anahtarı ve aynı yetkiler geçerlidir.

Uç nokta

POST https://www.arsigo.com/api/mcp

Streamable HTTP (JSON-RPC 2.0) protokolü kullanılır. Her istekte mağaza API anahtarınızıAuthorization: Bearer ark_… başlığıyla gönderin.

Bağlantı (Claude Desktop)

Yapılandırma dosyanıza Arsigo MCP sunucusunu ekleyin:

claude_desktop_config.json

{
  "mcpServers": {
    "arsigo": {
      "url": "https://www.arsigo.com/api/mcp",
      "headers": { "Authorization": "Bearer ark_xxxxxxxxxxxxxxxx" }
    }
  }
}

Anahtarınızda write yetkisi varsa ajan oluşturma/güncelleme araçlarını da çalıştırabilir. Yalnız okuma anahtarı verirseniz ajan yalnızca veri okuyabilir; yazma araçları reddedilir.

Araçlar (Tools)

Sunucu 15 araç sunar — her biri Commerce API'deki bir işleme karşılık gelir:

Araç	Açıklama	Yetki
get_store	Mağaza bilgisi ve anahtar yetkileri	read
list_orders	Siparişleri listele/filtrele	read
get_order	Sipariş detayı	read
update_order	Sipariş durumunu güncelle	write
fulfill_order	Siparişi kargola (takip no)	write
list_customers	Müşterileri listele/ara	read
get_customer	Müşteri detayı	read
create_customer	Müşteri oluştur	write
update_customer	Müşteri güncelle	write
list_products	Ürünleri listele/filtrele	read
get_product	Ürün detayı (varyant + stok)	read
create_product	Temel ürün oluştur	write
update_product	Ürün güncelle	write
add_variant	Ürüne varyant ekle	write
update_stock	Varyant stok adedini ayarla	write

Doğrudan test (JSON-RPC)

Araç listesini görmek için:

tools/list

curl -X POST "https://www.arsigo.com/api/mcp" \
  -H "Authorization: Bearer ark_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

Bir aracı çağırmak için:

tools/call

curl -X POST "https://www.arsigo.com/api/mcp" \
  -H "Authorization: Bearer ark_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": { "name": "list_orders", "arguments": { "status": "new", "limit": 5 } }
  }'