Sumber Daya · SoCode

Jalankan SocialHub dari Claude Code

SoCode adalah integrasi SocialHub untuk Claude Code (dan Claude Desktop / Cursor): keterampilan yang dapat diunduh ditambah server MCP yang diatur. Operasikan SocialHub — dan tanyakan tentang data Anda — dengan bahasa yang mudah dipahami.

Mulai Mengapa SoCode?

claude · socialhub (mcp)

› tanyakan dalam bahasa yang mudah dipahami

Anda › GMV minggu lalu berdasarkan toko, 3 teratas▋

↳ metrik yang diatur · gmv · berdasarkan toko · last_7d

Toko 042$128,400

Toko 017$96,250

Toko 233$81,900

dari lapisan semantik · tanpa SQL · diaudit · ilustratif

01 — Gambaran Umum

Apa itu SoCode?

SoCode adalah cara SocialHub terhubung ke asisten AI Anda. Ini adalah dua bagian yang bekerja bersama — sehingga Claude dapat mengoperasikan SocialHub dan menjawab pertanyaan tentang data Anda, dalam bahasa yang mudah dipahami, tanpa Anda harus meninggalkan editor Anda.

Keahlian

`flash-operations`

Keterampilan Claude yang dapat diunduh yang mengajarkan Claude cara menggunakan SocialHub dengan aman — alat mana yang harus digunakan, mengkonfirmasi penulisan berdasarkan nama/email anggota, dan hanya mengutip angka metrik yang diatur.

Server

Server yang diatur MCP

Titik akhir Protokol Konteks Model yang mengekspos alat-alat SocialHub — loyalitas, anggota, kupon, kampanye, dan metrik yang Anda kelola — diautentikasi oleh kunci penyewa API dan diotorisasi per alat.

02 — Mengapa ini penting

Mengapa SoCode?

Data dan operasi Anda, dapat diakses dari alat AI yang sudah digunakan tim Anda — tanpa mengorbankan tata kelola.

Bahasa alami, tanpa dasbor

Tanyakan dalam bahasa Inggris sederhana; Claude memilih alat yang diatur yang tepat dan menjalankannya. Tidak perlu mengklik layar, tidak perlu menulis SQL.

Diatur & aman berdasarkan desain

Angka metrik berasal dari lapisan semantik SocialHub (AI tidak pernah mengarang angka). Penulisan memerlukan cakupan penulisan dan melewati pengamanan sisi server. Setiap kunci dicakup untuk tim Anda; setiap panggilan diaudit.

Berfungsi di tempat Anda sudah bekerja

Claude Code, Claude Desktop, Cursor — klien MCP apa pun. Terhubung sekali dengan satu perintah dan operasikan SocialHub tanpa meninggalkan asisten Anda.

Mulai mode baca saja

Mulailah dengan preset metrics:read (paling aman untuk AI). Tambahkan cakupan tulis hanya ketika Anda perlu memberikan poin atau menerbitkan kupon — Anda tetap memegang kendali.

Apa yang sebelumnya tidak mungkin dilakukan SoCode

Masing-masing hal ini dulunya membutuhkan analis, insinyur, atau dasbor yang tidak Anda miliki — sehingga orang yang mengajukan pertanyaan jarang mendapatkan jawaban tepat waktu. Agen yang diatur oleh di dalam alat AI Anda sendiri adalah yang memungkinkan hal ini: jawaban dan tindakan tingkat bisnis, layanan mandiri, tanpa melepaskan kendali atas data Anda. Itulah kuncinya — bukan dasbor yang lebih cepat, model operasi yang berbeda.

★ Pemasar retensi · siklus inti

“Temukan anggota yang cenderung berhenti berlangganan, luncurkan upaya untuk memenangkan kembali pelanggan, dan terus sesuaikan dengan tujuan saya.”

SebelumTiga tim dan tiga alat selama berminggu-minggu: seorang analis mengambil data, seorang pemasar membangun kampanye, seseorang memeriksa hasilnya bulan depan — pada saat itu momen telah berlalu dan siklus tidak pernah benar-benar tertutup.

Dengan SoCodeSatu siklus agen berjalan menganalisis → mengeksekusi → meningkatkan: ia membaca metrik yang diatur, meluncurkan perjalanan yang Anda setujui, mengukur peningkatan, dan menyesuaikan kembali — terus menerus, terhadap tujuan dan batasan yang Anda tetapkan.

Pemimpin Pertumbuhan / Analitik

“GMV minggu lalu berdasarkan toko — dan mengapa penukaran turun bulan ini?”

SebelumAjukan permintaan dan tunggu analis, atau gabungkan di seluruh dasbor — jawabannya tiba setelah keputusan sudah dibuat.

