Servidor MCP — Uappi My Account
https://sua-loja-uappi.com.br/api/v3/customer/mcp
Endpoint JSON-RPC do servidor MCP da conta do cliente. Exige sessão de cliente autenticado.
Descrição
Servidor MCP voltado para a própria conta do cliente final autenticado na loja (área "Minha Conta"). Requer uma sessão de cliente válida.
- Nome MCP:
Uappi My Account - Versão:
0.1.0 - Ferramentas expostas: ~55
- Instruções do servidor: "MCP server for the authenticated customer's own account. Requires a valid customer session; tools operate only on the caller's own data."
Autenticação e Permissões
Exige um token de cliente válido (Authorization: Bearer {customerToken}). Diferente do servidor de staff, não existe hoje um sistema de escopos granular para esta identidade — todas as ferramentas ficam disponíveis para qualquer cliente autenticado, mas cada uma delas opera exclusivamente sobre os dados do próprio cliente que fez a chamada (nunca de outro cliente da loja).
Domínios cobertos
| Domínio | Exemplos de operações |
|---|---|
| Profile | Consultar/editar perfil, senha, flags, campos adicionais, exclusão de conta |
| Address | Listar, criar, editar, remover e definir endereço principal |
| Card | Listar, criar e remover cartões salvos |
| Document | Enviar/remover documentos de identificação |
| Orders | Listar pedidos, histórico, grupos de pedido, observações |
| Review | Avaliações de produtos e da loja |
| Wishlist | Listas de desejos e produtos favoritados |
| GiftCard | Gift cards vinculados à conta |
| Wallet | Extrato de transações da carteira |
| Newsletter | Cancelamento de inscrição |
| History | Histórico de atividades da conta |
| Cart | Vincular endereço, aplicar/remover carteira e pontos no carrinho |
| Mfa | Configuração de autenticação em duas etapas (MFA) |
Exemplo de Requisição
1curl --request POST \2 --url https://sua-loja-uappi.com.br/api/v3/customer/mcp \3 --header "Authorization: Bearer SEU_TOKEN_DE_CLIENTE" \4 --header "Content-Type: application/json" \5 --data '{6 "jsonrpc": "2.0",7 "id": 1,8 "method": "tools/call",9 "params": {10 "name": "get_customer_profile",11 "arguments": {}12 }13 }'✅ Resposta de Sucesso
1{2 "jsonrpc": "2.0",3 "id": 1,4 "result": {5 "content": [{ "type": "text", "text": "{...perfil do cliente em JSON...}" }],6 "structuredContent": { "id": 987, "name": "..." },7 "isError": false8 }9}⚠️ Erros de ferramenta
Assim como no servidor de staff, erros de validação/negócio voltam como HTTP 200 com isError: true. Apenas falhas de autenticação retornam HTTP 401 real, no nível da rota.