Como controlar suas vendas Stripe falando com o Claude (1 comando, oficial)

Você tem um curso, um SaaS, um infoproduto. As vendas entram no Stripe e você vive abrindo o dashboard pra ver quanto entrou, criar cupom pra ação de promoção, estornar pedido de cliente chato, conferir status de assinatura.

São 30 cliques pra cada coisa. Multiplica por dia e você gasta 1 hora/dia no dashboard.

Agora tem como falar em pt-BR: "lista as vendas de ontem", "cria um cupom MAESTRIA20 com 20% válido até sexta", "estorna a venda do João Silva" — e o Claude executa direto no Stripe. Oficial, gratuito, lançado pela própria Stripe.

Vamos.

O que é MCP (em 1 parágrafo)

MCP é um padrão aberto que o Anthropic criou pra conectar IA a sistemas externos. Pensa numa ponte oficial entre o Claude e o Stripe — ou Notion, ou Supabase, ou qualquer outro. Você instala a ponte uma vez. Daí em diante, o Claude entende as ferramentas daquele sistema como se fossem dele.

A Stripe lançou o MCP oficial em https://mcp.stripe.com. Quem mantém é a própria Stripe — não é projeto da comunidade. Por isso vale o post.

O que o Claude consegue fazer no Stripe

Eu mapeei tudo que o MCP atual libera (versão de maio/2026):

Tudo isso por conversa. Sem clicar.

Pré-requisitos

Você precisa de três coisas:

• Conta Stripe ativa. Se ainda não tem, cria em stripe.com — leva 5 minutos.
• Claude Code instalado. Tutorial de instalação aqui se ainda não fez.
• 5 minutos de paciência. É rápido.

Passo 1 — Gerar API key restrita no Stripe

Esse é o passo mais importante de segurança. Você não vai dar pro Claude a chave secreta cheia da conta. Vai criar uma chave restrita que faz só o que você autorizar.

Como gerar:

1. Entra no dashboard da Stripe
2. No canto superior direito, confirma que está no modo Test (sandbox) se for sua primeira vez
3. Menu lateral: Developers → API keys
4. Botão: Create restricted key
5. Dá um nome pra chave (ex: Claude Code — Test)
6. Escolhe as permissões que o Claude vai poder usar:

7. Clica em Create key
8. Copia a chave (começa com rk_test_... ou rk_live_...). Guarda — ela só aparece 1 vez.

Passo 2 — Adicionar o MCP ao Claude Code

Abre o terminal numa pasta qualquer e roda:

claude mcp add --transport http stripe https://mcp.stripe.com

Aperta Enter. Em 2 segundos ele confirma:

