OnBrand by SlideSpeak

OnBrand by SlideSpeak

O OnBrand by SlideSpeak é um serviço MCP e dashboard que dá a agentes de IA acesso a conhecimento de marca governado: Brand Guides, assets do Brand Kit, tokens de cor, orientações de logotipo e prompts de design de apresentação.

O repositório é um serviço independente. Ele pode ser executado em qualquer ambiente em que você forneça um provedor OAuth compatível, um banco de dados Postgres e um bucket S3.

Início Rápido

Pré-requisitos:

• Bun
• Docker e Docker Compose
• Um provedor OAuth que possa emitir tokens de acesso JWT para o recurso MCP do OnBrand
• Um bucket AWS compatível com S3 para armazenamento de assets do Brand Kit

Crie a configuração local a partir do exemplo público:

cp .env.example .env

Edite o .env com seu provedor OAuth local e suas credenciais S3. O exemplo padrão assume:

• O OnBrand roda em http://localhost:8080.
• Os endpoints de navegador OAuth rodam em http://localhost:3000.
• As chamadas de token e JWKS entre contêiner e provedor usam http://host.docker.internal:3000.
• Os tokens de acesso incluem os escopos onbrand:read e onbrand:write conforme necessário.
• O audience/recurso do token é http://localhost:8080/mcp.

Inicie o serviço:

docker compose up --build

O OnBrand expõe:

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

O deploy/docker-compose.yml também expõe seu contêiner Postgres integrado na porta do host 5433, para que clientes de banco de dados no host possam se conectar com uma URL como postgresql://USER:PASSWORD@HOST:5433/onbrand?schema=public.

Conecte um cliente MCP:

Nomes de produtos e marcas de terceiros nesses exemplos identificam apenas clientes MCP compatíveis. Consulte NOTICE.md para a procedência de assets e marcas registradas.

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

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

Configuração

Consulte o guia de configuração de autenticação e runtime para a tabela completa de variáveis de ambiente, contrato do provedor OAuth, orientações sobre o segredo de sessão do dashboard, notas de configuração do S3 e checklist de produção.

Variáveis de ambiente obrigatórias para uma implantação real:

Variable	Purpose
DATABASE_URL	String de conexão do Postgres.
BASE_URL	Origem pública do OnBrand; deriva metadados sociais do dashboard e ${BASE_URL}/mcp.
OAUTH_ISSUER	Emissor JWT esperado.
OAUTH_AUTHORIZATION_ENDPOINT	Endpoint de autorização do navegador.
OAUTH_TOKEN_ENDPOINT	Endpoint de troca de tokens.
OAUTH_JWKS_URL	Endpoint JWKS usado para verificar assinaturas de tokens de acesso.
OAUTH_DASHBOARD_CLIENT_ID	ID de cliente OAuth estático do dashboard.
OAUTH_REQUIRED_READ_SCOPE	Escopo de leitura exigido pelas ferramentas MCP somente leitura.
OAUTH_REQUIRED_WRITE_SCOPE	Escopo de escrita exigido pelas ferramentas MCP de mutação.
DASHBOARD_SESSION_SECRET	Segredo usado para assinar cookies de sessão do dashboard.
AWS_S3_BUCKET_BRAND_KIT_ASSETS	Bucket para assets do Brand Kit enviados.
AWS_REGION	Região AWS do bucket de assets do Brand Kit.
AWS_ACCESS_KEY_ID	Chave de acesso AWS para operações S3.
AWS_SECRET_ACCESS_KEY	Chave de acesso secreta AWS para operações S3.

Variáveis de ambiente opcionais:

Variable	Purpose
OAUTH_REGISTRATION_ENDPOINT	Endpoint de registro dinâmico de clientes divulgado aos clientes MCP.
OAUTH_REQUIRED_READ_SCOPE	Escopo de leitura exigido pelas ferramentas MCP somente leitura. O padrão é onbrand:read.
OAUTH_REQUIRED_WRITE_SCOPE	Escopo de escrita exigido pelas ferramentas MCP de mutação. O padrão é onbrand:write.
OAUTH_OWNER_ID_CLAIM	Claim JWT usado como identificador do proprietário do OnBrand. O padrão é sub.
ASSET_DOWNLOAD_EXPIRES_IN_SECONDS	Tempo de vida da URL S3 pré-assinada. O padrão é 900.
DASHBOARD_DEV_SERVER_URL	URL de proxy Vite do dashboard apenas para desenvolvimento, usada por docker-compose.yml.

Ferramentas Disponíveis

• get_onbrand_skill - Obtenha a skill do OnBrand sobre o que o OnBrand pode fazer e como usar suas ferramentas.
• list_brand_guides - Liste os Brand Guides disponíveis para o usuário atual.
• get_brand_guide - Obtenha metadados do Brand Guide, tokens do Brand Kit, identificadores de assets e orientações do Presentation Kit.
• materialize_brand_kit_assets - Obtenha comandos de download do S3 para assets do Brand Kit, como logotipos e arquivos decorativos.
• get_brand_guide_writer_skill - Obtenha a skill para criar um novo Brand Guide.
• prepare_brand_guide_asset_uploads - Obtenha comandos de upload do S3 para novos arquivos de logotipo e assets decorativos.
• write_brand_guide - Crie ou substitua um Brand Guide usando referências de assets enviados e orientações de design.

Desenvolvimento

Verificações úteis:

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