oudzi

Entegrasyon · Claude

Oudzi verilerine
Claude'dan eriş.

Oudzi bağlayıcısı, Claude'un mağazanın kataloğunu, stoğunu, müşterilerini, WhatsApp konuşmalarını, siparişlerini ve satış performansını okumasını sağlar. Bağlayıcı salt okunurdur: hiçbir veriyi değiştiremez, mesaj gönderemez, sipariş oluşturamaz.

Claude'a girilecek bağlayıcı adresi

https://oudzi.com/api/mcp

Adresi tam olarak bu şekilde gir: www olmadan, sonunda / olmadan. Bu bağlayıcı Oudzi tarafından geliştirilir ve sunulur; Anthropic tarafından geliştirilmiş bir ürün değildir.

1. Ne işe yarar?

Claude'a doğal dille soru sorarsın ("Bu hafta en sıcak müşteri adaylarım kimler?", "42 numara siyah sneaker stokta var mı?"), Claude da yanıtı Oudzi çalışma alanındaki gerçek verilerden okur. Bağlayıcı yalnızca aşağıdaki 10 okuma aracını sunar:

  • search_products — Senkronize katalogda yayındaki ürünleri ada, kategoriye, renge, bedene, fiyata ve stoğa göre arar.
  • get_product_details — Tek bir ürünün fiyat, stok durumu, kategori, kısa açıklama ve varyant bilgilerini getirir.
  • check_inventory — Bir ürünün ya da varyantın son senkronizasyondaki stok durumunu gösterir.
  • find_hot_leads — Satın almaya yakın (sıcak) ve ilgili (ılık) müşteri adaylarını listeler.
  • get_customer — Bir müşterinin özetini getirir; telefon ve e-posta varsayılan olarak maskelidir.
  • get_conversations — WhatsApp konuşmalarını son etkinliğe göre listeler.
  • get_conversation — Tek bir konuşmanın mesajlarını sayfa sayfa getirir (varsayılan 20 mesaj).
  • get_orders — Senkronize siparişleri en yeniden eskiye listeler; Oudzi atıf türüne göre filtrelenebilir.
  • get_order — Tek bir siparişin kalemlerini, tutarını ve atıf bilgisini getirir.
  • get_sales_performance — Son 7, 30, 90 gün ya da tüm zamanlar için sipariş sayısı, ciro ve Oudzi atıf dağılımını özetler.

Hiçbir araç yazma, silme, mesaj gönderme, sipariş/stok/fiyat değiştirme, ödeme ya da SQL/HTTP/dosya erişimi sunmaz. Veriler, mağazanın Oudzi'ye son senkronizasyonunu yansıtır; canlı depo sayımı değildir.

2. Nasıl bağlanır?

  • Bir Oudzi hesabın ve en az bir çalışma alanın olmalı. Claude tarafında özel bağlayıcı (custom connector) ekleyebildiğin bir plan gerekir; Team ve Enterprise planlarında önce kuruluş sahibinin bağlayıcıyı eklemesi gerekebilir.
  • Claude'da bağlayıcı ayarlarından özel bağlayıcı ekle ve adres olarak https://oudzi.com/api/mcp gir.
  • "Bağlan"a bastığında Oudzi giriş sayfası açılır. Giriş yap, Claude'un okuyacağı çalışma alanını seç ve izinleri onayla.
  • Bağlantı tek bir çalışma alanına bağlıdır. Başka bir çalışma alanı için ayrıca bağlan.

3. İzinler ve roller

Onay ekranında hangi izinlerin verileceğini görürsün. Claude yalnızca verdiğin izinlerle ve çalışma alanındaki rolünün izin verdiği ölçüde okuma yapabilir; rolün her çağrıda yeniden kontrol edilir.

  • catalog:readEn düşük rol: İzleyici

    Ürün adları, fiyatlar, varyantlar ve açıklamalar.

  • inventory:readEn düşük rol: İzleyici

    Ürün ve varyantların stok durumu.

  • crm:readEn düşük rol: Temsilci

    Müşteri adları ve özetleri; telefon ve e-posta maskelenmiş olarak.

  • conversations:readEn düşük rol: Temsilci

    Konuşma geçmişi ve mesaj içerikleri.

  • orders:readEn düşük rol: Temsilci

    Sipariş durumu, tutarlar ve ürünler.

  • analytics:readEn düşük rol: Temsilci

    Ciro, sipariş sayıları ve atıf istatistikleri.

  • crm:piiEn düşük rol: Yönetici
    Hassas · varsayılan değil

    Tam telefon numarası ve e-posta adresi. Yalnızca yöneticiler verebilir.

Müşteri telefon ve e-posta bilgileri varsayılan olarak maskeli döner. Maskelenmemiş iletişim bilgisi (crm:pii) yalnızca açıkça istendiğinde ve bir çalışma alanı sahibi ya da yöneticisi onayladığında verilir.

