Depois que o Provedly está conectado ao Claude Code, ao Cursor ou a outra ferramenta compatível com MCP, a pergunta passa a ser o que digitar. Esta é uma lista prática, agrupada por tarefa, com a ferramenta que cada prompt acaba chamando. Você não precisa citar as ferramentas; o assistente as escolhe. Conhecê-las ajuda a entender o que ele fez.
Se ainda não conectou, comece pelo guia do Claude Code ou pelo guia do Cursor.
Conferindo como as coisas estão indo
Estes só precisam de uma chave somente leitura.
Quantos pedidos os meus widgets assistiram nos últimos 30 dias?
Chama get_stats com um período de 30 dias. Você recebe os pedidos assistidos por prova social e a receita ligada a eles, ao lado de impressões, cliques e pedidos verificados.
Qual widget teve mais cliques esta semana?
Chama list_widgets e get_stats. Se o seu assistente só receber números da conta inteira para uma pergunta, ele vai dizer isso em vez de adivinhar uma divisão, e você pode pedir que compare por site ou por widget onde os dados permitirem.
Compare os últimos 7 dias com os 7 anteriores.
Duas chamadas a get_stats com períodos diferentes, e depois uma comparação. Útil às segundas-feiras. A rotina completa está na revisão semanal de estatísticas.
Quanto falta para eu atingir o limite de impressões deste mês?
Chama get_account, que retorna o seu plano, os limites e o uso.
Uma dica para perguntas sobre estatísticas: peça os números antes da interpretação. "Me dê os números e depois diga o que mudou" mantém o assistente ancorado no que o Provedly retornou.
Gerenciando barras
Estes precisam de uma chave de leitura e escrita.
Crie uma barra de contagem regressiva para o nosso lançamento de inverno terminando em 1º de dezembro às 9h.
Chama create_bar. A barra é criada pausada, e um bom assistente vai avisar isso e mostrar a mensagem e o horário de término que usou. Leia e depois:
Está bom, pode ativar.
Isso chama set_bar_status para ativá-la, respeitando o limite de barras do seu plano. O fluxo em duas etapas é proposital: uma barra nova nunca fica na frente dos visitantes antes de você aprová-la.
Pause a barra de Black Friday.
Chama list_bars para encontrá-la pelo nome e depois set_bar_status. Se duas barras tiverem nomes parecidos, o assistente deve perguntar qual. Se não perguntar, mande-o listar as barras primeiro.
Mude a mensagem da barra de frete grátis para "Frete grátis em pedidos acima de $50 até domingo".
Chama update_bar. Nome, mensagem e data de término podem ser alterados assim.
Mude a data de término do lançamento de inverno para 2 de dezembro às 9h.
Também update_bar. O horário de término é lido no fuso horário da própria barra, a menos que você informe um timestamp completo, então "9h" significa 9h onde a barra está configurada. Mais em agendando contagens regressivas de lançamento.
Ligando e desligando widgets
Pause o widget da página de preços.
Chama list_widgets e set_widget_status.
Retome todos os widgets do site da minha loja.
Várias chamadas a set_widget_status. Se retomar ultrapassar o limite de widgets do seu plano, os excedentes são recusados, e o assistente deve informar quais continuaram pausados e por quê.
Adicionando um registro
Adicione um registro para Ana, de Lisboa, que comprou o Starter kit por €39 agora há pouco.
Chama add_record. Use isso para compras reais que não vieram por uma loja conectada, como uma fatura paga por transferência bancária. O registro mantém a origem API e aparece com o rótulo visível "Imported". Pedir ao assistente que o marque como verificado não vai funcionar; não existe ferramenta para isso, e o limite da verificação explica por que foi projetado assim.
Por favor, não use este prompt para encher um widget parado com nomes inventados. A notificação vai dizer Imported, a página de verificação pública vai listar a origem como "Site owner's backend (API)", e quem a lê são os seus clientes.
Obtendo o código de instalação
Me dê o snippet de instalação da minha loja.
Chama get_install_snippet. Cole o resultado no layout compartilhado do seu site, ou peça a um assistente de programação que faça isso, como em instalando com um agente de IA.
Prompts que serão recusados
Saber o que falha economiza tempo:
| Prompt | Por que falha |
|---|---|
| "Marque estes registros como verificados" | Nenhuma ferramenta ou chave verifica um registro |
| "Retome os 10 widgets" num plano menor | Limite do plano, igual ao painel |
| Qualquer mudança com uma chave somente leitura | A chave não consegue escrever |
| "Mostre 40 pessoas vendo" | A contagem de visitantes é só presença real |
Perguntas frequentes
Preciso usar exatamente essas palavras?
Não. O assistente entende a intenção, então "desliga o banner da BF" funciona tão bem quanto "pause a barra de Black Friday", desde que o nome seja parecido o suficiente para ser encontrado.
E se o assistente escolher a barra ou o widget errado?
Peça para desfazer, que é a chamada de status oposta, e da próxima vez peça que ele liste os itens primeiro e confirme antes de agir. Manter a aprovação de ferramentas ativada no seu cliente ajuda aqui.
Posso encadear vários pedidos num único prompt?
Sim. "Pause a barra da promoção e me diga quantos pedidos ela assistiu" funciona. Cadeias mais longas são mais fáceis de conferir quando você pede, no final, um resumo de todas as mudanças.
Todos os prompts daqui funcionam no plano Free, dentro dos limites dele: compare os planos ou cadastre-se.