Springbrand.ai

oficial

El mercado de capacidades para agentes de IA / Mercado de capacidades para asistentes de IA

¿Qué puedes hacer con Springbrand Ai MCP?

Instalar SpringBrand de producción — Pídele a tu asistente que siga INSTALL.md y configure la entrada MCP de producción con OAuth nativo.
Configurar el entorno de desarrollo — Haz que tu asistente instale la versión preliminar springbrand-dev usando INSTALL.dev.md con una clave de API en tiempo de ejecución.
Instalar en hosts específicos — Solicita una configuración específica del host mediante INSTALL.claude.md, INSTALL.cursor.md o INSTALL.workbuddy.md para Claude Code, Cursor o WorkBuddy.
Actualizar instalaciones existentes — Pídele a tu asistente que actualice un SpringBrand Plugin instalado en su lugar usando el flujo de actualización nativo del Marketplace.
Migrar desde versiones heredadas — Indícale a tu asistente que actualice una versión heredada del Plugin a la versión actual de entrada única con herramientas con prefijo de dominio.

Servidor MCP alojado

npx add-mcp 'https://connector.springbrand.ai/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Configuración del Agente SpringBrand

Instala SpringBrand Production a través de la guía nativa del Host correspondiente: WorkBuddy utiliza una versión publicada de R2; Codex, Claude Code y Cursor conservan GitHub main. Otros Agentes utilizan el fallback documentado de Skill más MCP.

Este árbol de código fuente incluye cinco Skills Canónicos y una entrada MCP por entorno. El paquete publicado de WorkBuddy v1.2.2 incluye los mismos cinco Skills. La entrada MCP expone cinco Meta Tools compartidas; los Domain Skills preservan los límites de negocio mediante contratos de operación descubiertos, en lugar de prefijos de nombres de herramientas registrados:

Skill	Rol	Uso de MCP
`springbrand-gtm`	Entrada de negocio GTM sustantiva; transfiere a un Domain Skill	ninguno (nunca llama a MCP)
`ask-springbrand`	Ask SpringBrand — Guía de Capacidades sin ejecución	ninguno (nunca llama a MCP)
`springbrand-platform`	Plataforma — crear/publicar artefactos, ciclo de vida de Plugins	herramientas compartidas de descubrimiento, esquema, ejecución y resultados
`springbrand-action-api`	Action API — ejecución dinámica de servicios API	herramientas compartidas de descubrimiento, esquema, ejecución y resultados
`springbrand-connector`	Conector — sistemas de terceros autorizados	herramientas compartidas más gestión de conexiones

Inicio rápido

SpringBrand tiene dos entornos. Elige el que necesites y pega el prompt correspondiente en tu Agente (Cursor, Claude Code, Codex, Copilot, Devin, Windsurf, WorkBuddy o cualquier Agente compatible).

Producción

Instala o actualiza SpringBrand Production siguiendo https://plugin.springbrand.ai/INSTALL.md. Identifica este Agente, usa la guía del Host correspondiente, detecta si SpringBrand ya está instalado, actualiza el Marketplace/Plugin existente en su lugar cuando se trate de una actualización, prefiere OAuth nativo, conserva la configuración existente y pausa solo para los pasos de UI u OAuth que deba completar.

INSTALL.md es el protocolo universal de producción. Enruta a WorkBuddy hacia la versión publicada de R2 y a otros Hosts hacia sus rutas existentes de GitHub. No uses la rama heredada stable ni adivines una versión no publicada. La entrada MCP de producción requiere OAuth nativo del Host: un consentimiento por Surface (una sola autorización cubre los tres dominios).

Desarrollo

Sigue la guía oficial de instalación de desarrollo de SpringBrand para completar la configuración: https://github.com/springbrand-lab/springbrand-agent-setup/blob/v1.2.1-dev.2/INSTALL.dev.md Identifica primero el entorno y el Host de destino. Proporciona la clave API de desarrollo solo en tiempo de ejecución mediante el flujo seguro de credenciales del Host. Configura exactamente una entrada springbrand-dev, conserva la configuración no relacionada, ejecuta la verificación autoritativa de identidad y la verificación de salud del servicio MCP configurado, e informa si se requiere un reinicio o una nueva sesión. No inicies OAuth cuando la clave API sea válida; usa las instrucciones manuales de UI y detente si el Host no puede representar credenciales Bearer de forma segura.

