Yapay Zeka ile İşletme ve Mağaza Yönetimi Kurulum Rehberi (ChatGPT, Claude MCP, Hermes 3 ve Otomasyon)

EsnafSiteleri.com, işletmelerin ve mağazaların dijital vitrinlerini, firma profillerini ve ürün envanterlerini yapay zeka modelleriyle (ChatGPT, Claude Desktop, Cursor, açık kaynaklı Hermes 3 veya n8n / Zapier) oturdukları yerden yönetebilmeleri için Model Context Protocol (MCP) ve OpenAPI 3.1 altyapısı sunar.

Bu rehberde hiçbir karmaşık teknik terime takılmadan; işletmenize yapay zekadan akıllı bir dijital operasyon yöneticisi atamayı adım adım öğreneceksiniz.

1. Bu Sistem Ne İşe Yarar? (Akıllı Operasyon Yöneticisi) #

Düşünün ki işletmenize işine son derece hakim, hızlı ve 7/24 kesintisiz çalışan akıllı bir dijital operasyon yöneticisi atadınız. Yorulmaz, uyumaz ve daima talimatlarınızı bekler.

Geleneksel web sitelerinde mağazanıza 10 tane yeni ürün eklemek için bilgisayarın başına geçip:

• Tek tek formları doldurmanız,
• Fiyatları elinizle yazmanız,
• Uzun uzun ürün açıklaması üretmeniz,
• Stok durumlarını tek tek seçmeniz gerekirdi.

"Mağazama 450 TL'den hakiki deri cüzdan ekle, rengi kahverengi olsun, alıcıyı ikna eden emojili güzel bir açıklama yaz."

2. 1. Adım: İşletmenizin Güvenli API Anahtarını Alma #

Yapay zekanın başka bir işletmeye değil, sadece ve sadece sizin işletmenize ve mağazanıza erişebilmesi için ona özel bir "dijital yetki anahtarı" tanımlamanız gerekir:

1. esnafsiteleri.com hesabınıza giriş yapın.
2. Üst menüden Hesabım > İşletme & AI > AI Ajan (MCP/API) sekmesine tıklayın.
3. Yeni AI API Anahtarı Üret kutucuğuna anahtarınız için bir isim yazın (örneğin: ChatGPT Mağaza Yöneticim veya Ofis Bilgisayarım).
4. Yeni AI API Anahtarı Üret butonuna basın.
5. Karşınıza çıkan gizli anahtarı (örneğin: esnaf_live_...) hemen kopyalayın ve güvenli bir yere kaydedin.

1. Önemli Kural: Bu anahtarı kimseyle paylaşmayın. Eğer bir gün yapay zekanın erişimini kesmek isterseniz, aynı sayfadan İptal Et (Revoke) butonuna basarak botun yetkisini tek saniyede sonlandırabilirsiniz.

3. Yöntem 1: ChatGPT ile Özel GPT (Custom GPT) Kurulumu #

ChatGPT Plus veya Team üyeliğiniz varsa, 2 dakikada kendi özel mağaza yöneticinizi oluşturabilirsiniz:

Adım Adım Kurulum (Tıklama Tıklama Tarif): #

1. ChatGPT'yi Açın:

1. Asistan Oluşturucuya Geçin:

1. Yapılandırma Sekmesine Tıklayın:

1. İsim ve Tanım Verin:

• Name (İsim): Mağaza Yöneticim
• Description (Açıklama): EsnafSiteleri mağazamı ve ürünlerimi yöneten akıllı asistan

