Codex ile Shopstage

Kurulum adımları

1. 1

   Shopstage panelinde Ayarlar > Entegrasyonlar bölümünden bir API anahtarı oluştur. Anahtar yalnızca bir kez gösterilir.

2. 2

   Anahtarı ortam değişkeni yap: export VITRIN_API_KEY=...

3. 3

   ~/.codex/config.toml dosyasına aşağıdaki bloğu ekle.

4. 4

   Codex'i yeniden başlat; vitrin araçları kullanıma açılır.

5. 5

   Anahtar yerine tarayıcıyla giriş yapmak istersen bearer_token_env_var satırını silip codex mcp login vitrin komutunu çalıştır (OAuth).

[mcp_servers.vitrin]
url = "https://shopstage.net/mcp"
bearer_token_env_var = "VITRIN_API_KEY"

Örnek istekler

• “Reels bekleyen ürünleri listele”
• “Kapı kolu ürünüm için premium Reels ve beyaz fon görselleri üret”

Neler yapabilir

• list_products

  Ürünleri listeler, arar, indirimdekileri süzer

• get_product

  Tek ürünün ayrıntısını getirir

• list_posts

  Gönderileri duruma göre listeler

• create_post

  Üründen gönderi, Reels, karusel veya hikâye oluşturur

• approve_post

  Taslağı onaylar

• reschedule_post

  Yayın zamanını değiştirir

• cancel_post

  Planlı gönderiyi iptal eder

• publish_now

  Gönderiyi hemen yayınlar

• generate_captions

  Ürün için açıklama metinleri üretir

• plan_week

  Haftalık yayın takvimini planlar

• get_report

  Performans raporunu getirir

• list_channels

  Bağlı sosyal hesapları listeler

• get_store

  Bağlı mağazanın bilgisini getirir

• sync_store

  Mağaza kataloğunu yeniden eşitler

• get_usage

  Plan kotası ve kullanımı gösterir

• generate_ad_creatives

  Ürünlerden reklam görselleri, metinleri ve hedef kitle önerisi üretir

• get_ad_copy

  Tek ürün için reklam başlık ve metinleri yazar

• export_ad_pack

  Meta Ads Manager CSV'sini ve görsel adreslerini verir

• detect_product_category

  Ürünün kategorisini bulur

• list_shot_presets

  Çekim stillerini listeler (beyaz fon, yaşam tarzı...)

• list_video_motions

  Video hareketlerini ve maliyetini listeler

• generate_product_media

  Ürün fotoğrafından AI görselleri ve kısa video üretir

• get_media_job

  Üretilen bir çıktının durumunu getirir

• list_media_assets

  AI çekim kütüphanesini listeler

• list_orders

  Siparişleri tarih, durum ve kaynağa göre listeler

• get_order

  Tek siparişin ayrıntısını getirir

• list_whatsapp_leads

  WhatsApp sipariş taleplerini listeler

• mark_lead_sold

  WhatsApp talebini satıldı olarak işler

• get_storefront

  Mağaza sayfası adresini ve QR kodunu verir

• creator_generate_ideas

  İçerik üreticiler için fikir üretir

• creator_generate_script

  Reels senaryosu yazar

• list_brand_deals

  Marka işbirliklerini listeler

• create_brand_deal

  Yeni marka teklifini işbirliklerine ekler

• update_brand_deal_stage

  İşbirliğinin aşamasını günceller

• get_media_kit

  Medya kitini getirir

• calculate_rate

  Gönderi ve Reels için fiyat aralığı hesaplar

• get_creator_earnings

  Kazanç, bekleyen ödemeler ve marka dökümü