OnBrand by SlideSpeak

OnBrand by SlideSpeak

OnBrand by SlideSpeak es un servicio MCP y panel de control que brinda a los agentes de IA acceso a conocimiento de marca gobernado: Guías de Marca, activos del Brand Kit, tokens de color, orientación sobre logotipos y prompts de diseño de presentaciones.

El repositorio es un servicio independiente. Puede ejecutarse en cualquier entorno donde proporciones un proveedor OAuth compatible, una base de datos Postgres y un bucket S3.

Inicio Rápido

Requisitos previos:

• Bun
• Docker y Docker Compose
• Un proveedor OAuth que pueda emitir tokens de acceso JWT para el recurso MCP de OnBrand
• Un bucket AWS compatible con S3 para el almacenamiento de activos del Brand Kit

Crea la configuración local a partir del ejemplo público:

cp .env.example .env

Edita .env con tu proveedor OAuth local y las credenciales de S3. El ejemplo predeterminado asume:

• OnBrand se ejecuta en http://localhost:8080.
• Los endpoints del navegador OAuth se ejecutan en http://localhost:3000.
• Las llamadas de token y JWKS de contenedor a proveedor usan http://host.docker.internal:3000.
• Los tokens de acceso incluyen los alcances onbrand:read y onbrand:write según sea necesario.
• La audiencia/recurso del token es http://localhost:8080/mcp.

Inicia el servicio:

docker compose up --build

OnBrand expone:

http://localhost:8080/health
http://localhost:8080/mcp
http://localhost:8080/dashboard
http://localhost:8080/.well-known/oauth-protected-resource/mcp

deploy/docker-compose.yml también expone su contenedor Postgres incluido en el puerto del host 5433, por lo que los clientes de base de datos del lado del host pueden conectarse con una URL como postgresql://USER:PASSWORD@HOST:5433/onbrand?schema=public.

Conecta un cliente MCP:

Los nombres y marcas de productos de terceros en estos ejemplos identifican únicamente clientes MCP compatibles. Consulta NOTICE.md para conocer la procedencia de activos y marcas comerciales.

codex mcp add onbrand --url http://localhost:8080/mcp
codex mcp login onbrand

claude mcp add --transport http onbrand http://localhost:8080/mcp

Configuración

Consulta la guía de configuración de autenticación y ejecución para obtener la tabla completa de variables de entorno, el contrato del proveedor OAuth, las recomendaciones sobre el secreto de sesión del panel, las notas de configuración de S3 y la lista de verificación de producción.

Variables de entorno requeridas para una implementación real:

Variable	Propósito
DATABASE_URL	Cadena de conexión de Postgres.
BASE_URL	Origen público de OnBrand; deriva los metadatos sociales del panel y ${BASE_URL}/mcp.
OAUTH_ISSUER	Emisor JWT esperado.
OAUTH_AUTHORIZATION_ENDPOINT	Endpoint de autorización del navegador.
OAUTH_TOKEN_ENDPOINT	Endpoint de intercambio de tokens.
OAUTH_JWKS_URL	Endpoint JWKS utilizado para verificar las firmas de los tokens de acceso.
OAUTH_DASHBOARD_CLIENT_ID	ID de cliente OAuth estático del panel.
OAUTH_REQUIRED_READ_SCOPE	Alcance de lectura requerido por las herramientas MCP de solo lectura.
OAUTH_REQUIRED_WRITE_SCOPE	Alcance de escritura requerido por las herramientas MCP de mutación.
DASHBOARD_SESSION_SECRET	Secreto utilizado para firmar las cookies de sesión del panel.
AWS_S3_BUCKET_BRAND_KIT_ASSETS	Bucket para los activos del Brand Kit cargados.
AWS_REGION	Región de AWS para el bucket de activos del Brand Kit.
AWS_ACCESS_KEY_ID	Clave de acceso de AWS para operaciones de S3.
AWS_SECRET_ACCESS_KEY	Clave de acceso secreta de AWS para operaciones de S3.

Variables de entorno opcionales:

Variable	Propósito
OAUTH_REGISTRATION_ENDPOINT	Endpoint de registro dinámico de clientes anunciado a los clientes MCP.
OAUTH_REQUIRED_READ_SCOPE	Alcance de lectura requerido por las herramientas MCP de solo lectura. El valor predeterminado es onbrand:read.
OAUTH_REQUIRED_WRITE_SCOPE	Alcance de escritura requerido por las herramientas MCP de mutación. El valor predeterminado es onbrand:write.
OAUTH_OWNER_ID_CLAIM	Reclamo JWT utilizado como identificador del propietario de OnBrand. El valor predeterminado es sub.
ASSET_DOWNLOAD_EXPIRES_IN_SECONDS	Duración de la URL S3 prefirmada. El valor predeterminado es 900.
DASHBOARD_DEV_SERVER_URL	URL del proxy Vite del panel solo para desarrollo, utilizada por docker-compose.yml.

Herramientas Disponibles

• get_onbrand_skill - Obtén la habilidad de OnBrand sobre qué puede hacer OnBrand y cómo usar sus herramientas.
• list_brand_guides - Lista las Guías de Marca disponibles para el usuario actual.
• get_brand_guide - Obtén metadatos de la Guía de Marca, tokens del Brand Kit, identificadores de activos y orientación del Presentation Kit.
• materialize_brand_kit_assets - Obtén comandos de descarga de S3 para activos del Brand Kit, como logotipos y archivos decorativos.
• get_brand_guide_writer_skill - Obtén la habilidad para crear una nueva Guía de Marca.
• prepare_brand_guide_asset_uploads - Obtén comandos de carga de S3 para nuevos archivos de logotipos y activos decorativos.
• write_brand_guide - Crea o reemplaza una Guía de Marca utilizando referencias de activos cargados y orientación de diseño.

Desarrollo

Verificaciones útiles:

bun run format:check
bun run lint
bun run typecheck
bun run test
bun run build
bun run react-doctor:check