SocialHub.AI
Ressourcen · SoCode

Führen Sie SocialHub von Claude Code aus

SoCode ist die SocialHub-Integration für Claude Code (und Claude Desktop / Cursor): ein herunterladbarer Skill plus einen verwalteten MCP-Server. Betreiben Sie SocialHub – und fragen Sie nach Ihren Daten – im Klartext.

claude · socialhub (mcp)

› Fragen Sie in Klartext.

Sie › Bruttowarenvolumen letzte Woche nach Geschäft, Top 3▋

↳ geregelte Metrik · gmv · nach Geschäft · last_7d

Filiale 042$128,400
Filiale 017$96,250
Filiale 233$81,900

aus der semantischen Ebene · kein SQL · geprüft · anschaulich

01 — Übersicht

Was ist SoCode?

SoCode ist die Art und Weise, wie SocialHub in Ihren KI-Assistenten eingebunden wird. Es sind zwei Teile, die zusammenarbeiten – so kann Claude SocialHub bedienen und Fragen zu Ihren Daten im Klartext beantworten, ohne dass Sie Ihren Editor verlassen müssen.

Die Kompetenz

flash-operations

Eine herunterladbare Claude Fähigkeit, die Claude beibringt, wie man SocialHub sicher bedient – ​​welches Tool verwendet werden soll, wie Beiträge anhand des Mitgliedsnamens/der E-Mail-Adresse bestätigt werden und wie nur die zulässigen Kennzahlen angegeben werden.

Der Server

Verwalteter MCP-Server

Ein Model Context Protocol-Endpunkt, der die Tools von SocialHub – Treue, Mitglieder, Gutscheine, Kampagnen und Ihre verwalteten Metriken – offenlegt, authentifiziert durch einen Mandanten-API-Schlüssel und autorisiert pro Tool.

02 – Warum es wichtig ist

Warum SoCode?

Ihre Daten und Abläufe, zugänglich über die KI-Tools, die Ihr Team bereits nutzt – ohne Kompromisse bei der Datenverwaltung.

Natürliche Sprache, keine Dashboards

Fragen Sie in einfachem Englisch; Claude wählt das richtige verwaltete Tool aus und führt es aus. Kein Klicken durch Bildschirme, kein SQL-Schreiben.

Vom Design her geregelt und sicher

Die Kennzahlen stammen aus der semantischen Schicht von SocialHub (die KI generiert keine Zahlen). Schreibvorgänge erfordern einen Schreibbereich und werden serverseitig geprüft. Jeder Schlüssel ist Ihrem Team zugeordnet; jeder Aufruf wird protokolliert.

Funktioniert dort, wo Sie bereits arbeiten.

Claude Code, Claude Desktop, Cursor – jeder MCP-Client. Stellen Sie einmal mit einem einzigen Befehl eine Verbindung her und bedienen Sie SocialHub, ohne Ihren Assistenten zu verlassen.

Schreibgeschützt starten

Beginnen Sie mit der Voreinstellung „metrics:read“ (am sichersten für KI). Fügen Sie Schreibberechtigungen nur hinzu, wenn Sie Punkte vergeben oder Gutscheine ausstellen müssen – Sie behalten die Kontrolle.

Was vor SoCode nicht möglich war

Für jede dieser Fragen brauchte man früher einen Analysten, einen Techniker oder ein Dashboard, das man nicht hatte – daher erhielt die Person mit der Frage selten rechtzeitig die Antwort. Ein gesteuerter Agent in Ihrem eigenen KI-Tool macht sie möglich: Antworten und Aktionen auf Unternehmensniveau, Self-Service, ohne die Kontrolle über Ihre Daten aufzugeben. Das ist der Schlüssel – kein schnelleres Dashboard, ein anderes Betriebsmodell.

★ Retention-Marketing · Der Kernkreislauf

„Identifizieren Sie die Mitglieder, die abwandern könnten, starten Sie eine Rückgewinnungskampagne und optimieren Sie diese kontinuierlich, um mein Ziel zu erreichen.“

VorDrei Teams und drei Tools über Wochen hinweg: Ein Analyst ruft die Daten ab, ein Vermarkter erstellt die Kampagne, jemand überprüft die Ergebnisse im nächsten Monat – bis dahin ist der Moment vorbei und der Kreis schließt sich nie wirklich.

Mit SoCodeEin automatisierter Prozess läuft von der Analyse über die Ausführung bis zur Verbesserung: Er liest die festgelegten Kennzahlen, startet die von Ihnen genehmigte Kampagne, misst die Verbesserung und optimiert kontinuierlich – anhand der von Ihnen definierten Ziele und Rahmenbedingungen.

Leitung Wachstum/Analytics

„Das Bruttowarenvolumen der letzten Woche nach Filialen – und warum sind die Einlösungen in diesem Monat rückläufig?“

VorStellen Sie eine Anfrage und warten Sie auf einen Analysten oder verknüpfen Sie die Daten über verschiedene Dashboards hinweg – die Antwort kommt erst, nachdem die Entscheidung bereits gefallen ist.

