Este guia leva você de nenhuma chave a uma conexão do Provedly funcionando no Claude Code. Ele pressupõe que você já tem uma conta do Provedly com pelo menos um site e o Claude Code instalado num terminal. Tudo se resume a uma chave, um comando e um prompt de teste.
Se ainda não leu a visão geral, o artigo de lançamento explica o que o servidor MCP pode e não pode fazer.
Passo 1: crie uma chave de API da conta
No painel do Provedly, abra Settings e depois API keys. Escolha Create key, dê a ela um nome que você vá reconhecer depois, como "Claude Code no meu notebook", e escolha um nível de acesso.
- Read only deixa o Claude ver a sua conta, sites, widgets, barras e estatísticas.
- Read and write também deixa pausar e retomar widgets, criar e editar barras e adicionar registros.
Se é a primeira vez que você testa isso, comece com Read only. Você sempre pode criar uma segunda chave depois. A chave começa com provedly_ e é mostrada uma única vez, então copie-a antes de fechar a janela. Se perdê-la, revogue e crie outra; não há como exibi-la de novo.
Passo 2: adicione o servidor
Num terminal, rode:
claude mcp add --transport http provedly https://provedly.app/mcp \
--header "Authorization: Bearer provedly_YOUR_KEY"
Substitua provedly_YOUR_KEY pela chave que você acabou de copiar. As partes do comando:
| Parte | O que faz |
|---|---|
--transport http |
O servidor do Provedly usa streamable HTTP |
provedly |
O nome que o Claude Code vai mostrar para o servidor |
https://provedly.app/mcp |
O endereço do servidor |
--header "..." |
Envia a sua chave em cada requisição |
O Claude Code guarda isso na configuração de MCP dele. Trate essa configuração como trataria um arquivo .env: agora ela guarda um segredo. Se você adicionar o servidor no escopo do projeto e commitar a configuração, a chave vai junto, então, num repositório compartilhado, mantenha-a no escopo do usuário ou deixe a chave fora do controle de versão.
Passo 3: confira a conexão
Abra o Claude Code e rode /mcp. Você deve ver provedly na lista com status conectado e as ferramentas do Provedly logo abaixo: get_account, list_sites, list_widgets, list_bars, get_stats, get_install_snippet e, com uma chave de escrita, set_widget_status, set_bar_status, create_bar, update_bar e add_record.
Se o servidor mostrar um erro, as causas habituais são um erro de digitação na chave, a falta do prefixo Bearer no cabeçalho ou uma chave revogada. Chaves revogadas falham na hora, que é o que você quer.
Passo 4: um primeiro prompt
Pergunte algo que só precise de acesso de leitura e cuja resposta você possa conferir no painel:
Em que plano eu estou e quanto das impressões deste mês já usei?
O Claude deve chamar get_account e responder com o seu plano, os limites e o uso atual. Abra o painel e compare. Se os números baterem, a conexão funciona.
Um segundo bom teste são as estatísticas:
Quantos pedidos os meus widgets assistiram nos últimos 30 dias?
Isso chama get_stats e informa os pedidos e a receita assistidos por prova social no período. A definição de pedido assistido é a mesma do painel, explicada em medindo pedidos assistidos por prova social.
Passo 5: teste uma mudança, com cuidado
Com uma chave de leitura e escrita, tente algo fácil de desfazer:
Pause a barra chamada "Free shipping" e me diga o que mudou.
Normalmente o Claude lista as suas barras, encontra a correspondente, chama set_bar_status e informa o novo estado. O Claude Code pede que você aprove as chamadas de ferramentas, a menos que você as tenha liberado, e vale manter essa aprovação ativada para tudo que escreve. Leia a chamada de ferramenta antes de aprovar: ela cita a barra e a ação.
Retome do mesmo jeito. Se você pedir para retomar algo que ultrapassaria o limite do seu plano, o pedido é recusado e o Claude diz o motivo, a mesma recusa que o painel dá.
Mantendo tudo organizado
Alguns hábitos que ajudam quando isso vira parte da sua rotina:
- Uma chave por máquina ou por ferramenta, com nome claro, para que revogar uma não quebre as outras.
- Chaves somente leitura em qualquer lugar onde você só queira relatórios. Mais sobre isso em chaves somente leitura vs. de escrita.
- Revogue as chaves que você não usa mais. A tela de API keys lista todas.
Se você pedir ao Claude que crie uma barra, espere que ela volte pausada. Barras novas feitas pela API ou pelo MCP sempre começam assim, para que você confira o texto e as datas antes; mandar o Claude ativá-la é o segundo passo.
Quando quiser ir além, o livro de receitas de prompts tem exemplos para cada ferramenta.
Perguntas frequentes
Posso usar a mesma chave no Claude Code e num script?
Sim, uma chave funciona tanto no servidor MCP quanto na API REST. Chaves separadas continuam sendo mais fáceis de gerenciar, porque você pode revogar uma sem mexer na outra.
O que acontece se eu remover o servidor do Claude Code?
O Claude Code para de chamar o Provedly, e nada muda na sua conta. A chave continua válida até você revogá-la em Settings, então revogue-a se não for mais usar.
O Claude vê os dados pessoais dos meus clientes?
Ele vê o que as ferramentas retornam: dados da conta, sites, widgets, barras e estatísticas e, ao adicionar um registro, o registro que você pede para adicionar. Trate a sessão como qualquer outro lugar por onde passam dados do negócio.
Contas e chaves são gratuitas para começar: cadastre-se aqui.