---
name: servinder-lojista
description: Ajuda lojistas a organizar uma loja Servinder, administrar projetos de portfólio e relacionar projetos pessoais publicados quando a conta tem acesso à organização e à loja. Use para configuração ou gestão de lojas; não use para operações administrativas globais ou escolhas de clientes.
metadata:
  author: Servinder
  version: "0.1.0"
---

# Servinder para lojistas

Esta skill não cria permissões por si só. Confira o
[catálogo](https://ola.servinder.com.br/catalogo/) e o
[guia de conexão](https://ola.servinder.com.br/lojista/) antes de começar.
O endpoint MCP é `https://escolhas.servinder.com.br/mcp`.
Para operar, requer um cliente MCP remoto com OAuth/PKCE e escopo
`servinder:store`. Cada ação também valida o papel da conta na organização e
na loja.

## Conectar e preparar uma loja

No cliente MCP compatível, adicione o endpoint e conclua o OAuth iniciado pelo
aplicativo. Selecione **Lojas e projetos autorizados** (`servinder:store`) e
entre com a conta Servinder que participa da organização. Nunca peça senha,
token ou código OAuth em conversa.

1. Use `organization.list` para localizar organizações em que a conta participa.
2. Se a pessoa pedir uma organização nova, use `organization.create`; isso cria
   a organização e torna a conta autenticada sua administradora. Não convide
   outros membros sem pedido explícito.
3. Use `store.list` para mostrar somente as lojas às quais a conta tem acesso.
4. Para criar loja, confirme o nome e a organização administrada. Use
   `store.create` com o `organizationId` confirmado. O servidor define a conta
   autenticada como proprietária; não aceite um ID de proprietário enviado pelo
   agente como prova de autorização.
5. Explique que a loja nasce em rascunho. Antes de publicar, mostre o nome,
   produtos e configurações e peça confirmação explícita.

## Administrar projetos e loja

- `store.projects.list` mostra projetos vinculados e projetos publicados que a
  conta pode relacionar à loja. Um projeto pessoal pode ser vinculado quando a
  própria conta tem acesso à loja e é proprietária do projeto.
- `store.personal_project.create` cria um projeto pessoal em rascunho.
  `store.projects.create` cria um projeto pertencente à loja em rascunho.
- Projetos pessoais só podem ser relacionados depois de publicados e com ao
  menos uma arte pronta. A relação não transfere sua propriedade.
- `store.projects.add`, `.update` e `.remove` alteram somente vínculos de
  portfólio; remover vínculo não apaga o projeto.
- `store.update` altera a configuração da loja. Resuma mudanças persistentes e
  confirme antes de gravar.
- `store.publish` publica ou arquiva a loja. Confirme o estado pretendido antes
  de executar; publicar torna a página pública.
- O MCP verifica novamente a participação na organização e o papel na loja em
  cada operação. Se o acesso for negado, pare e peça ao administrador da
  organização que revise os vínculos; não tente outro escopo ou conta.

## Limites atuais

- `servinder:store` não dá acesso a projetos não publicados de terceiros,
  clientes, pedidos, pagamentos ou ferramentas administrativas da plataforma.
- Membros sem papel de administração podem não criar ou publicar lojas. A
  organização e o papel por loja são verificados separadamente.
- Criar organização ou loja não adiciona membros automaticamente.
- Não anuncie geração, integração social, checkout ou outras capacidades sem
  confirmar que as ferramentas correspondentes estão habilitadas para aquela
  loja.

Se a pessoa pedir criação de projetos de escolha ou conteúdo global, explique
que isso requer outra permissão e indique a skill correspondente somente quando
for relevante.

## Sugerir melhorias

Se uma etapa ficar confusa ou faltar uma operação, resuma o problema e uma
possível melhoria sem incluir credenciais, links privados ou dados de clientes.
Sugestões podem orientar uma revisão futura; não altere nem publique a skill ou
as permissões por conta própria.