Mit SoCodeEine kontrollierte, vertrauenswürdige Antwort in Sekundenschnelle – die Entscheidung basiert auf Daten, nicht auf einer Vermutung.

KI-/ML-Ingenieur

Stellen Sie die von SocialHub verwalteten Metriken Ihrem eigenen Assistenten oder einem Cursor-Workflow über MCP zur Verfügung.

VorEine benutzerdefinierte Integration, manuell erstellte Abfragen und eine komplett neu implementierte Governance – monatelange Arbeit und ein neuer Bereich, in dem Zahlen abweichen können.

Mit SoCodeEin Bereichsschlüssel und die zugehörige Steuerungsschicht sind von Ihrem Stack aus aufrufbar. Die Integration, die früher ein Projekt war, ist nun eine Konfigurationszeile.

Marketingmanager

„Ist die Anzahl der aktiven Mitglieder im Vergleich zum Vormonat gesunken? Analysieren Sie die Daten nach Kategorien.“

VorSie würden es im Monatsbericht bemerken – nachdem der Monat bereits vorbei ist.

Mit SoCodeSelbstbedienungsdiagnose in mehreren Schritten – erkennen Sie das Datenleck, solange Sie noch handeln können.

03 — Einrichtung in 3 Schritten

Wie funktioniert SoCode?

Drei Schritte: die Fähigkeit herunterladen, den MCP-Server installieren und sie in natürlicher Sprache verwenden.

1. Laden Sie SoCode (die Funktion) herunter.

Der SoCode-Skill (flash-operations) lehrt Claude, wie man SocialHub sicher fährt. Es wird mit dem SocialHub MCP-Server gekoppelt, den Sie in Schritt 2 hinzufügen.

Holen Sie sich den Skill-Ordner

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

Oder durchsuchen/laden Sie es auf GitHub → skills/flash-operations herunter. Kopieren Sie den Ordner nach ~/.claude/skills/ (persönlich) oder in das .claude/skills/ Ihres Projekts.

Der Skill ist optional, wird aber empfohlen – der MCP-Server funktioniert ohne ihn; Die Fähigkeiten von SoCode sorgen dafür, dass Claude es gut nutzen kann.

2. Installieren Sie den Server MCP.

a) Schlüssel API erstellen

Gehen Sie in SocialHub zu Einstellungen → APISchlüssel → Schlüssel und wählen Sie die Voreinstellung "Schreibgeschützt" (beinhaltet metrics:read – am sichersten für die KI-Nutzung; Schreibberechtigungen nur hinzufügen, wenn Sie Punkte vergeben oder Gutscheine ausstellen müssen). Der Schlüssel wird nur einmal angezeigt – kopieren Sie ihn.

Gehen Sie zu API-Schlüsseln

b) Fügen Sie den Server zu Claude Code hinzu

Exportieren Sie den Schlüssel zunächst als Umgebungsvariable, damit der Klartextschlüssel nie in Ihrem Shell-Verlauf oder einer Konfigurationsdatei landet:

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

Konfiguration bevorzugen? Fügen Sie ein projektbezogenes .mcp.json in Ihrem Repo-Stammverzeichnis hinzu – verweisen Sie auf die Umgebungsvariable, fügen Sie niemals einen Klartextschlüssel ein:

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

c) Verifizieren

  • Führen Sie claude mcp list aus – flash sollte als verbunden angezeigt werden.
  • Fragen Sie Claude, "verfügbare SocialHub-Tools aufzulisten" – Sie sehen nur die Tools, die durch die Berechtigungen Ihres Schlüssels erlaubt sind.
  • Der Servername muss exakt flash lauten, und FLASH_API_KEY muss in der Shell exportiert werden, die Claude Code startet. Ein ungültiger Schlüssel führt zu einer fehlgeschlagenen Verbindung.

3. Anwendung

Fragen Sie Claude einfach in Klartext. Zum Beispiel:

Daten abfragen

  • „Listen Sie die Metriken auf, die ich abfragen kann.“
  • „GMV letzte Woche nach Filiale.“
  • „Warum sind die Rücknahmen diesen Monat zurückgegangen?“

Führen Sie Operationen aus

  • „Vergeben Sie 200 Punkte an Alice (alice@…).“
  • „Aktive Coupon-Pools auflisten.“
  • „Für dieses Mitglied einen Botschaftercode ausgeben.“

Behalten Sie die Kontrolle

  • Schreibvorgänge werden vor der Ausführung bestätigt.
  • Serverseitige Begrenzungen verhindern zu große Schreibvorgänge.
  • Alle Anrufe unter API Schlüssel → Letzte MCP Aktivitäten anzeigen.

Sicherheit durch Design. Metrikwerte stammen aus der kontrollierten semantischen Schicht von SocialHub (die KI schreibt niemals SQL-Abfragen oder erfindet Zahlen). Schreibvorgänge erfordern einen Schreibbereich und und durchlaufen eine serverseitige Sicherheitsprüfung (Wertobergrenze pro Aufruf + Ratenbegrenzung). Die Chat-Bestätigung ist optional, der Server bildet die Grenze. Jeder Schlüssel ist nur für Ihr Team gültig.