通过 Claude Code 操作 SocialHub
SoCode 是 Claude Code（和 Claude Desktop / Cursor）的 SocialHub 集成：可下载的技能加上受管理的 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——最适合 AI 使用；仅在需要奖励积分或发放优惠券时才添加写入权限）。密钥仅显示一次——复制它。
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。”
- “为什么这个月的赎回量下降了？”
运行操作
- “奖励 200 积分给 Alice (alice@…)。”
- “列出活跃的优惠券池。”
- “为该会员颁发大使代码。”
掌控一切
- 写入操作在运行前会进行确认。
- 服务器端限制阻止过大的写入操作。
- 在 API 键 → 最近的 MCP 活动 下查看每次调用。
安全设计。指标数据来自 SocialHub 的受控语义层（AI 从不编写 SQL 或捏造数据）。写入操作需要写入权限 ，并且通过服务器端保护（每次调用值上限 + 速率限制）——聊天确认仅为礼貌性操作，服务器才是真正的边界。每个密钥的权限范围仅限您的团队。