Ejecute SocialHub desde Claude Code
SoCode es la integración de SocialHub para Claude Code (y Claude Desktop / Cursor): una habilidad descargable más un servidor MCP gobernado. Opere SocialHub y pregunte sobre sus datos en un lenguaje sencillo.
› Pregunta en lenguaje sencillo
you › GMV la semana pasada por tienda, top 3▋
↳ métrica gobernada · gmv · por tienda · last_7d
desde la capa semántica · no SQL · auditado · ilustrativo
¿Qué es SoCode?
SoCode así es como SocialHub se conecta con su asistente de IA. Son dos piezas que trabajan juntas, por lo que Claude puede operar SocialHub y responder preguntas sobre sus datos, en un lenguaje sencillo, sin que usted abandone su editor.
flash-operations
Una habilidad descargable Claude que enseña Claude cómo manejar SocialHub de forma segura: qué herramienta usar, confirmar las escrituras por nombre/correo electrónico del miembro y citar solo números de métricas reguladas.
Servidor MCP gobernado
Un punto final del protocolo de contexto modelo que expone las herramientas de SocialHub (fidelidad, miembros, cupones, campañas y sus métricas gobernadas) autenticadas por una clave de inquilino API y autorizadas por herramienta.
¿Por qué SoCode?
Sus datos y operaciones, accesibles desde las herramientas de IA que su equipo ya utiliza, sin sacrificar la gobernanza.
Lenguaje natural, sin paneles de control
Pregunte en inglés sencillo; Claude elige la herramienta gobernada adecuada y la ejecuta. Sin hacer clic en las pantallas, sin SQL para escribir.
Gobernado y seguro por diseño
Las métricas provienen de la capa semántica de SocialHub (la IA nunca inventa cifras). Las escrituras requieren un ámbito de escritura y pasan una verificación del servidor. Cada clave está asignada a tu equipo; cada llamada se audita.
Funciona donde ya trabajas
Claude Code, Claude Desktop, Cursor: cualquier cliente MCP. Conéctese una vez con un solo comando y opere SocialHub sin salir de su asistente.
Iniciar solo lectura
Comience con el metrics:read Preconfigurado (más seguro para la IA). Añada permisos de escritura solo cuando necesite otorgar puntos o emitir cupones; usted mantiene el control.
Lo que antes no era posible con SoCode
Cada uno de estos solía necesitar un analista, un ingeniero o un panel de control que no se tiene, por lo que la persona con la pregunta rara vez obtenía la respuesta a tiempo. Un agente gobernado dentro de su propia herramienta de IA es lo que los hace posibles: respuestas y acciones de nivel empresarial, autoservicio, sin ceder el control de sus datos. Ése es el desbloqueo: no un tablero más rápido, ni un modelo operativo diferente.
«Identificar a los miembros que se están alejando, iniciar una estrategia de recuperación y seguir ajustándola a mi objetivo».
AntesTres equipos y tres herramientas a lo largo de semanas: un analista extrae los datos, un especialista en marketing crea la campaña, alguien verifica los resultados el próximo mes; para entonces, el momento ha pasado y el ciclo nunca se cierra.
Con SoCodeUn ciclo automatizado ejecuta el análisis → ejecución → mejora: lee las métricas definidas, inicia el proceso que apruebas, mide el impacto y se ajusta continuamente, en función de los objetivos y parámetros que estableces.
“Volumen bruto de mercancía (GMV) la semana pasada por tienda: ¿y por qué han disminuido los canjes este mes?”
AntesEnvía una solicitud y espera a un analista, o intégrala en varios paneles: la respuesta llega después de que la decisión ya se haya tomado.
Con SoCodeUna respuesta fiable y controlada en segundos: la decisión se basa en datos, no en intuiciones.
Exponga las métricas gobernadas por SocialHub a su propio asistente o a un flujo de trabajo Cursor a través de MCP.
AntesUna integración personalizada, consultas escritas a mano y una gobernanza reimplementada desde cero: meses de trabajo y un nuevo lugar donde las cifras pueden variar.
Con SoCodeUna clave con ámbito definido y la capa gobernada se puede invocar desde tu pila tecnológica. La integración, que antes era un proyecto, ahora es una línea de configuración.
¿Disminuyó el número de miembros activos con respecto al mes pasado? Analícelo por nivel.
AntesLo notarías en el informe mensual, cuando ya se había perdido el mes.
Con SoCodeDiagnóstico en varios pasos de autoservicio en el momento en que lo sospeche: detecte la fuga mientras aún puede actuar.
Cómo funciona SoCode
Tres pasos: descargar la habilidad, instalar el servidor MCP y usar en lenguaje natural.
1. Descarga SoCode (la habilidad)
La habilidad SoCode (flash-operations) enseña Claude cómo manejar SocialHub de forma segura. Se empareja con el servidor SocialHub MCP que agregarás en el paso 2.
Obtener la carpeta de habilidades
# Pull just the SoCode skill into Claude Code
npx degit huangchunbo2025/flash/skills/flash-operations \
~/.claude/skills/flash-operationsO búscalo/descárgalo en GitHub → skills/flash-operations. Copia la carpeta en ~/.claude/skills/ (personal) o en .claude/skills/ de tu proyecto.
La habilidad es opcional pero recomendada: el servidor MCP funciona sin ella; La habilidad de SoCode simplemente hace que Claude la use bien.
2. Instale el servidor MCP
a) Crear una clave API
En SocialHub, ve a Configuración → APIClaves → Crear clave y selecciona el preajuste "Solo lectura" (incluye metrics:read, el más seguro para uso con IA; añade permisos de escritura solo cuando necesites otorgar puntos o emitir cupones). La clave se muestra una sola vez; cópiala.
b) Agregue el servidor a Claude Code
Primero exporte la clave como una variable de entorno, para que la clave en texto sin formato nunca llegue a su historial de shell o a un archivo de configuración:
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}"¿Prefieres la configuración? Agregue un .mcp.json con alcance de proyecto en la raíz de su repositorio: haga referencia a la var env, nunca pegue una clave de texto sin formato:
{
"mcpServers": {
"flash": {
"type": "http",
"url": "https://flash.socialhub.ai/api/mcp",
"headers": {
"Authorization": "Bearer ${FLASH_API_KEY}"
}
}
}
}c) Verificar
- Ejecute
claude mcp list:flashdebería mostrarse como conectado. - Pídele a Claude que "muestre las herramientas disponibles de SocialHub" — solo verás las herramientas que permitan los permisos de tu clave.
- El nombre del servidor debe ser exactamente
flash, yFLASH_API_KEYdebe exportarse en la consola que inicia Claude Code. Una clave no válida se mostrará como una conexión fallida.
3. Usarla
Simplemente pregúntale a Claude en lenguaje sencillo. Por ejemplo:
Consulta tus datos
- “Enumera las métricas que puedo consultar.”
- “Volumen bruto de mercancías (GMV) de la semana pasada por tienda.”
- “¿Por qué cayeron los canjes este mes?”
Ejecutar operaciones
- “Otorgue 200 puntos a Alice (alice@…)”.
- "Listar grupos de cupones activos".
- "Emita un código de embajador para este miembro".
Mantén el control
- Las escrituras se confirman antes de su ejecución.
- Las limitaciones del servidor bloquean las escrituras de gran tamaño.
- Consulta todas las llamadas en API Claves → Actividad reciente MCP.
Seguro por diseño. Los números de métricas provienen de la capa semántica controlada de SocialHub (la IA nunca escribe SQL ni inventa cifras). Las operaciones de escritura requieren un ámbito de escritura y superan una protección del servidor (límite de valor por llamada + límite de velocidad). La confirmación por chat es una cortesía; el servidor es el límite. Cada clave está restringida a tu equipo.