從 Claude Code 執行 SocialHub
SoCode 是 SocialHub 的集成，適用於 Claude Code（以及 Claude Desktop / Cursor）：一個可下載的技能和一個受監管的 MCP 伺服器。使用簡明易懂的語言操作 SocialHub，並了解您的數據。
› 請使用簡單語言提問
您 › 上週各門市 GMV 前三名▋
↳ 控制指標·GMV·按商店·last_7d
來自語意層 · 無 SQL · 經過稽核 · 說明性
SoCode 是什麼？
SoCode 是 SocialHub 與您的 AI 助理連接的方式。它是兩個組件協同工作的——因此 Claude 可以運行 SocialHub 並 以通俗易懂的語言回答有關您數據的問題，而無需您離開編輯器。
flash-operations
一項可下載的Claude技能，它教會Claude如何安全地使用SocialHub－使用哪個工具，透過成員姓名/電子郵件確認寄件人，以及僅引用受監管的指標資料。
受管 MCP 伺服器
模型上下文協議端點，公開 SocialHub 的工具 - 忠誠度、會員、優惠券、活動和您的受管理指標 - 由租戶 API 金鑰進行身份驗證並按工具授權。
為什麼要使用 SoCode？
您的數據和營運數據，可透過您團隊已使用的 AI 工具存取—無需犧牲管理權限。
自然語言，無需儀錶板
用簡單的英語詢問； Claude 選擇正確的受控工具並運行它。無需點擊螢幕，無需編寫 SQL。
受設計約束且安全
指標資料來自 SocialHub 的語意層（AI 從不捏造資料）。寫入操作需要寫入權限，並透過伺服器端安全防護。每個金鑰都限定在您的團隊權限範圍內；每次呼叫都會被稽核。
在您現有的工作環境中執行
Claude Code、Claude Desktop、Cursor — 任何 MCP 客戶端。只需一條命令即可連接，無需離開您的助手即可操作 SocialHub。
開始只讀
首先使用 metrics:read 預設（對 AI 而言最安全）。僅在需要獎勵積分或發放優惠券時才添加寫入權限——一切盡在您的掌控之中。
SoCode 之前無法實現的功能
這些問題過去都需要分析師、工程師或儀表板，而您卻沒有——因此提出問題的人很少能及時得到答案。 您自己的人工智慧工具中的受控代理使這些成為可能：企業級答案和操作，自助服務，而不放棄對資料的控制。這就是解鎖——不是更快的儀表板，而是不同的操作模式。
“找到即將流失的成員，啟動挽回計劃，並不斷調整以實現我的目標。”
前三個團隊和三個工具在幾週內：分析師提取數據，行銷人員制定行銷活動，有人在下個月檢查結果 - 到那時，這一刻已經過去了，循環永遠不會真正結束。
使用 SoCode一個智慧體循環運作：分析 → 執行 → 改進：它讀取受控指標，啟動您批准的流程，衡量提升效果，並根據您設定的目標和限制條件持續進行調整。
“上週各商店的GMV——為什麼本月的兌換量下降了？”
前提交請求並等待分析師回复，或將各個儀表板上的資訊整合起來——答案會在決策做出後才到來。
使用 SoCode幾秒鐘內即可獲得受監管且值得信賴的答案——決策基於數據，而非猜測。
將 SocialHub 的受管指標暴露給您的助手或透過 MCP 的 Cursor 工作流程。
前自訂整合、手寫查詢和從零開始重新實現的治理——耗時數月，但也為資料偏差開闢了新的途徑。
使用 SoCode一個作用域金鑰，即可從您的堆疊呼叫受管層。以前作為專案的整合現在只需一行配置即可完成。
“活躍會員數是否較上月下降？按會員等級細分。”
前您會在月度回顧中註意到這一點——而此時一個月的時間已經白白浪費了。
使用 SoCode自助式多步驟診斷，讓您在疑慮出現時即可立即發現問題－趁現在還能採取行動，及時發現漏洞。
SoCode 的工作原理
三個步驟：下載技能，安裝MCP伺服器，以及用自然語言使用它。
1. 下載 SoCode（技能）
SoCode 技能 (flash-operations) 教導 Claude 如何安全地使用 SocialHub。它與您在步驟 2 中新增的 SocialHub MCP 伺服器搭配使用。
取得技能資料夾
# Pull just the SoCode skill into Claude Code
npx degit huangchunbo2025/flash/skills/flash-operations \
~/.claude/skills/flash-operations或在GitHub → skills/flash-operations 上瀏覽/下載。將資料夾複製到~/.claude/skills/（個人）或您的專案.claude/skills/中。
該技能是可選的，但建議使用 - MCP 伺服器無需它即可工作； SoCode的技巧只是讓Claude用得好。
2. 安裝MCP伺服器
a) 建立 API 鍵
在 SocialHub 中，前往 設定 → API 密鑰 → 建立密鑰 並選擇 “唯讀” 預設（包含） metrics:read — 對人工智慧使用最安全；僅在需要獎勵積分或發放優惠券時才添加寫入權限）。密鑰僅顯示一次 — 複製它。
b) 將伺服器加入Claude Code
首先將金鑰匯出為環境變量，這樣明文金鑰就不會出現在 shell 歷史記錄或設定檔中：
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}"更喜歡配置？在您的儲存庫根目錄中新增項目範圍的 .mcp.json — 引用環境變量，切勿貼上明文金鑰：
{
"mcpServers": {
"flash": {
"type": "http",
"url": "https://flash.socialhub.ai/api/mcp",
"headers": {
"Authorization": "Bearer ${FLASH_API_KEY}"
}
}
}
}c) 驗證
- 運行
claude mcp list—flash應顯示為已連線。 - 請向 Claude 傳送 「列出可用的 SocialHub 工具」 請求 — 您只會看到您的金鑰權限範圍內的工具。
- 伺服器名稱必須與
flash完全一致，且FLASH_API_KEY必須在啟動 Claude Code 的 shell 中匯出。無效密鑰會顯示連線失敗。
3. 使用它
只要用簡單的語言詢問 Claude 即可。例如：
查詢您的數據
- “列出我可以查詢的指標。”
- “上週各門市的GMV。”
- 「為什麼這個月的贖回量下降了？”
運行操作
- “獎勵 Alice (alice@…) 200 點。”
- “列出活躍的優惠券池。”
- “為該會員發放大使代碼。”
掌控一切
- 寫入操作在運行前會確認。
- 伺服器端限制阻止過大的寫入操作。
- 在 API 鍵 → 最近的 MCP 活動 下查看每次呼叫。
安全設計。 指標資料來自 SocialHub 的受控語意層（AI 從不寫 SQL 或捏造資料）。寫入操作需要寫入範圍 且 透過伺服器端保護（每次呼叫值上限 + 速率限制）－聊天確認只是禮貌性的，伺服器才是邊界。每個按鍵的作用域僅限於您的團隊。