✓ MCP server "stripe" added (http://mcp.stripe.com)

Pra confirmar que apareceu na lista:

claude /mcp

Vai listar os MCPs conectados. O stripe tem que estar lá.

Passo 3 — Autenticar (OAuth ou chave restrita)

Quando você fizer a primeira pergunta ao Claude sobre Stripe, ele vai precisar autenticar. Tem dois caminhos:

Caminho A — OAuth (recomendado pra uso pessoal)

1. O Claude abre uma aba no navegador
2. Você confirma "Sim, autorizo o Claude a usar essa conta Stripe"
3. Volta pro terminal — tá autenticado

Vantagem do OAuth: você não cola chave nenhuma. Pra revogar acesso depois, vai em Dashboard → User Settings → OAuth sessions e clica em Revoke.

Caminho B — API key restrita (pra agente autônomo / CI)

Se for usar em script automatizado ou agente sem janela do navegador, configura a key restrita como variável de ambiente:

# Windows (PowerShell)
$env:STRIPE_API_KEY="rk_test_xxx..."
 
# Mac/Linux
export STRIPE_API_KEY="rk_test_xxx..."

Daí em diante o Claude usa essa chave automaticamente.

Passo 4 — Testar com prompt simples

No Claude Code (terminal ou interface), digita:

qual meu saldo atual na Stripe?

Resposta esperada (modo test):

Seu saldo na Stripe (modo Test) está em:
- Disponível: R$ 0,00 BRL
- Pendente: R$ 0,00 BRL

Como esta é a conta de Test (sandbox), nenhum dinheiro real
está envolvido. Pra ver vendas reais, troque pra modo Live.

Se respondeu com número, funcionou. Hora de usar pra valer.

7 prompts práticos pro dia a dia

Esses são os comandos que eu mais uso. Cola direto no Claude.

Prompt 1 — Criar produto + preço de uma vez

Cria um produto "Curso Iniciante em IA" com preço de
R$ 197,00 (cobrança única, em BRL). Depois me devolve
o ID do produto e o ID do preço.

Em 5 segundos: produto criado, preço linkado, IDs no terminal. Você acabou de pular 4 telas do dashboard.

Prompt 2 — Listar vendas dos últimos 7 dias

Lista todas as vendas (PaymentIntents) dos últimos 7 dias.
Pra cada uma, mostra: data, cliente (email), valor em R$,
status. Ordena da mais recente pra mais antiga.

Saída em formato tabela, direto no terminal. Sem precisar abrir o dashboard.

Prompt 3 — Criar cupom de promoção

Cria um cupom "MAESTRIA20" com 20% de desconto,
válido até 31 de maio de 2026, máximo 100 usos.

Cupom no ar. Manda pro público.

Prompt 4 — Estornar venda

A venda com ID pi_3PXxxxxxxx precisa ser estornada
total. Faz o refund e me confirma o status.

Refund processado. Cliente feliz.

Prompt 5 — Gerar Payment Link pra mandar no WhatsApp

Gera um Payment Link pro produto "Mentoria 1h" no
preço de R$ 350. Quero mandar pelo WhatsApp.

Recebe link tipo https://buy.stripe.com/test_xxxxx. Cola no WhatsApp. Cliente paga.

Prompt 6 — Listar assinaturas com pagamento falho

Lista todas as assinaturas com status "past_due" ou
"unpaid". Mostra email do cliente, nome do plano,
valor da assinatura, quantos dias em atraso.

Lista de gente pra entrar em contato e regularizar.

Prompt 7 — Buscar resposta na doc da Stripe

Pesquisa na doc da Stripe: como funciona a tributação
automática (Stripe Tax) pra venda B2B no Brasil?

Resposta direto da doc oficial, sem você abrir 5 abas.

Modo Test vs Modo Live (segurança absoluta)

A Stripe tem dois mundos paralelos na mesma conta:

Boa prática:

1. Cria 2 chaves restritas: uma do Test, uma do Live
2. Começa SEMPRE no Test (tipo rk_test_...)
3. Roda 10-20 prompts até ter confiança no que tá fazendo
4. Só aí muda pra Live (rk_live_...)

{
  "mcp": {
    "stripe": {
      "requireConfirmation": ["create_refund", "cancel_subscription", "update_dispute"]
    }
  }
}

Cuidados de segurança

Antes de soltar isso pro time todo:

• Restricted key, sempre. Nunca a secret. Se você não sabe a diferença, releia o Passo 1.
• Test antes de Live. Sempre.
• Confirmação humana em operações financeiras. Refund, cancelar assinatura, atualizar disputa.
• Não cola a chave no chat público nem em screenshot. Se vazar, vai no dashboard e revoga (Settings → Restricted keys → Revoke).
• OAuth sessions — revisa periodicamente em User Settings → OAuth sessions. Se viu sessão estranha, revoga.
• Cuidado com prompt injection se estiver combinando MCPs. Se você conecta Stripe + um MCP que lê email, alguém pode mandar email com texto malicioso tentando enganar o Claude. Confirmação humana resolve.

Se algo deu errado — troubleshooting

Erro 1: claude: command not found

O Claude Code não tá instalado ou não tá no PATH. Tutorial de instalação aqui.

Erro 2: Authentication failed ao usar o MCP

A chave restrita expirou, foi revogada, ou tá em modo errado (Test x Live).

Solução:

1. Vai no dashboard → API keys
2. Confirma que a chave ainda existe e tá ativa
3. Confirma que o modo (Test/Live) bate com o que você quer fazer
4. Se necessário, gera nova chave restrita e atualiza a env var

Erro 3: Permission denied ao executar ação

Você marcou pouca coisa na restricted key. Ex: tentou fazer refund mas só liberou Read em Refunds.

Solução: vai no dashboard, edita a restricted key (ou cria nova) e marca Write no recurso que precisava.

Erro 4: O Claude inventa ID de produto

Se você pediu "cria um cupom pro produto X" e o produto X não existe, o Claude pode tentar adivinhar. Sempre liste antes:

Primeiro lista os produtos ativos. Depois cria
um cupom de 15% só pro produto "Curso de IA".

Assim ele puxa o ID real, não inventa.

Limitações honestas

• Não funciona com Stripe Connect avançado (multi-conta de marketplace) — algumas ferramentas faltam.
• Operações em massa são lentas. Pra processar 500 refunds, melhor um script direto na API.
• Boletos brasileiros ainda têm cobertura parcial. Pra fluxo de cobrança recorrente em boleto, confere antes.
• Disputas com upload de evidência funcionam, mas você ainda precisa subir os arquivos pelo dashboard.

Pra 90% do uso de infoprodutor / SaaS / freela — sobra.

TL;DR

• MCP é a ponte oficial entre Claude e sistemas externos.
• MCP Stripe é mantido pela Stripe. Grátis. Lançamento de 2026.
• 1 comando pra conectar: claude mcp add --transport http stripe https://mcp.stripe.com
• Sempre chave restrita, nunca secret key.
• Comece em modo Test, depois passe pra Live.
• Ative confirmação humana em refund, cancelar, disputar.
• 7 prompts práticos acima cobrem 90% do uso real.

Próximos passos

Combine com outras coisas do site pra fechar o funil de venda completo:

• Como publicar landing no Netlify — onde a venda começa
• Página de vendas com GitHub + Vercel — alternativa permanente
• 3 prompts pra controlar Meta Ads — pra trazer tráfego pra venda
• Auditoria de Meta Ads em 30 min — pra otimizar campanha que traz cliente

Cadastra teu email lá em cima pra receber o próximo MCP que vou cobrir: Notion (Claude lendo e escrevendo no seu Notion direto). Sai amanhã.

Resumão final: quem aprende esse fluxo gerencia Stripe em minutos por dia, não horas. Faz a próxima venda, faz o próximo refund, cria a próxima promoção — tudo conversando. E libera tempo pra fazer o que IA não faz: pensar em produto, gravar conteúdo, falar com cliente.

Vai testar agora — modo Test, sem risco.