El Plugin de desarrollo nativo es la versión preliminar inmutable v1.2.1-dev.2. Se identifica como springbrand-dev, se muestra como SpringBrand Dev e incluye una única entrada MCP springbrand-dev en https://devconnector.springbrand.ai/mcp. El descriptor de desarrollo seleccionado posee su transporte HTTP nativo y la representación de credenciales de clave API en tiempo de ejecución.

Mantén los Plugins completos de producción y desarrollo habilitados juntos solo cuando el Host pueda distinguir sus entradas y enrutamiento. Conserva la entrada de producción y toda la configuración no relacionada durante la instalación o migración de desarrollo. El fallback manual comparte los mismos cinco Skills Canónicos y solo agrega o actualiza la entrada MCP springbrand-dev nombrada por separado.

Producción vs Desarrollo

	Producción	Desarrollo
Guía de instalación	`INSTALL.md`	`INSTALL.dev.md`
Nombre de la entrada MCP	`springbrand`	`springbrand-dev`
URL de MCP	`https://connector.springbrand.ai/mcp`	`https://devconnector.springbrand.ai/mcp`
Autenticación	OAuth nativo del Host	Clave API en tiempo de ejecución mediante el descriptor seleccionado
Propósito	Uso diario	Solo pruebas
Los Plugins completos pueden coexistir	Depende del Host; el enrutamiento debe ser inequívoco	Depende del Host; el enrutamiento debe ser inequívoco
El fallback manual Skill más MCP puede coexistir	Sí	Sí: comparte los mismos Skills y usa un nombre de entrada MCP separado

El código fuente actual y la última versión de desarrollo incluyen springbrand-gtm, ask-springbrand, springbrand-platform, springbrand-action-api y springbrand-connector; instala una versión coherente en lugar de mezclar versiones de Skills. El desarrollo es solo para pruebas y no debe usarse como configuración de producción.

Qué se instala

Plugin de Codex: empaqueta los cinco Skills Canónicos, la declaración MCP única de producción y un Hook de preflight estático para hosts de Codex en macOS compatibles.
Plugin de Claude Code: empaqueta los mismos cinco Skills, una entrada MCP de producción nativa respaldada por OAuth y un Hook de preflight estático para Claude Code CLI y la pestaña de Código de Claude Desktop; consulta INSTALL.claude.md.
Plugin de Cursor: empaqueta Mirrors de Distribución generados y verificados de los cinco Skills con una entrada MCP de producción nativa respaldada por OAuth y una Regla de preflight aplicada siempre para Cursor desktop; consulta INSTALL.cursor.md.
Plugin de WorkBuddy: un Agente de WorkBuddy lo instala mediante la CLI incluida; Add Marketplace sigue siendo el fallback manual; consulta INSTALL.workbuddy.md.
Plugin de SpringBrand Dev (versión preliminar): empaqueta cinco Skills, incluido springbrand-gtm y la entrada MCP única springbrand-dev para pruebas internas contra https://devconnector.springbrand.ai/mcp; consulta INSTALL.dev.md.
Fallback Skill más MCP: los cinco Skills a nivel de usuario y la entrada MCP remota única para hosts no compatibles.

La clave API de desarrollo se solicita solo en tiempo de ejecución y nunca se almacena en archivos del repositorio, texto de Skills, URLs, registros, errores o informes. La autenticación de producción sigue siendo propiedad del contrato de la versión de producción. Ningún Plugin contiene credenciales reutilizables ni encabezados de autorización estáticos.

Canales de distribución

Entorno	Canal de instalación
Producción — WorkBuddy	Versión publicada de R2 seleccionada en `INSTALL.workbuddy.md` (actualmente fijada)
Producción — otros Hosts	`https://github.com/springbrand-lab/springbrand-agent-setup` (`main`)
Desarrollo	`springbrand-lab/springbrand-agent-setup@v1.2.1-dev.2`

WorkBuddy instala un paquete inmutable con etiqueta de producción desde R2, no un mirror en vivo de main; la URL actual no avanza automáticamente. Otros Hosts siguen usando main. La publicación de la versión a R2 se activa actualmente de forma manual. Los Plugins de desarrollo siguen siendo etiquetas de desarrollo inmutables y nunca se fusionan en main.

Estructura del repositorio

Cada Skill Canónico declara la versión del paquete en YAML metadata.version. VERSION es la fuente de verdad: las versiones de producción no tienen el marcador -dev.N; las versiones de desarrollo lo incluyen. Mantén name en minúsculas y estable en ambos canales. Esto identifica la versión del Skill instalado, no la versión del servidor MCP.

