Servidor MCP — Uappi Storefront
POST
https://sua-loja-uappi.com.br/api/v3/publics/mcp
Endpoint JSON-RPC do servidor MCP público (dados de vitrine/storefront). Acesso anônimo.
Descrição
Servidor MCP voltado para dados públicos da vitrine da loja — o mesmo tipo de dado disponível para qualquer visitante do site, sem necessidade de login.
- Nome MCP:
Uappi Storefront - Versão:
0.1.0 - Ferramentas expostas: ~44
- Instruções do servidor: "MCP server for public storefront data. No authentication required."
> ⚠️ O path é publics/mcp, no plural — não confundir com public/mcp (singular).
Autenticação
Este servidor não exige login. Um token ausente ou expirado é tolerado normalmente. Porém, um token malformado/inválido explicitamente enviado ainda assim é rejeitado — "público" não significa "qualquer token é aceito", apenas que nenhum token é obrigatório.
Domínios cobertos
| Domínio | Exemplos de operações |
|---|---|
| Product | Detalhe, listagem, busca, variações, comentários, categorias, marcas, upsells, previsão promocional |
| Review | Avaliações públicas de produto e da loja |
| Cart | Recuperação de carrinho por código, upsells do carrinho |
| Order | Consulta pública do pedido por trás de um código de link de pagamento |
| Contact | Envio de mensagem para central de contato |
| Template | Banners, menus e showcases por código |
| Url | Verificação e resolução de URLs amigáveis |
| Payment | Bandeiras de cartão, condições de pagamento, token de pagamento do formulário/iframe |
| Shipping | Cotação de frete, consulta de CEP |
| Common | Países, idiomas, moedas |
| Customer | Login (e-mail/documento), MFA, cadastro, recuperação de senha, newsletter |
Exemplo de Requisição
1curl --request POST \2 --url https://sua-loja-uappi.com.br/api/v3/publics/mcp \3 --header "Content-Type: application/json" \4 --data '{5 "jsonrpc": "2.0",6 "id": 1,7 "method": "tools/call",8 "params": {9 "name": "search_products",10 "arguments": { "term": "tenis" }11 }12 }'✅ Resposta de Sucesso
1{2 "jsonrpc": "2.0",3 "id": 1,4 "result": {5 "content": [{ "type": "text", "text": "{...resultado da busca em JSON...}" }],6 "structuredContent": { "registers": [] },7 "isError": false8 }9}⚠️ Erros de ferramenta
Erros de validação/negócio voltam como HTTP 200 com isError: true. Um token explicitamente malformado é rejeitado com HTTP 401 real, no nível da rota.