Kaynaklar · SoCode

SocialHub'ı Claude Code konumundan çalıştırın

SoCode, Claude Code (ve Claude Desktop / Cursor) için SocialHub entegrasyonudur: indirilebilir bir beceri ve yönetilen bir MCP sunucusu. SocialHub'ı sade bir dille çalıştırın ve verilerinizi sorun.

Başla Neden SoCode?

claude · socialhub (mcp)

› sade bir dille sorun

siz › Geçen hafta mağazaya göre GMV, ilk 3▋

↳ yönetilen metrik · gmv · mağazaya göre · last_7d

Mağaza 042$128,400

Mağaza 017$96,250

Mağaza 233$81,900

anlamsal katmandan · SQL yok · denetlendi · açıklayıcı

01 — Genel Bakış

SoCode nedir?

SoCode, SocialHub'ın yapay zeka asistanınıza bağlanma şeklidir. Birlikte çalışan iki parçadan oluşur; böylece Claude, SocialHub'u çalıştırabilir ve, siz editörünüzden ayrılmadan verilerinizle ilgili soruları sade bir dille yanıtlayabilir.

Beceri

`flash-operations`

İndirilebilir Claude öğreten beceri Claude SocialHub'ı güvenli bir şekilde nasıl kullanacağınız — hangi aracı kullanacağınız, üye adı/e-postasıyla yazma işlemlerini onaylama ve yalnızca belirlenen ölçüm rakamlarını kullanma.

Sunucu

Yönetilen MCP sunucu

SocialHub araçlarını (bağlılık, üyeler, kuponlar, kampanyalar ve yönetilen ölçümleriniz) ortaya çıkaran, kiracı API anahtarıyla kimliği doğrulanan ve araç başına yetkilendirilen bir Model Bağlam Protokolü uç noktası.

02 — Neden önemli

Neden SoCode?

Verileriniz ve operasyonlarınız, ekibinizin zaten kullandığı yapay zeka araçlarından erişilebilir - yönetişimden ödün vermeden.

Doğal dil, gösterge paneli yok

Sade İngilizce olarak sorun; Claude doğru yönetilen aracı seçer ve çalıştırır. Ekranlar arasında tıklamak yok, yazılacak SQL yok.

Tasarım gereği yönetilir ve güvenlidir

Metrik sayılar SocialHub'ın semantik katmanından gelir (yapay zeka asla rakamlar uydurmaz). Yazma işlemleri bir yazma kapsamı gerektirir ve sunucu tarafı korumasından geçer. Her tuş ekibinize özeldir; her çağrı denetlenir.

Zaten çalıştığınız yerde çalışır

Claude Code, Claude Desktop, Cursor — herhangi bir MCP istemcisi. Tek komutla bir kez bağlanın ve asistanınızdan ayrılmadan SocialHub'u çalıştırın.

Salt okunur olarak başlat

Şununla başlayın: metrics:read Önceden ayarlanmış (yapay zeka için en güvenlisi). Yalnızca puan vermeniz veya kupon düzenlemeniz gerektiğinde yazma kapsamları ekleyin; kontrol sizde kalır.

Daha Önce Mümkün Olmayanlar SoCode

Bunların her biri, sizin sahip olmadığınız bir analiste, mühendise veya kontrol paneline ihtiyaç duyuyordu; dolayısıyla soruyu soran kişi nadiren zamanında yanıt alıyordu. Bunları mümkün kılan, kendi yapay zeka aracınızın içindeki yönetilen bir aracı'dır: verilerinizin kontrolünden vazgeçmeden, kurumsal düzeyde yanıtlar ve eylemler, kendi kendine hizmet. Kilit açma noktası budur; daha hızlı bir kontrol paneli değil, farklı bir işletim modeli.

★ Elde tutma pazarlamacısı · temel döngü

“Ayrılmaya doğru kayan üyeleri bulun, geri kazanma kampanyası başlatın ve hedefime göre ayarlamaya devam edin.”

ÖnceHaftalar boyunca üç ekip ve üç araç: Bir analist verileri çeker, bir pazarlamacı kampanyayı oluşturur, birisi gelecek ay sonuçları kontrol eder; o zamana kadar o an geçmiş olur ve döngü aslında hiçbir zaman kapanmaz.

SoCode ileTek bir ajan döngüsü analiz → yürütme → iyileştirme yapar: yönetilen metrikleri okur, onayladığınız yolculuğu başlatır, artışı ölçer ve sürekli olarak, belirlediğiniz hedeflere ve güvenlik önlemlerine göre yeniden ayarlar.

Büyüme / analitik lideri

“Geçen hafta mağazaya göre GMV — ve bu ay neden kullanım oranları düştü?”

ÖnceBir talep gönderin ve bir analist bekleyin veya panolar arasında bir araya getirin — cevap, karar zaten verildikten sonra gelir.

SoCode ileSaniyeler içinde yönetilen, güvenilir bir yanıt — karar, bir sezgiye değil, verilere dayanarak verilir.

Yapay zeka / makine öğrenimi mühendisi

SocialHub'ın yönetilen ölçümlerini kendi asistanınıza veya MCP üzerinden bir Cursor iş akışına gösterin.

