Metadata-Version: 2.4
Name: ticimax-mcp
Version: 0.1.0
Summary: Ticimax e-ticaret platformu için Claude MCP sunucusu
License: MIT
Keywords: claude,e-commerce,mcp,ticimax
Requires-Python: >=3.10
Requires-Dist: fastmcp
Requires-Dist: python-dotenv
Requires-Dist: requests
Requires-Dist: zeep
Description-Content-Type: text/markdown

# ticimax-mcp

Ticimax e-ticaret platformunu Claude ile yönetmek için MCP sunucusu.

Sipariş listeleme, stok güncelleme, ürün yönetimi, üye sorgulama ve daha fazlası.

## Kurulum

### 1. Claude Code settings.json'a ekle

`~/.claude/settings.json` dosyasına şu bloğu ekle:

```json
{
  "mcpServers": {
    "ticimax": {
      "command": "uvx",
      "args": ["ticimax-mcp"],
      "env": {
        "TICIMAX_ALAN_ADI": "magazan.com",
        "TICIMAX_YETKI_KODU": "ticimax-yetki-kodun"
      }
    }
  }
}
```

### 2. Yetki kodunu nereden alırsın?

Ticimax paneli → **Ayarlar → Entegrasyon → Web Servisleri** bölümünden yetki kodunu kopyala.

---

## Araçlar

| Araç | Ne Yapar |
|------|----------|
| `baglanti_test` | Servislerin çalışıp çalışmadığını kontrol eder |
| `siparis_listele` | Son N günün siparişlerini listeler |
| `siparis_detay` | Sipariş detayı + ürünler + ödeme bilgisi |
| `siparis_durumu_guncelle` | Sipariş durumunu değiştirir |
| `kargo_takip_no_ekle` | Siparişe kargo takip numarası ekler |
| `kargo_secenekleri_listele` | Kullanılabilir kargo firmalarını gösterir |
| `stok_guncelle` | Tek ürün stok güncelleme |
| `toplu_stok_guncelle` | Çoklu ürün stok güncelleme |
| `urun_listele` | Ürünleri listeler |
| `urun_ara` | İsme göre ürün arama |
| `varyasyon_listele` | Ürünün beden/renk varyasyonları |
| `urun_fiyat_guncelle` | Ürün fiyatı güncelleme |
| `indirimli_fiyat_uygula` | Toplu yüzdelik indirim uygulama |
| `kategori_listele` | Tüm kategorileri listeler |
| `marka_listele` | Tüm markaları listeler |
| `uye_listele` | Üyeleri listeler, mail/tel ile arama |
| `uye_adres_listele` | Üyenin kayıtlı adresleri |
| `kargo_firma_listele` | Tanımlı kargo firmaları |
| `iade_talepleri_listele` | İade taleplerini listeler |
| `il_listele` | Türkiye illeri |

## Örnek Kullanım

Claude'a şunları söyleyebilirsin:
- "Son 7 günün siparişlerini listele"
- "Sipariş #1234'ü kargoya verildi olarak işaretle"
- "XYZ ürününün stokunu 50 yap"
- "Tüm kategorileri göster"
- "İade taleplerini listele"