La sincronización de producción se ejecuta automáticamente en solicitudes de extracción del mismo repositorio dirigidas a main. Después de que el autor de la versión actualice VERSION y los manifiestos del paquete, CI sella los Skills Canónicos, actualiza los Mirrors de Distribución de Cursor/WorkBuddy y confirma los cambios generados en la rama del PR. Luego envía la validación para ese nuevo commit. Fusiona el PR revisado y crea la etiqueta de producción desde el commit sincronizado; no se necesita un comando separado de sincronización de versiones. El flujo de trabajo nunca envía cambios directamente a main protegida ni reescribe etiquetas existentes.

Las versiones de desarrollo se sincronizan automáticamente en build_dev_variant.py --version .... Para vistas previas locales o contribuciones de forks (donde CI no puede escribir en la rama de origen), la misma operación está disponible:

python3 scripts/sync_skill_versions.py
python3 scripts/sync_skill_versions.py --check
python3 tests/validate_plugin.py

CI rechaza versiones o mirrors no coincidentes en main, etiquetas y envíos de validación. La sincronización automática de PR usa permisos contents: write y actions: write limitados al trabajo; los trabajos de validación permanecen de solo lectura. Los metadatos de versión no verifican por sí mismos versiones remotas ni actualizan un Skill instalado; las actualizaciones siguen usando el flujo de instalación documentado para el canal previsto.

springbrand-agent-setup/
├── README.md                          # this file — for humans
├── INSTALL.md                         # the production installation protocol — for Agents
├── INSTALL.dev.md                     # the development installation protocol — for Agents
├── VERSION                            # current release version
└── skills/
    ├── ask-springbrand/SKILL.md       # Ask SpringBrand — non-executing Capability Guide
    ├── springbrand-platform/SKILL.md  # Platform Domain Skill
    ├── springbrand-action-api/SKILL.md # Action API Domain Skill
    ├── springbrand-connector/SKILL.md # Connector Domain Skill
    └── springbrand-gtm/SKILL.md       # GTM Scenario Skill

INSTALL.md y INSTALL.dev.md son el producto principal. Están escritos para ser leídos y ejecutados por un Agente. Las fuentes de los Skills viven en skills/<machine-name>/SKILL.md y el Agente las obtiene durante la instalación; la versión seleccionada determina el conjunto completo de Skills Canónicos.

Requisitos

Tu Agente debe admitir:

Leer una URL remota y escribir archivos en tu directorio de Skills a nivel de usuario.
Servidores MCP remotos de Streamable HTTP con el contrato de credenciales de la versión seleccionada, incluido un mecanismo seguro de credenciales Bearer para desarrollo.

Si falta alguno de estos, INSTALL.md le indica al Agente que se detenga e informe la limitación. Algunos Agentes de escritorio solo pueden agregar servidores MCP a través de su UI; en ese caso, el Agente te dará los valores exactos para ingresarlos manualmente.

Seguridad

El instalador nunca almacena ni imprime claves API, tokens OAuth, encabezados de Authorization, Provider Credentials ni respuestas sin procesar de upstream.
La URL MCP de producción está fijada en https://connector.springbrand.ai/mcp; la URL MCP de desarrollo está fijada en https://devconnector.springbrand.ai/mcp.
La configuración MCP existente se conserva. El fallback manual de desarrollo fusiona solo la entrada springbrand-dev; las operaciones nativas del ciclo de vida del Plugin eliminan solo sus propios componentes incluidos.
El instalador no ejecuta ningún script externo de terceros.
No se colocan credenciales ni tokens en archivos de Skills, contenido del repositorio, URLs, registros, errores o informes finales.

Actualización

Usa el flujo nativo de actualización de Marketplace de cada host para los Plugins. Para el fallback manual, envía el mismo prompt nuevamente; INSTALL.md / INSTALL.dev.md actualiza las entradas existentes en lugar de agregar duplicados.

Migración desde una versión de Plugin heredada

Una versión de Plugin heredada (una versión de SpringBrand Plugin ya instalada que usa una única entrada MCP springbrand en https://connector.springbrand.ai/mcp con el contrato mixto heredado de Gateway (nombres de herramientas sin prefijo)) sigue funcionando hasta que la versión de producción del propietario cambie la ranura /mcp al endpoint unificado (Gateway ADR-0014; la retirada es el Issue 12 de Gateway, controlado por el propietario). Actualizar al Plugin actual de entrada única con herramientas con prefijo de dominio es voluntario: no hay una retirada automática.

Futuro: instalador determinista

Se planea un instalador programático (npx @springbrand/setup@latest) como alternativa determinista para entornos donde la instalación basada en prompts no es confiable. No es necesario para el flujo actual.