A maioria das mudanças numa configuração de prova social é pequena. Pausar a barra de Black Friday agora que a promoção acabou. Adiar uma contagem regressiva de lançamento em um dia. Conferir se as notificações da semana passada ajudaram alguém a comprar. Cada uma significava abrir o painel, encontrar o site certo, encontrar a barra certa e passar por um formulário. A partir de hoje, você pode pedir isso numa frase, na ferramenta de IA que já está aberta.
O Provedly agora traz três coisas que funcionam juntas: chaves de API da conta, uma API REST para a sua conta inteira e um servidor MCP com o qual o Claude Code, o Cursor e outras ferramentas compatíveis com MCP conseguem conversar. As três estão disponíveis em todos os planos, inclusive o Free.
O que você pode fazer por um chat
Depois que o servidor MCP está conectado, o seu assistente enxerga a sua conta como o painel enxerga e age sobre ela dentro dos limites da sua chave. Na prática, isso significa prompts como estes:
- "Pause a barra de Black Friday."
- "Crie uma barra de contagem regressiva para o nosso lançamento de inverno terminando em 1º de dezembro às 9h."
- "Quantos pedidos os meus widgets assistiram nos últimos 30 dias?"
- "Qual widget teve mais cliques esta semana?"
- "Me dê o snippet de instalação da minha loja."
Por trás de cada um, o assistente chama uma ferramenta do Provedly: list_bars e set_bar_status no primeiro, create_bar no segundo, get_stats nos dois seguintes, get_install_snippet no último. Você vê a chamada da ferramenta e vê o resultado.
Um detalhe importa no segundo prompt. Uma barra criada por chat começa pausada, para que você a revise antes de qualquer visitante vê-la. Ir ao ar é uma etapa separada: diga "está bom, pode ativar" e o assistente chama set_bar_status para ativá-la, o que, como no painel, respeita o limite de barras do seu plano. Pausar e retomar barras e widgets existentes tem efeito imediato.
A lista completa de ferramentas é get_account, list_sites, list_widgets, list_bars, get_stats, set_widget_status, set_bar_status, create_bar, update_bar, add_record e get_install_snippet. Se quiser exemplos de cada uma, o livro de receitas de prompts passa por todas.
Chaves de API da conta
Tudo começa com uma chave. Em Settings, em API keys, você cria uma e escolhe um nível de acesso: Read only ou Read and write. As chaves começam com provedly_, são mostradas uma única vez na criação e podem ser revogadas a qualquer momento na mesma tela.
Uma chave somente leitura consegue ver a sua conta, sites, widgets, barras e estatísticas. Não consegue mudar nada. Uma chave de leitura e escrita também consegue pausar e retomar widgets, criar e editar barras e adicionar registros. Se você só quer que um assistente responda perguntas sobre desempenho, dê a ele uma chave somente leitura e pronto. Os prós e contras estão em chaves somente leitura vs. de escrita.
A API REST
A mesma chave funciona numa API HTTP simples em https://provedly.app/api/v1, enviada como Authorization: Bearer provedly_…. Ela cobre a sua conta (plano, limites e uso), sites, widgets, barras e estatísticas, além de criar e editar barras e pausar ou retomar widgets. A Records API existente, para adicionar compras, agora também aceita uma chave de conta, então um backend não precisa mais de uma chave separada por widget.
Se preferir automatizar as coisas você mesmo em vez de passar por um assistente, o tour com curl mostra cada endpoint com uma requisição real.
Conectando o Claude Code
O servidor MCP fica em https://provedly.app/mcp e usa streamable HTTP. No Claude Code, é um comando:
claude mcp add --transport http provedly https://provedly.app/mcp \
--header "Authorization: Bearer provedly_YOUR_KEY"
O Cursor e outros clientes MCP recebem a mesma URL e o mesmo cabeçalho nas configurações de servidor. Guias passo a passo: configuração do Claude Code e Cursor e outros clientes.
As mesmas regras do painel
Um assistente conectado ao Provedly não consegue fazer nada que você não pudesse fazer no painel, e em alguns pontos consegue fazer menos.
Os limites do plano valem. Se o seu plano permite dois widgets ativos e você pede para retomar um terceiro, o pedido é recusado com o mesmo motivo que o painel daria. Chaves somente leitura são somente leitura, sem exceções.
O mais importante: o assistente nunca consegue marcar um registro como verificado. Um registro recebe a marca Verified só quando chega por um webhook assinado do Stripe, Shopify ou WooCommerce e a assinatura confere. Registros adicionados pela API, seja pelo seu backend, seja por um assistente chamando add_record, aparecem com o rótulo visível "Imported" e sem a marca Verified, e a sua página de verificação pública os lista em "Site owner's backend (API)". Esse limite é o motivo de o Provedly existir, e conectar uma IA a ele não o move. O raciocínio está em por que o seu assistente não consegue verificar uma compra.
Um snippet por site, em implantação
Há mais uma peça que estamos liberando junto com isso: um único snippet de site, /w/site.js, que carrega todos os widgets e barras ativos de um site. Com ele instalado, ligar ou desligar uma barra pelo Claude tem efeito na página sem nenhuma mudança de código da sua parte. Ele está em fase piloto, e os detalhes estão em o snippet de site de uma linha.
Perguntas frequentes
Preciso de um plano pago para usar a API ou o servidor MCP?
Não. Chaves de API da conta, a API REST e o servidor MCP estão disponíveis em todos os planos, inclusive o Free. Os limites habituais do seu plano para widgets, barras e impressões continuam valendo.
Quais ferramentas de IA funcionam com isso?
Claude Code, Cursor e outras ferramentas compatíveis com MCP que consigam se conectar a um servidor MCP HTTP com um cabeçalho Authorization personalizado. Se a sua ferramenta não fala MCP, a API REST cobre o mesmo terreno.
O assistente pode mudar coisas que eu não pedi?
Ele só pode chamar as ferramentas que você vê, com o nível de acesso da chave que você deu. Use uma chave somente leitura se quiser perguntas respondidas e nada alterado, e revogue a chave em Settings se parar de usá-la.
Para experimentar, crie uma conta gratuita, gere uma chave em Settings e conecte-a ao assistente que você já usa.