4. Gizlilik ve güvenlik

  • Bağlantı OAuth 2.1 (PKCE) ile kurulur; şifren Claude ile paylaşılmaz. Erişim anahtarları Oudzi'de yalnızca özetlenmiş (hash) olarak saklanır, bir saat geçerlidir ve yenileme anahtarları her kullanımda yenilenir.
  • Her istek yalnızca bağlandığın çalışma alanının verisini okur. Araçlar çalışma alanı, mağaza ya da kullanıcı kimliği kabul etmez; bu bilgiler oturumdan alınır.
  • Oudzi, Claude'daki sohbet geçmişine, belleğe ya da dosyalarına erişmez. Oudzi'ye yalnızca Claude'un bir aracı çağırırken gönderdiği parametreler (ör. arama kelimesi, ürün kimliği) ulaşır.
  • Her araç çağrısı için güvenlik ve destek amacıyla bir kayıt tutulur: hangi aracın, hangi çalışma alanı, kullanıcı ve bağlantı için, ne zaman çağrıldığı, sonucu (başarılı/hata türü) ve süresi. Araç parametreleri ve dönen veriler bu kayda yazılmaz.
  • Mesaj metinleri ve ürün açıklamaları gibi serbest metinler müşteri ya da mağaza tarafından yazılmıştır ve Claude'a veri olarak iletilir.

Ayrıntılar için Gizlilik Politikası'na bakabilirsin.

5. Bağlantıyı kaldırma

  • Oudzi'de Ayarlar → Bağlı Uygulamalar sayfasından bağlantıyı kaldırdığında tüm erişim anahtarları anında iptal edilir.
  • Bağlayıcıyı Claude'dan kaldırmak Claude tarafındaki bağlantıyı siler. Oudzi tarafındaki yetkinin de hemen sona ermesi için Bağlı Uygulamalar sayfasından da kaldır.
  • Çalışma alanından çıkarılan bir kullanıcının bağlantısı bir sonraki istekte otomatik olarak iptal edilir; aboneliği askıya alınmış çalışma alanlarında bağlayıcı çalışmaz.

6. Sorun giderme

  • Claude sunucuya ulaşamıyor: adresin tam olarak https://oudzi.com/api/mcp olduğundan emin ol (www ve sondaki / olmadan), bağlayıcıyı kaldırıp yeniden ekle.
  • İzin hatası: Claude bir aracın gerektirdiği izni (requiredPermission) bildirir. Bağlantıyı kaldırıp yeniden bağlan ve o izni onayla; rolün yetmiyorsa çalışma alanı sahibinden ya da yöneticisinden yetki iste.
  • Sonuç boş: mağaza henüz bağlanmamış ya da senkronize edilmemiş olabilir. Oudzi panelinde mağaza bağlantısını ve son senkronizasyonu kontrol et. Boş bir sonuç hata değildir; Claude veri uydurmaz.
  • Geçici hata: kısa bir süre sonra tekrar dene. Sorun sürerse hata yanıtındaki reference kodunu destek ekibine ilet.

7. Destek ve güvenlik bildirimi

Bağlayıcı ile ilgili sorular için kenzyc25@gmail.com adresine yaz. Bir güvenlik açığı bildirmek için aynı adrese "Güvenlik" konulu e-posta gönder; bildirimi herkese açık paylaşmadan önce bize düzeltme için zaman tanımanı rica ederiz. Kişisel verilerle ilgili başvurular için kenzyc25@gmail.com. Tüm iletişim kanalları

English summary

The Oudzi connector lets Claude read one Oudzi e-commerce workspace: synced catalog, inventory, customers, WhatsApp conversations, orders and sales analytics. It is read-only — it cannot modify data, send messages, create orders, move money or run SQL, HTTP or code. Connector URL: https://oudzi.com/api/mcp (Streamable HTTP, OAuth 2.1 with PKCE).

  • search_products (catalog:read) — Search published products in the synced catalog by name, category, color, size, price and stock.
  • get_product_details (catalog:read) — Get one product's price, stock status, categories, short description and variants.
  • check_inventory (inventory:read) — Check a product's or variant's stock as of the last catalog sync.
  • find_hot_leads (crm:read) — List leads that are close to buying (hot) or qualified (warm).
  • get_customer (crm:read) — Get a customer summary; phone and email are masked by default.
  • get_conversations (conversations:read) — List WhatsApp conversations by latest activity.
  • get_conversation (conversations:read) — Read one conversation's messages, paged (20 messages by default).
  • get_orders (orders:read) — List synced orders, newest first, optionally filtered by Oudzi attribution type.
  • get_order (orders:read) — Get one order's line items, totals and attribution.
  • get_sales_performance (analytics:read) — Summarize order counts, revenue and the Oudzi attribution breakdown for the last 7, 30, 90 days or all time.

Permissions: catalog:read, inventory:read, crm:read, conversations:read, orders:read, analytics:read by default, each limited by the user's workspace role (catalog/inventory: viewer; everything else: agent). Customer phone and email are masked unless a workspace admin or owner explicitly grants crm:pii. Oudzi does not access Claude chat history, memory or files; it logs tool name, outcome and timing per call, never arguments or results. Disconnect any time in Oudzi under Settings → Connected Apps (revokes all tokens immediately) and remove the connector in Claude. Support: kenzyc25@gmail.com. This connector is built and operated by Oudzi and is not an Anthropic product.