ÖnceÖzel bir entegrasyon, elle yazılmış sorgular ve sıfırdan yeniden uygulanan yönetim — aylarca süren çalışma ve sayıların kayması için yeni bir yer.

SoCode ileTek bir kapsamlı anahtar ve yönetilen katman, yığınınızdan çağrılabilir. Eskiden bir proje olan entegrasyon, bir yapılandırma satırıdır.

Pazarlama Müdürü

“Aktif üye sayısı geçen aya göre düştü mü? Bunu kademelere göre inceleyin.”

ÖnceBunu aylık incelemede fark edersiniz - ay zaten geçtikten sonra.

SoCode ileŞüphelendiğiniz anda kendi kendine hizmet veren, çok adımlı teşhis — sızıntıyı hala harekete geçebilecekken yakalayın.

03 — 3 adımda kurulum

SoCode nasıl çalışır?

Üç adım: beceriyi indirin, MCP sunucusunu kurun ve doğal dilde kullanın.

1. SoCode'ı (beceri) indirin

SoCode becerisi (flash-operations), Claude'ye SocialHub'u nasıl güvenli bir şekilde kullanacağını öğretir. 2. adımda ekleyeceğiniz SocialHub MCP sunucusuyla eşleşir.

Beceri klasörünü edinin

# Pull just the SoCode skill into Claude Code
npx degit huangchunbo2025/flash/skills/flash-operations \
  ~/.claude/skills/flash-operations

Veya GitHub'da göz atın/indirin → skills/flash-operations. Klasörü ~/.claude/skills/ (kişisel) veya projenizin .claude/skills/ klasörüne kopyalayın.

Beceri isteğe bağlıdır ancak önerilir; MCP sunucusu bu beceri olmadan çalışır; SoCode'in becerisi Claude'nin onu iyi kullanmasını sağlıyor.

2. MCP sunucusunu kurun

a) Bir API anahtarı oluşturun

SocialHub'da Ayarlar → API Anahtarlar → Anahtar Oluştur bölümüne gidin ve "Salt okunur" ön ayarını seçin (yapay zeka kullanımı için en güvenlisi olan metrics:read'ı içerir; yazma kapsamlarını yalnızca puan vermeniz veya kupon düzenlemeniz gerektiğinde ekleyin). Anahtar yalnızca bir kez gösterilir; kopyalayın.

API Tuşlarına gidin

b) Sunucuyu Claude Code'a ekleyin

Önce anahtarı bir ortam değişkeni olarak dışa aktarın, böylece düz metin anahtarı hiçbir zaman kabuk geçmişinize veya bir yapılandırma dosyasına girmez:

export FLASH_API_KEY="fl_live_your_key_here"

claude mcp add --transport http flash \
  https://flash.socialhub.ai/api/mcp \
  --header "Authorization: Bearer ${FLASH_API_KEY}"

Yapılandırmayı mı tercih ediyorsunuz? Depo kökünüze proje kapsamlı bir .mcp.json ekleyin — env var'a bakın, asla düz metin anahtarı yapıştırmayın:

{
  "mcpServers": {
    "flash": {
      "type": "http",
      "url": "https://flash.socialhub.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FLASH_API_KEY}"
      }
    }
  }
}

c) Doğrula

claude mcp list komutunu çalıştırın — flash bağlı olarak görünmelidir.
Claude'den "mevcut SocialHub araçlarını listele" yapmasını isteyin — yalnızca anahtarınızın kapsamlarının izin verdiği araçları göreceksiniz.
Sunucu adı tam olarak flash olmalı ve Claude Code'ı başlatan kabukta FLASH_API_KEY dışa aktarılmalıdır. Geçersiz bir anahtar, başarısız bağlantı olarak görünür.

3. Kullanın

Sadece Claude'a sade bir dille sorun. Örneğin:

Verilerinizi sorgulayın

“Sorgulayabileceğim metrikleri listeleyin.”
“Geçen hafta mağazaya göre GMV.”
“Bu ay ödemeler neden düştü?”

İşlemleri çalıştırma

“Alice'e (alice@…) 200 puan verin.”
“Aktif kupon havuzlarını listele.”
"Bu üye için bir elçi kodu yayınlayın."

Kontrolü elinizde tutun

Yazma işlemleri çalıştırılmadan önce onaylanır.
Sunucu tarafındaki kapasite sınırları, aşırı büyük yazma işlemlerini engeller.
Her aramayı API Anahtarlar → Son MCP Etkinlik altında görün.

Tasarım gereği güvenli. Metrik sayılar SocialHub'ın yönetilen anlamsal katmanından gelir (yapay zeka asla SQL yazmaz veya rakamlar uydurmaz). Yazma işlemleri, yazma kapsamı gerektirir ve sunucu tarafı korumasını (çağrı başına değer sınırı + hız sınırı) geçer — sohbet onayı nezaket gereğidir, sunucu sınırdır. Her tuş yalnızca ekibiniz için geçerlidir.

MCP Kılavuz (tam referans)REST API Referans API Anahtarlarını Yönetin Kaynaklara Geri Dön