• Sayfayı en aşağıya kaydırın. Actions yazısının altındaki Create new action (Yeni eylem oluştur) butonuna basın.
• Açılan sayfada Import from URL (URL'den İçe Aktar) linkine tıklayın.
• Açılan kutucuğa şu hazır adresi yapıştırıp Import butonuna basın:

     https://esnafsiteleri.com/api/v1/openapi.json
     

1. İşletmenizin Güvenli Erişim Anahtarını Tanıtın:

• Aynı sayfada üstteki Authentication (Yetkilendirme) dişli simgesine tıklayın.
• Auth Type (Giriş Türü): API Key seçin.
• Auth Method: Bearer seçeneğini işaretleyin.
• API Key (Şifreniz): 1. Adımda aldığınız esnaf_live_... anahtarınızı yapıştırıp Kaydet deyin.

1. İşletme Yönetim Kurallarını (Master Skill) Yapıştırın:

• Geri dönün ve Configure ekranındaki Instructions (Talimatlar) kutusunu bulun.
• Hesabım > AI Ajan sayfasında sizin için hazır bekleyen Master Skill metnini veya https://esnafsiteleri.com/api/v1/skill.md adresindeki kuralları kopyalayıp bu kutunun içine yapıştırın.
• (💡 Ne oldu? Bu kural metni, ChatGPT'nin sizden habersiz kafasına göre fiyat değiştirmesini yasaklar, ürün silmeden önce sizden onay istemesini sağlar.)

• Sağ üst köşedeki yeşil Save (Kaydet) butonuna basın.
• Only me (Sadece ben) seçeneğini işaretleyip Confirm (Onayla) deyin.

ChatGPT'ye Ne Söyleyebilirsiniz? (Örnek Cümleler): #

• 👉 "Mağazama 450 TL'den hakiki deri cüzdan ekle, rengi kahverengi olsun, alıcıyı ikna eden emojili güzel bir açıklama yaz."
• 👉 "Şu an vitrinimde kaç ürün satışta? Fiyatları ve stok durumunu özetleyen bir tablo çıkar."
• 👉 "Kışlık montun fiyatını 1.200 TL yerine 990 TL olarak güncelle." (ChatGPT önce sizden onay isteyecektir!)
• 👉 "Bu hafta işletme profilimi kaç kişi ziyaret etmiş, WhatsApp sipariş butonuma basan olmuş mu?"

4. Yöntem 2: Claude Desktop ve Cursor ile Model Context Protocol (MCP) Kurulumu #

Bilgisayarınızda Anthropic Claude Desktop veya Cursor programı yüklüyse, internet tarayıcınızı bile açmadan mağazanızı yönetebilirsiniz.

Model Context Protocol (MCP) Nedir? #

2 Dakikada Kolay Kurulum: #

1. Ayar Dosyasını Açın:

• Windows Kullanıyorsanız: Klavyenizdeki Windows tuşu ile R tuşuna aynı anda basın. Açılan küçük pencereye %APPDATA%\Claude yazıp Tamam'a basın. Klasördeki claude_desktop_config.json dosyasını sağ tıklayıp Not Defteri ile açın. (Dosya yoksa boş bir Not Defteri açıp bu adla kaydedin).
• Mac Kullanıyorsanız: Finder'da CMD + Shift + G tuşlarına basıp ~/Library/Application Support/Claude/claude_desktop_config.json yolunu açın.
• Cursor Kullanıyorsanız: Cursor Settings > Features > MCP Servers bölümüne gidin.

   {
     "mcpServers": {
       "esnafsiteleri": {
         "url": "https://esnafsiteleri.com/api/v1/mcp",
         "headers": {
           "Authorization": "Bearer SIZIN_API_ANAHTARINIZ"
         }
       }
     }
   }
   

1. Kaydedin ve Claude'u Yeniden Başlatın:

5. Yöntem 3: Sıfır Maliyetli Yerel Modeller ve Otonom Ajanlar (Nous Hermes 3, OpenClaw, Ollama) #

Yapay zeka şirketlerine her ay 20-30 dolar ödemek istemiyorsanız ya da "Benim işletmemin verileri şirket dışına çıkmasın, tamamen benim bilgisayarımda kalsın" diyorsanız, açık kaynak yapay zeka modelleri tam size göredir.

A. Nous Hermes 3 (Ollama ile Bedava Çalıştırma) #

1. ollama.com adresinden Ollama programını bedava indirin.
2. Terminale veya Komut Satırına ollama run hermes3 yazın.
3. Aşağıdaki Python kodunu çalıştırarak Hermes 3'ün doğrudan mağazanıza ürün eklemesini izleyin:

import json, requests, ollama

API_KEY = "SIZIN_API_ANAHTARINIZ"
BASE_URL = "https://esnafsiteleri.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# Hermes 3 için mağaza yönetim araçlarını tanımlayın
tools = [
    {
        "type": "function",
        "function": {
            "name": "create_product",
            "description": "EsnafSiteleri mağazasına yeni ürün ekler",
            "parameters": {
                "type": "object",
                "properties": {
                    "title": {"type": "string"},
                    "price": {"type": "number"},
                    "description": {"type": "string"}
                },
                "required": ["title", "price"]
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "list_products",
            "description": "Mağazadaki tüm aktif ürünleri listeler",
            "parameters": {"type": "object", "properties": {}}
        }
    }
]

# Kendi bilgisayarınızdaki yerel Hermes 3 modeline komut verin
response = ollama.chat(
    model='hermes3',
    messages=[
        {'role': 'system', 'content': 'Sen benim otonom mağaza yöneticimsin.'},
        {'role': 'user', 'content': 'Mağazama 450 TL\'den deri cüzdan ekle.'}
    ],
    tools=tools
)

# Modelin ürettiği işlemi mağazaya aktarın
if response.message.tool_calls:
    for call in response.message.tool_calls:
        fn = call.function.name
        args = call.function.arguments
        if fn == 'create_product':
            res = requests.post(f"{BASE_URL}/products", headers=HEADERS, json=args)
            print("Ürün Eklendi! Sonuç:", res.json())

B. OpenClaw Otonom Ajan Yapılandırması (agent.json) #

{
  "agent": {
    "name": "MagazaYoneticisi",
    "model": "nousresearch/hermes-3-llama-3.1-70b",
    "system_prompt_url": "https://esnafsiteleri.com/api/v1/skill.md",
    "mcp_servers": [
      {
        "name": "esnaf_magaza",
        "url": "https://esnafsiteleri.com/api/v1/mcp",
        "headers": {
          "Authorization": "Bearer SIZIN_API_ANAHTARINIZ"
        }
      }
    ],
    "tasks": [
      "Stok durumunu denetle",
      "Haftalık performans raporunu çıkar",
      "SEO başlıklarını optimize et"
    ]
  }
}

6. Yöntem 4: Trendyol, Shopify veya Excel Tablosu ile Otomatik Eşitleme (n8n, Make, Zapier) #

Ürünlerinizi zaten Trendyol'da, Hepsiburada'da, Shopify'da satıyor musunuz? Ya da elinizde binlerce satırlık bir Excel tablosu mu var? Buraya gelip tek tek elle yüzlerce ürün girmekle günlerinizi harcamayın!

n8n, Make veya Zapier gibi otomasyon araçlarına:

"Şu Excel'e yeni ürün satırı eklendiğinde git EsnafSiteleri mağazama da ekle"

"Trendyol'da fiyat değiştiğinde git EsnafSiteleri mağazamdaki fiyatı da güncelle"

n8n / Make / cURL Örneği: #

• İstek Türü: POST
• Adres: https://esnafsiteleri.com/api/v1/products
• Başlıklar (Headers):
• Authorization: Bearer SIZIN_API_ANAHTARINIZ
• Content-Type: application/json
• Gövde (Body - JSON):

  {
    "title": "El Yapımı Deri Çanta",
    "price": 850.00,
    "currency": "TRY",
    "stock_status": "in_stock",
    "description": "Hakiki dana derisi, el dikimi sağlam dikişler."
  }
  

7. İçiniz Rahat Olsun: 3 Büyük Güvenlik Güvencemiz #

Yapay zekaya yetki anahtarınızı tanımlarken aklınıza şu sorular gelebilir: "Ya kafasına göre fiyat indirirse? Ya mağazamdaki ürünleri silerse?"
İçiniz tamamen rahat olsun; sistemimiz 3 aşamalı katı koruma kalkanıyla çalışır:

1. Sizden Habersiz Asla Fiyat Değişmez:

1. Kazara Ürün Silinmesi İmkansızdır:

1. Yalnızca Sizin İşletmenize Özeldir:

1. Taslak Firma Mantığı:

Sıkça Sorulan Sorular #

Yapay zeka API kullanımı benden AI Kredisi harcar mı? #

Yapay zeka ürünlerime fotoğraf ekleyebilir mi? #

Yapay zekanın ne yaptığını nereden görebilirim? #

İlgili Yardım Rehberleri #

• Yapay Zeka ile Web Sitesi Oluşturma
• Pazaryeri Ürünleri ve Favoriler
• Mağaza Açma ve Düzenleme
• Firma Ekleme ve Düzenleme