Vaanzari Commerce
MCP oficial para descoberta de sarees banarasi e fluxos de compra autorizados da Vaanzari.
Documentação
Vaanzari Commerce MCP + WebMCP
Guia público de conexão para o MCP Vaanzari Commerce e a implementação de referência WebMCP nativa do navegador para compras assistidas por agente de sarees.
Aplicativo ao vivo
MCP remoto
Conecte um cliente MCP compatível a https://vaanzari.com/mcp usando Streamable HTTP. Os metadados do repositório e exemplos permanecem disponíveis para esse protocolo:
- cartão do servidor
- exemplo de cliente genérico
- configuração do Cursor
- guia de conexão
- guia de ferramentas MCP remoto
MCP remoto e WebMCP no navegador são complementares: clientes remotos se conectam ao serviço Vaanzari, enquanto o WebMCP expõe ferramentas nativas da página em navegadores compatíveis.
Comece com o início rápido MCP/WebMCP para escolher a superfície de integração que se adequa ao seu cliente.
WebMCP no navegador
A Vaanzari registra seis ferramentas nativas do navegador por meio de document.modelContext.registerTool(...):
search-sareesget-sareecompare-sareesopen-sareeadd-saree-to-cartopen-cart
Um agente pode pesquisar, comparar, navegar e adicionar um produto público disponível ao estado visível do carrinho. O humano mantém o julgamento final, informações pessoais, checkout, pagamento e confirmação do pedido.
Início rápido
npm install
npm run dev
Abra http://localhost:5173. Esta demonstração de referência independente usa um pequeno snapshot de dados de fixture público e seguro dos campos do catálogo visíveis ao comprador. Nenhuma API privada, credencial, conta, pagamento ou dependência de implantação é necessária.
npm run typecheck
npm run lint
npm test
npm run build
npm run check:webmcp
npm run secret-scan
Verificação no navegador
Abra /webmcp-diagnostics em um navegador compatível com WebMCP. Ele informa contexto seguro, document.modelContext, registerTool(), getTools() opcional, nomes esperados, nomes ausentes e PRONTO/NÃO PRONTO sem ler o armazenamento do navegador ou o estado do cliente.
Para testes ao vivo, use o ChatGPT Desktop Site Tools ou Chrome 149+ com WebMCP habilitado. Pergunte: "Encontre sarees Banarasi abaixo de ₹20.000", compare as correspondências, abra uma, adicione ao carrinho e depois abra o carrinho. Veja verificação no navegador. O fallback do Safari pode mostrar o comportamento normal da loja, mas não é evidência de registro WebMCP.
Arquitetura
src/webmcp/register.ts é a peça central das ferramentas do navegador. Depende apenas de um PublicCatalogClient, adaptador de navegação do navegador e adaptador de carrinho do navegador. src/demo/ fornece dados de fixture e estado React para reprodução local. Veja arquitetura e referência de ferramentas.
Limite público/privado
A plataforma de comércio Vaanzari de produção permanece em repositório privado separado. Este repositório contém código-fonte WebMCP nativo do navegador executável de forma independente, adaptador de fixture público e seguro, UI de demonstração, diagnósticos, testes e documentação.
Não contém credenciais de produção, implementação de pagamento, código de backend privado, tratamento de dados de clientes, interfaces administrativas, infraestrutura, configuração de implantação ou código de banco de dados. Limites de segurança declaram limitações deliberadas.
Arquivo Devpost
Material de proveniência e submissão do período do desafio permanece disponível para contexto histórico, não como propósito principal do repositório: trabalho do desafio, proveniência e checklist de submissão.
Licença e marcas registradas
O software é Apache-2.0. Os direitos de marca e fotos de produtos são separados; veja TRADEMARKS.md.