Sumber · SoCode

Jalankan SocialHub dari Claude Code

SoCode ialah integrasi SocialHub untuk Claude Code (dan Claude Desktop / Cursor): kemahiran yang boleh dimuat turun serta pelayan MCP yang dikawal. Kendalikan SocialHub — dan tanya tentang data anda — dalam bahasa mudah.

Mulakan Mengapa SoCode?

claude · socialhub (mcp)

› tanya dalam bahasa mudah

anda › GMV minggu lepas mengikut kedai, 3 teratas▋

↳ metrik terkawal · gmv · mengikut kedai · last_7d

Kedai 042$128,400

Kedai 017$96,250

Kedai 233$81,900

daripada lapisan semantik · tiada SQL · diaudit · ilustrasi

01 — Gambaran Keseluruhan

Apakah itu SoCode?

SoCode ialah cara SocialHub disambungkan ke pembantu AI anda. Ia merupakan dua bahagian yang berfungsi bersama — jadi Claude boleh mengendalikan SocialHub dan menjawab soalan tentang data anda, dalam bahasa yang mudah difahami, tanpa anda meninggalkan editor anda.

Kemahiran

`flash-operations`

Kemahiran Claude yang boleh dimuat turun yang mengajar Claude cara memandu SocialHub dengan selamat — alat yang hendak digunakan, mengesahkan penulisan mengikut nama/e-mel ahli dan hanya memetik nombor metrik yang dikawal.

Pelayan

Pelayan MCP yang Ditadbir

Titik akhir Protokol Konteks Model yang mendedahkan alatan SocialHub — kesetiaan, ahli, kupon, kempen dan metrik terkawal anda — disahkan oleh kunci penyewa API dan dibenarkan bagi setiap alatan.

02 — Mengapa ia penting

Mengapa SoCode?

Data dan operasi anda, boleh dicapai daripada alatan AI yang telah digunakan oleh pasukan anda — tanpa menukar tadbir urus.

Bahasa semula jadi, tiada papan pemuka

Tanya dalam Bahasa Inggeris yang mudah difahami; Claude memilih alat terkawal yang betul dan menjalankannya. Tiada klik melalui skrin, tiada SQL untuk menulis.

Dikawal & selamat oleh reka bentuk

Nombor metrik datang daripada lapisan semantik SocialHub (AI tidak pernah mencipta angka). Penulisan memerlukan skop penulisan dan melepasi pengawal bahagian pelayan. Setiap kunci diskopkan kepada pasukan anda; setiap panggilan diaudit.

Berfungsi di tempat anda sudah bekerja

Claude Code, Claude Desktop, Cursor — mana-mana klien MCP. Berhubung sekali dengan satu arahan dan kendalikan SocialHub tanpa meninggalkan pembantu anda.

Mula baca sahaja

Mulakan dengan metrics:read pratetap (paling selamat untuk AI). Tambahkan skop tulis hanya apabila anda perlu memberikan mata atau mengeluarkan kupon — anda kekal berkuasa.

Apa yang tidak mungkin sebelum ini SoCode

Setiap satu daripada ini memerlukan penganalisis, jurutera atau papan pemuka yang anda tidak miliki — jadi orang yang mempunyai soalan jarang mendapat jawapan tepat pada masanya. Ejen yang dikawal di dalam alat AI anda sendiri adalah apa yang memungkinkannya: jawapan dan tindakan gred perniagaan, layan diri, tanpa melepaskan kawalan data anda. Itulah kuncinya — bukan papan pemuka yang lebih pantas, model operasi yang berbeza.

★ Pemasar pengekalan · gelung teras

“Cari ahli yang tergelincir ke arah churn, lancarkan win-back dan terus sesuaikan dengan matlamat saya.”

SebelumTiga pasukan dan tiga alatan sepanjang minggu: seorang penganalisis menarik data, seorang pemasar membina kempen, seseorang menyemak keputusan bulan depan — pada masa itu saat itu telah berlalu dan gelung tidak pernah benar-benar ditutup.

Dengan SoCodeSatu gelung ejen menjalankan analisis → laksanakan → perbaiki: ia membaca metrik yang dikawal, melancarkan perjalanan yang anda luluskan, mengukur peningkatan dan melaraskan semula — secara berterusan, berbanding matlamat dan penghadang yang anda tetapkan.

Ketua pertumbuhan / analitik

“GMV minggu lepas mengikut kedai — dan mengapa penebusan menurun bulan ini?”

SebelumFailkan permintaan dan tunggu penganalisis, atau gabungkannya merentasi papan pemuka — jawapannya tiba selepas keputusan telah dibuat.