Dengan SoCodeJawaban yang teratur dan tepercaya dalam hitungan detik — keputusan dibuat berdasarkan data, bukan firasat.

Insinyur AI / ML

Ekspos metrik yang diatur SocialHub ke asisten Anda sendiri atau alur kerja Cursor melalui MCP.

SebelumIntegrasi khusus, kueri yang ditulis tangan, dan tata kelola yang diimplementasikan ulang dari awal — berbulan-bulan kerja, dan tempat baru bagi angka untuk bergeser.

Dengan SoCodeSatu kunci lingkup dan lapisan yang diatur dapat dipanggil dari tumpukan Anda. Integrasi yang dulunya merupakan proyek kini menjadi baris konfigurasi.

Manajer pemasaran

“Apakah jumlah anggota aktif menurun dibandingkan bulan lalu? Uraikan berdasarkan tingkatan.”

SebelumAnda akan menyadarinya dalam tinjauan bulanan — setelah bulan tersebut sudah berlalu.

Dengan SoCodeDiagnosis mandiri multi-langkah saat Anda bertanya-tanya — tangkap kebocoran selagi Anda masih dapat bertindak.

03 — Pengaturan dalam 3 langkah

Cara kerja SoCode

Tiga langkah: unduh keterampilan, instal server MCP, dan gunakan dalam bahasa alami.

1. Unduh SoCode (keterampilan)

Skill SoCode (flash-operations) mengajarkan Claude cara mengemudikan SocialHub dengan aman. Skill ini dipasangkan dengan server SocialHub MCP yang akan Anda tambahkan pada langkah 2.

Dapatkan folder keterampilan

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

Atau telusuri/unduh di GitHub → skills/flash-operations. Salin folder tersebut ke ~/.claude/skills/ (pribadi) atau .claude/skills/ proyek Anda.

Keahlian ini opsional tetapi direkomendasikan — server MCP berfungsi tanpanya; keahlian SoCode hanya membuat Claude menggunakannya dengan baik.

2. Instal server MCP

a) Buat kunci API

Di SocialHub, buka Pengaturan → API Kunci → Buat Kunci dan pilih preset "Hanya baca" (termasuk metrics:read — paling aman untuk penggunaan AI; tambahkan cakupan tulis hanya jika Anda perlu memberikan poin atau menerbitkan kupon). Kunci ditampilkan sekali — salinlah.

Buka API Tombol

b) Tambahkan server ke Claude Code

Ekspor kunci sebagai variabel lingkungan terlebih dahulu, sehingga kunci teks biasa tidak pernah masuk ke riwayat shell Anda atau file konfigurasi:

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}"

Lebih suka konfigurasi? Tambahkan .mcp.json yang lingkupnya proyek di root repositori Anda — referensikan variabel lingkungan, jangan pernah menempelkan kunci teks biasa:

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

c) Verifikasi

Jalankan claude mcp list — flash akan menunjukkan terhubung.
Minta Claude untuk "daftar alat SocialHub yang tersedia" — Anda hanya akan melihat alat yang diizinkan oleh cakupan kunci Anda.
Nama server harus persis flash, dan FLASH_API_KEY harus diekspor di shell yang meluncurkan Claude Code. Kunci yang tidak valid akan ditampilkan sebagai koneksi yang gagal.

3. Gunakan

Cukup tanyakan Claude dalam bahasa yang sederhana. Misalnya:

Periksa data Anda

“Sebutkan metrik yang dapat saya kueri.”
“GMV minggu lalu per toko.”
“Mengapa penukaran poin menurun bulan ini?”

Jalankan operasi

“Berikan 200 poin kepada Alice (alice@…).”
“Daftar kumpulan kupon aktif.”
“Terbitkan kode duta untuk anggota ini.”

Tetap kendali

Penulisan dikonfirmasi sebelum dijalankan.
Pembatasan di sisi server memblokir penulisan data yang melebihi ukuran.
Lihat setiap panggilan di bawah API Kunci → Aktivitas MCP Terbaru.

Aman berdasarkan desain. Angka metrik berasal dari lapisan semantik yang diatur oleh SocialHub (AI tidak pernah menulis SQL atau mengarang angka). Operasi penulisan memerlukan cakupan penulisan dan melewati pengaman sisi server (batas nilai per panggilan + batas laju) — konfirmasi obrolan adalah bentuk kesopanan, server adalah batasnya. Setiap kunci hanya dicakup untuk tim Anda.

MCP Panduan (referensi lengkap)REST API Referensi Kelola Kunci API Kembali ke Sumber Daya