Trendyol Satıcı MCP nedir? Mağazanı asistana bağlamak, kurulum, yazma riskleri ve gerekenler

Asistana siparişlerini, ürünlerini, müşteri sorularını ya da iadeleri sorarsın; Trendyol Satıcı MCP senin Trendyol API bilgilerinle Trendyol Pazaryeri satıcı API'sine bağlanıp cevabı getirir. Kodda 6 araç var: 4'ü okur, 2'si yazar (müşteri sorusuna herkese açık cevap, toplu stok ve fiyat güncelleme); yazma araçları varsayılan kapalıdır. Koray Nar adlı bir geliştiricinin MIT lisanslı topluluk projesi, Trendyol'un ürünü değil. Trendyol satıcı hesabı, Satıcı ID, API Key ve API Secret, Python 3.11+ ve uv gerekir.

Ne yapar: Asistana Trendyol mağazanı sordurur
Tür: MCP sunucusu (yerel, topluluk projesi, Trendyol'un değil)
Nerede: Claude Code, Claude Desktop; diğer istemciler README'de adıyla anılıyor
Yazar mı: Evet, ama varsayılan kapalı: soru cevaplama, stok ve fiyat
Test durumu: Yalnız sahte yanıtlarla; canlı API'de denenmemiş
Türkçe: Mağaza verin Türkçe gelir; araç metinleri İngilizce, yanıt dili asistana bağlı
Ücret: Yazılım ücretsiz (MIT); Trendyol satıcı hesabın gerekir

Trendyol Satıcı MCP ne işe yarar?

MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Bu sunucu Trendyol'un satıcı API'sini asistana açar: "Kargoya verilmemiş siparişlerim hangileri" ya da "cevap bekleyen müşteri sorularım ne" diye sorarsın; asistan siparişleri, ürünlerin stok ve fiyatını, müşteri sorularını ve iade taleplerini getirir. Varsayılan hâlinde yalnız okur, mağazanda bir şeyi değiştirmez.

SenSiparişi, soruyu ya da iadeyi sorarsın

AsistanClaude Code, Claude Desktop

Trendyol Satıcı MCPBilgisayarında çalışır

Trendyol satıcı APISenin API Key ve Secret'inle

Okuyan 4 araç hep açık; yazan 2 araç (soru cevaplama, stok ve fiyat) varsayılan kapalı, bir ortam değişkeniyle açılır.

Siparişleri listeletmekNe alırsın: Sipariş durumu, tutar, kalemler, müşteri şehriAyrı kurulum gerekir Ürün, stok ve fiyat listesiNe alırsın: Barkod, başlık, stok, satış ve liste fiyatı, onay durumuAyrı kurulum gerekir Soruya herkese açık cevapNe alırsın: Trendyol'da herkese açık cevapAyrı kurulum gerekir

Altı araç, kodda ve README'de şöyle ayrılıyor: okur: get_products, get_orders, get_customer_questions, get_claims. yazar: answer_question (müşteri sorusuna herkese açık cevap) ve update_price_and_stock (barkoda göre stok ve fiyat, tek çağrıda en çok 1000 kalem). Silme aracı yok; ürün oluşturma, kargo etiketi ve fatura uç noktaları da yok.

Kime yarar: Trendyol'da satış yapan ve sipariş ile soru takibini asistanla hızlandırmak isteyen işletmelere. Trendyol'un ürünü değil; yazar kendisi "çalışan bir araç ama sahte yanıtlarla test edilmiş" diyor, mağazanda kullanmadan önce riskleri bil.

Trendyol Satıcı MCP nasıl kurulur?

Gerekenler: Trendyol satıcı hesabı ve Satıcı ID, API Key, API Secret (Satıcı Paneli › Hesap Bilgilerim › Entegrasyon Bilgileri; Trendyol belgesine göre bu bilgiler yalnız master user, yani admin rolü ile girince görünür), Python 3.11 ve üstü, ayrıca uv aracı. Hazır paket yok: PyPI ve npm'de kaydı bulunmadı, depoyu bilgisayarına indirip kurarsın.

Önce depoyu indir ve kur (README)

› git clone https://github.com/koraynar/trendyol-seller-mcp
cd trendyol-seller-mcp
uv venv && uv pip install -e '.[dev]'

README'deki komut (yolu ve anahtar değerlerini kendininkilerle değiştir):

Claude Code

› claude mcp add trendyol-seller \
  --env TRENDYOL_SELLER_ID=123456 \
  --env TRENDYOL_API_KEY=your-key \
  --env TRENDYOL_API_SECRET=your-secret \
  -- uv run --directory /absolute/path/to/trendyol-seller-mcp trendyol-seller-mcp

claude_desktop_config.json dosyasına şu girdiyi ekle (README örneği):

claude_desktop_config.json

› { "mcpServers": { "trendyol-seller": { "command": "uv", "args": ["run", "--directory", "/absolute/path/to/trendyol-seller-mcp", "trendyol-seller-mcp"], "env": { "TRENDYOL_SELLER_ID": "123456", "TRENDYOL_API_KEY": "your-key", "TRENDYOL_API_SECRET": "your-secret" } } } }

Anahtar ve gizli anahtar yapılandırma dosyasında düz metin durur. Trendyol belgesi API bilgilerinin GitHub gibi açık platformlarda paylaşılmamasını özellikle istiyor: dosyayı paylaşma, depoya ekleme ve yedeklere dikkat et.

Kaynak: README (Quickstart, Configuration), Trendyol Authorization sayfası; 15.10.2026. Yazma araçlarını açmak için env bloğuna "TRENDYOL_ALLOW_WRITES": "true" eklenir; ilk kurulumda ekleme.

Trendyol Satıcı MCP nasıl kullanılır?

Yazma kapalıyken başla ve yalnız okuma işlerini dene.

Sorgula"Trendyol'da son 7 günün siparişlerini durumlarına göre say ve iptal edilenleri listele. Hiçbir şeyi değiştirme."

Soruları gör"Cevap bekleyen müşteri sorularını listele ve her biri için kısa bir cevap TASLAĞI yaz. Henüz hiçbirini yayımlama."

Müşteri soruları dışarıdan gelen metindir. Yazma açıkken asistan bir soruyu talimat gibi okursa yanlış şey yapabilir; cevap herkese açık yayımlanır. Bu bir çıkarımdır, README yazmıyor: yazmayı yalnız cevabı kendin okuyup onayladığın işler için aç ve istemcinde araç onayını açık tut.

Trendyol belgesine göre soru cevabı 10–2000 karakter olmalı, bir soru yalnız bir kez cevaplanır ve cevaplar yasaklı kelime denetiminden geçer.

Trendyol Satıcı MCP hangi programlarda çalışır?

Claude CodeVar	README claude mcp add komutunu veriyor.
Claude DesktopVar	README yapılandırma dosyası örneğini veriyor.
Diğer MCP istemcileriNet değil	README giriş cümlesi "any other MCP client" diyor ama kurulum örneği yok; "belgede yok" demek "çalışmaz" demek değildir.

Çalışma yeri yerel: sunucu bilgisayarında çalışır, yalnız Trendyol API'sine (apigw.trendyol.com) bağlanır.

Trendyol Satıcı MCP mağazanda neyi okur, neyi değiştirir?

Okur

Ürünler (barkod, başlık, stok, fiyat), sipariş paketleri (numara, durum, tutar, kalemler, müşteri şehri), müşteri soruları ve iade talepleri. Siparişte müşteri adı ve tam adres varsayılan gizli; include_pii=true ile açılır. Soru ve iade çıktılarında müşteri adı yok.

Yazar

Müşteri sorusuna herkese açık cevap yayımlar ve barkoda göre stok ile fiyat günceller (en çok 1000 kalem). İkisi de yalnız TRENDYOL_ALLOW_WRITES=true ile çalışır. Trendyol belgesine göre aynı stok-fiyat isteği 15 dakika içinde tekrarlanamaz.

Silme

Silme aracı yok. Ürün oluşturma, kargo etiketi, fatura ve webhook uç noktaları da yok (README sınırları).

Veri nereye gider

Asistanın gördüğü sipariş, soru ve iade verisi kullandığın yapay zekâ hizmetinin sunucusuna gider; o hizmetin gizlilik koşulları geçerli.

Yazma bayrağı yalnız araç tarafındaki bir korumadır; Trendyol anahtar çiftin kendisi yazma yetkili ve sınırsız. Trendyol'un resmî sayfalarında salt-okur ya da kısıtlı yetkili anahtar anlatılmıyor. Denemek istersen Trendyol'un test (stage) ortamı var ve README TRENDYOL_BASE_URL ile ona yönlendirmeyi anlatıyor; ancak Trendyol belgesine göre test ortamı ayrı hesap ve API bilgisi, IP yetkilendirmesi ve Trendyol'a bildirim gerektiriyor. GitHub Security Advisories ve OSV taramasında kayıt yok; bu "güvenli" demek değildir.

Bakım durumu (15.10.2026, GitHub): 2 commit, 0 yıldız, 0 açık issue, ilk sürüm v0.1.0 (28.08.2026). Yazar "Trendyol API'si her an değişebilir" ve "yalnız sahte yanıtlarla test edildi" diyor.

Trendyol Satıcı MCP ücretsiz mi?

Yazılım MIT lisanslı ve ücretsiz. Çalışması için Trendyol satıcı hesabı gerekir; Trendyol'un API erişimi için ayrı bir ücret resmî sayfalarda yazmıyor. Kullandığın yapay zekâ hizmetinin kendi ücreti ayrıdır.

Yapabilirsin

MIT: kodu kullanmak ve değiştirmek serbest

Yasak

Trendyol API kullanım koşulları ayrıca geçerli; geliştirici sayfalarında bu adla bir sayfa görünmüyor
Trendyol'un resmî sayfalarında üçüncü taraf yapay zekâ aracı kullanımına dair hüküm görünmüyor

Kaynak: README, GitHub lisans bilgisi, Trendyol geliştirici belgeleri; 15.10.2026. Bu bir hukuki ya da ticari görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Yazma aracı "refused" diyor	Beklenen davranış: `TRENDYOL_ALLOW_WRITES=true` yoksa iki yazma aracı reddeder. Açmak istersen env bloğuna ekle ve sunucuyu yeniden başlat.
429 hatası	Trendyol aynı uç noktaya 10 saniyede en çok 50 istek izin veriyor. Araçta yeniden deneme yok; bekleyip tekrar dene.
401 ClientApiAuthenticationException	Trendyol'a göre kimlik doğrulaması hatalı: Satıcı ID, API Key ve Secret'ı panelden kontrol et. Canlı ve test ortamının bilgileri farklıdır.
Aynı stok ya da fiyat isteği hata veriyor	Trendyol: değişiklik yapmadan aynı isteği tekrar atarsan 15 dakika boyunca hata döner; yalnız değişenleri gönder.

Trendyol Satıcı MCP nasıl kaldırılır?

Bağlantıyı sil: Claude Code'da claude mcp remove trendyol-seller; Claude Desktop'ta yapılandırma dosyasından trendyol-seller girdisini sil ve yeniden başlat.
Anahtarı temizle: API bilgilerini yapılandırma dosyasına yazdıysan sil; yedeklerde ya da eşitlenen klasörlerde kalmış olabilir.
API anahtarı: Anahtarı yenileme ya da iptal etme yolu resmî Trendyol sayfalarında yazmıyor; Trendyol satıcı destek bildirimi üzerinden sor.

Sık sorulan sorular

Bu Trendyol'un resmî MCP'si mi?

Hayır. README "unofficial" ve "Not affiliated with Trendyol" diyor; Koray Nar adlı bireysel geliştiricinin projesi. Resmî MCP kayıt defterinde listelenmesi projenin Trendyol'a ait olduğunu göstermez.

Asistan mağazamda fiyat ya da stok değiştirebilir mi?

Yalnız TRENDYOL_ALLOW_WRITES=true ayarlarsan. Varsayılan kapalı. Açıkken tek çağrıda 1000 kalem güncellenebilir ve canlı satışı etkiler; istemcinde araç onayını açık tut.

Müşteri bilgileri asistana gider mi?

Sipariş çağrısında müşteri adı ve adresi varsayılan gizli, yalnız şehir gelir; include_pii=true ile açılır. Gelen veri kullandığın yapay zekâ hizmetinin sunucusuna gider.

Önce denemek için test ortamı var mı?

Trendyol'un stage ortamı var ve README ona yönlendirmeyi anlatıyor. Ama test ortamı ayrı hesap ve API bilgisi, IP yetkilendirmesi gerektiriyor ve Trendyol'dan istenmesi gerekiyor. Salt-okur anahtar resmî sayfalarda anlatılmıyor.

Canlı Trendyol hesabıyla denenmiş mi?

README yalnız sahte yanıtlarla test edildiğini söylüyor.

İlgili rehberler

Borsa MCP efatura-kontrol e-Fatura MCP İhale MCP iyzico MCP (qwertyvan)iyzico MCP (seyithanalkan)

Kaynaklar

Resmî kaynaklarda net olmayanlar: Trendyol API kullanım koşulları ve üçüncü taraf yapay zekâ aracı kullanımına bakışı · salt-okur ya da kısıtlı yetkili anahtar olup olmadığı · README'nin "SelfIntegration" kimliğinin topluluk yazılımı için doğru olup olmadığı · anahtarı yenileme yolu · canlı Trendyol'a karşı çalıştığı · Cursor gibi diğer istemcilerde çalıştığı. Her biri ilgili bölümde yazılı.