Dengan SoCodeJawapan yang terkawal dan boleh dipercayai dalam beberapa saat — panggilan dibuat berdasarkan data, bukan berdasarkan firasat.

Jurutera AI / ML

Dedahkan metrik terkawal SocialHub kepada pembantu anda sendiri atau aliran kerja Cursor melalui MCP.

SebelumPenyepaduan tersuai, pertanyaan tulisan tangan dan tadbir urus dilaksanakan semula dari awal — kerja selama berbulan-bulan dan tempat baharu untuk nombor melayang.

Dengan SoCodeSatu kunci berskop dan lapisan yang dikawal boleh dipanggil daripada tindanan anda. Integrasi yang dahulunya merupakan projek ialah baris konfigurasi.

Pengurus pemasaran

“Adakah ahli aktif menurun berbanding bulan lepas? Pecahkannya mengikut peringkat.”

SebelumAnda akan melihatnya dalam ulasan bulanan — selepas bulan tersebut telah hilang.

Dengan SoCodeDiagnosis berbilang langkah layan diri sebaik sahaja anda tertanya-tanya — siasat kebocoran semasa anda masih boleh bertindak ke atasnya.

03 — Sediakan dalam 3 langkah

Cara SoCode berfungsi

Tiga langkah: muat turun kemahiran, pasang pelayan MCP dan gunakan dalam bahasa semula jadi.

1. Muat turun SoCode (kemahiran)

Kemahiran SoCode (flash-operations) mengajar Claude cara memandu SocialHub dengan selamat. Ia berpasangan dengan pelayan SocialHub MCP yang akan anda tambahkan dalam langkah 2.

Dapatkan folder kemahiran

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

Atau layari / muat turunnya di GitHub → kemahiran/operasi-kilat. Salin folder ke dalam ~/.claude/skills/ (peribadi) atau .claude/skills/ projek anda.

Kemahiran ini adalah pilihan tetapi disyorkan — pelayan MCP berfungsi tanpanya; kemahiran SoCode hanya menjadikan Claude menggunakannya dengan baik.

2. Pasang pelayan MCP

a) Cipta kunci API

Dalam SocialHub, pergi ke Tetapan → API Kekunci → Cipta Kekunci dan pilih pratetap "Baca sahaja" (termasuk metrics:read — paling selamat untuk kegunaan AI; tambah skop tulis hanya apabila anda perlu memberikan mata atau mengeluarkan kupon). Kekunci ditunjukkan sekali — salinnya.

Pergi ke API Kekunci

b) Tambahkan pelayan ke Claude Code

Eksport kunci sebagai pembolehubah persekitaran terlebih dahulu, supaya kunci teks biasa tidak pernah berada dalam sejarah cangkerang anda atau fail 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 berskop projek pada akar repo anda — rujuk var persekitaran, jangan sekali-kali tampal kunci teks biasa:

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

c) Sahkan

Jalankan claude mcp list — flash sepatutnya dipaparkan sebagai berkaitan.
Minta Claude untuk "senarai alatan SocialHub yang tersedia" — anda hanya akan melihat alatan yang dibenarkan oleh skop kunci anda.
Nama pelayan mestilah tepat flash, dan FLASH_API_KEY mesti dieksport dalam shell yang melancarkan Claude Code. Kekunci yang tidak sah dipaparkan sebagai sambungan yang gagal.

3. Gunakannya

Tanya sahaja Claude dalam bahasa yang mudah difahami. Contohnya:

Pertanyakan data anda

“Senaraikan metrik yang boleh saya tanyakan.”
“GMV minggu lepas mengikut kedai.”
“Mengapa penebusan menurun bulan ini?”

Jalankan operasi

“Berikan 200 mata kepada Alice (alice@…).”
“Senaraikan kolam kupon aktif.”
“Keluarkan kod duta untuk ahli ini.”

Kekal terkawal

Penulisan disahkan sebelum dijalankan.
Huruf besar bahagian pelayan menyekat penulisan bersaiz besar.
Lihat setiap panggilan di bawah API Kekunci → Aktiviti MCP Terkini.

Selamat oleh reka bentuk. Nombor metrik datang daripada lapisan semantik yang dikawal selia SocialHub (AI tidak pernah menulis SQL atau mencipta angka). Operasi penulisan memerlukan skop penulisan dan melepasi pengawal sisi pelayan (had nilai setiap panggilan + had kadar) — pengesahan sembang adalah ihsan, pelayan adalah sempadan. Setiap kunci diskopkan kepada pasukan anda sahaja.

MCP Panduan (rujukan penuh)REST API Rujukan Urus API Kekunci Kembali ke Sumber