Claude Code から SocialHub を実行する
SoCode は、Claude Code (および Claude Desktop / Cursor) の SocialHub 統合です。ダウンロード可能なスキルと管理された MCP サーバーです。 SocialHub を操作し、データについて尋ねます。わかりやすい言葉で説明します。
› わかりやすい言葉で尋ねる
あなた › 店舗別先週の流通総額、トップ 3▋
↳ 管理指標 · gmv · 店舗別 · last_7d
セマンティック層から · SQL なし · 監査済み · 例示的
SoCodeとは何ですか?
SoCode は、SocialHub を AI アシスタントに接続する方法です。これは 2 つの部分が連携して動作するため、Claude は SocialHub を操作し、 エディターを離れることなく、データに関する質問に平易な言葉で答えることができます。
flash-operations
ダウンロード可能な Claude スキルは、SocialHub を安全に運用する方法 (どのツールを使用するか、メンバー名/電子メールによる書き込みの確認、管理対象の指標数値のみの引用など) を Claude に教えます。
管理された MCP サーバー
SocialHub のツール (ロイヤルティ、メンバー、クーポン、キャンペーン、管理対象の指標) を公開するモデル コンテキスト プロトコル エンドポイント。テナント API キーによって認証され、ツールごとに承認されます。
なぜSoCode?
ガバナンスを犠牲にすることなく、チームがすでに使用している AI ツールからデータとオペレーションにアクセスできます。
自然言語、ダッシュボードなし
わかりやすい英語で質問してください。 Claude は、適切に管理されたツールを選択して実行します。画面をクリックして移動したり、SQL を作成したりする必要はありません。
設計による管理と安全性
指標の数値は、SocialHub のセマンティック レイヤーから取得されます (AI が数値を発明することはありません)。書き込みには書き込みスコープが必要で、サーバー側のガードを通過します。すべてのキーのスコープはチームに限定されます。すべての呼び出しが監査されます。
すでに働いている場所で働ける
Claude Code、Claude Desktop、Cursor — 任意の MCP クライアント。単一のコマンドで一度接続すると、アシスタントを離れることなく SocialHub を操作できます。
読み取り専用で開始する
metrics:read プリセットから始めます (AI にとって最も安全)。書き込みスコープを追加するのは、ポイントを付与したりクーポンを発行したりする必要がある場合のみであり、常に制御できます。
SoCode 以前は不可能だったこと
これらのそれぞれには、アナリスト、エンジニア、またはあなたが持っていないダッシュボードが必要でした。そのため、質問をした人が時間内に答えを得ることがほとんどありませんでした。 独自の AI ツール内の管理されたエージェントにより、データの制御を放棄することなく、セルフサービスでビジネスグレードの回答とアクションを実現できます。それは、より高速なダッシュボードや異なるオペレーティング モデルではなく、ロックを解除することです。
「メンバーが離脱に向かって落ち込んでいるのを見つけて、巻き返しを図り、私の目標に合わせて調整し続けます。」
前に3 つのチームと 3 つのツールを数週間にわたって使用します。アナリストがデータを取得し、マーケティング担当者がキャンペーンを構築し、来月誰かが結果を確認します。その時点でその瞬間は過ぎており、実際にはループが閉じることはありません。
SoCode を使用すると1 つのエージェント ループが分析→実行→改善を実行します。管理された指標を読み取り、承認したジャーニーを開始し、上昇率を測定し、設定した目標とガードレールに対して継続的に再調整します。
「先週の店舗別の流通総額 — 今月の引き換え額が減少しているのはなぜですか?」
前にリクエストをファイルしてアナリストを待つか、ダッシュボード全体でリクエストをつなぎ合わせます。答えは決定が下された後に届きます。
SoCode を使用すると管理された信頼できる回答が数秒で得られます。電話は直感ではなくデータに基づいて行われます。
SocialHub の管理された指標を、MCP を介して独自のアシスタントまたは Cursor ワークフローに公開します。
前にカスタム統合、手書きのクエリ、ガバナンスをゼロから再実装しました。数か月の作業と、数値の新たな漂流場所が生まれました。
SoCode を使用すると1 つのスコープ付きキーと管理レイヤーはスタックから呼び出すことができます。プロジェクトだった統合は構成行です。
「アクティブ メンバーは先月と比較して減少しましたか? 層ごとに分析してください。」
前にあなたは月次レビューでそれに気づくでしょう - その月がすでに失われていた後です。
SoCode を使用すると疑問に思った瞬間にセルフサービスのマルチステップ診断を実行し、対処できるうちに漏れを発見します。
SoCode の仕組み
3 つのステップ: スキルをダウンロードし、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 → skill/flash-operations で参照/ダウンロードします。フォルダーを ~/.claude/skills/ (個人) またはプロジェクトの .claude/skills/ にコピーします。
このスキルはオプションですが推奨されます。MCP サーバーはスキルがなくても動作します。 SoCode のスキルは、Claude がそれをうまく活用できるようにするだけです。
2. MCP サーバーをインストールします
a) API キーを作成します
SocialHub で、[設定] → [API キー] → [キーの作成] に移動し、「読み取り専用」 プリセットを選択します (metrics:read が含まれています - AI の使用に最も安全です。ポイントを付与したりクーポンを発行する必要がある場合にのみ書き込みスコープを追加します)。キーが一度表示されるので、それをコピーします。
b) サーバーを Claude Code に追加します。
まずキーを環境変数としてエクスポートします。これにより、プレーンテキストのキーがシェルの履歴や設定ファイルに記録されることがなくなります。
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 を起動するシェルでエクスポートされる必要があります。無効なキーは失敗した接続として表示されます。
3. 使ってみよう
Claude にわかりやすい言葉で尋ねてください。例えば：
データをクエリする
- 「クエリできる指標をリストしてください。」
- 「店舗ごとの先週の流通総額」
- 「今月の償還額が減少したのはなぜですか?」
操作の実行
- 「アリス（alice@…）に200ポイントをあげます。」
- 「アクティブなクーポンプールをリストします。」
- 「このメンバーにアンバサダーコードを発行してください。」
コントロールを維持する
- 書き込みは実行前に確認されます。
- サーバー側の制限により、サイズ超過の書き込みがブロックされます。
- API キー → 最近の MCP アクティビティですべての通話を表示します。
安全な設計。 指標の数値は、SocialHub の管理されたセマンティック レイヤーから取得されます (AI が SQL を書いたり、数値を作成したりすることはありません)。書き込み操作には書き込みスコープ が必要で、 サーバー側のガード (呼び出しごとの値の上限 + レート制限) を渡す必要があります。チャットの確認は礼儀であり、サーバーが境界です。すべてのキーのスコープはあなたのチームのみに限定されます。