Stripe com IA: um agente que responde sobre pagamentos, faturas e assinaturas

Um agente de IA conectado ao Stripe responde perguntas como “quais faturas venceram esta semana?” ou “por que o cartão desse cliente foi recusado?” sem que ninguém precise abrir o dashboard e montar filtros. No CollaborAI, o Stripe está no catálogo de Servidores MCP desde a versão 1.5.

Dinheiro pede cuidado redobrado, e boa parte deste guia é sobre isso: como dar ao agente acesso para ler tudo o que interessa, sem que ele consiga mexer em um centavo.

O que o agente consegue consultar

O servidor MCP oficial do Stripe dá acesso à API da sua conta. Do lado da leitura, o agente consegue:

Buscar e ler objetos da conta: pagamentos, clientes, assinaturas, faturas, reembolsos, disputas e repasses.
Ver o resumo do saldo da conta.
Rodar consultas analíticas, quando a sua conta tem esse recurso disponível no Stripe.
Pesquisar a documentação do Stripe, útil para dúvidas de integração.

Do lado da escrita, o servidor também permite operações como criar reembolsos, cancelar assinaturas e até movimentar dinheiro. Todas essas ferramentas vêm classificadas como Escrita no catálogo e, por isso, bloqueadas até que você libere. Para os usos deste guia, nenhuma delas é necessária.

Animação: o agente consulta pagamentos e faturas no Stripe e recebe as respostas; um pedido de reembolso para na barreira, porque a escrita fica bloqueada — As consultas de leitura voltam com a resposta. Reembolso e cancelamento ficam bloqueados até você liberar.

Como conectar

Em Conectores, abra Servidores MCP e clique em Adicionar servidor MCP.
No Catálogo, escolha Stripe.
Escolha a autenticação:
- OAuth: você entra na conta Stripe numa janela do próprio Stripe e autoriza o acesso.
- Chave de API (cabeçalhos): você informa uma chave da sua conta no cabeçalho Authorization, no formato Bearer rk_....
A plataforma testa a conexão e lista as ferramentas, separadas entre Leitura e Escrita.
No agente, na seção Servidores MCP da seleção de ferramentas, marque só as de leitura.

Por que vale usar uma chave restrita

O Stripe permite criar chaves restritas (as que começam com rk_), em que você escolhe a permissão de cada recurso: leitura, escrita ou nenhuma. Uma chave restrita só com leitura é uma trava que mora no próprio Stripe. Mesmo que alguém libere a escrita no agente por engano, o Stripe recusa a operação.

Animação: um pedido de reembolso passa pela trava do agente, aberta por engano, e é recusado pela segunda trava, a chave restrita do Stripe só com leitura — Com a chave restrita só de leitura, o Stripe recusa a escrita mesmo que a trava do agente falhe.

É a mesma lógica do usuário de banco somente leitura no agente de banco de dados: a proteção mais forte é a que não depende da plataforma de IA.

A chave é guardada cifrada e não volta a ser exibida.

Seis perguntas que poupam tempo

1. O fechamento do dia

Quanto entrou ontem em pagamentos aprovados? Quantos falharam e quais foram os três motivos de recusa mais comuns?

2. A lista de cobrança

Liste as faturas em aberto com vencimento nos últimos 7 dias: cliente, e-mail, valor e quantos dias de atraso. Ordene pelo valor.

Vira o ponto de partida da régua de cobrança, sem planilha intermediária.

3. Cancelamentos do mês

Quantas assinaturas foram canceladas em outubro? Para cada uma, mostre o plano, há quanto tempo o cliente assinava e o motivo do cancelamento, se houver.

4. A reclamação do cliente

O cliente maria@exemplo.com.br diz que foi cobrado duas vezes este mês. Verifique os pagamentos dela em novembro e diga se há cobrança duplicada.

É o caso em que o time de atendimento mais ganha: a resposta sai em segundos, e quem decide o reembolso continua sendo uma pessoa.

5. Saldo e repasses

Qual o saldo disponível e o pendente na conta? Quando cai o próximo repasse e de quanto?

6. A dúvida de integração

Na API do Stripe, qual a diferença entre cancelar uma assinatura imediatamente e no fim do período? Que parâmetro eu uso?

Rotina semanal por e-mail

Com um gatilho de agendamento semanal, toda segunda às 8h, o agente monta o resumo da semana anterior:

Resuma a semana anterior no Stripe: total aprovado, número de pagamentos, taxa de falha, novas assinaturas, cancelamentos e faturas vencidas em aberto. Compare com a semana anterior a ela. Use uma tabela e no máximo cinco linhas de comentário.

Gatilho de agendamento semanal às segundas, 8h, com a instrução do resumo da semana anterior — Um gatilho semanal: toda segunda às 8h, sem ninguém pedir.

O resumo chega por e-mail e cada execução conta uma vez na cota mensal do plano.

Números de dinheiro: confie, mas confira

Modelos de linguagem são bons em buscar, agrupar e explicar, e o agente trabalha com os dados reais da conta. Mesmo assim, para valores que vão para a contabilidade ou para um relatório de diretoria, confira os totais com o relatório do próprio Stripe nas primeiras semanas.

Duas dicas que reduzem erro:

Peça períodos fechados. “De 1º a 31 de outubro” é melhor que “mês passado”.
Peça a lista junto com o total. Fica fácil conferir de onde o número saiu.

Para conciliações com milhares de transações, exporte o CSV do Stripe e use a análise de planilha com Python no Chat, que calcula em vez de estimar.

As travas de segurança

Situação	O que acontece
Servidor recém-conectado	Ferramentas de escrita bloqueadas
Liberar escrita	Exige confirmação na página do servidor e marcação ferramenta por ferramenta no agente
Agente com chat público ou WhatsApp	Ferramentas de escrita recusadas, mesmo liberadas
Servidor altera uma ferramenta	Ela precisa ser aprovada de novo no agente
Execução longa	No máximo 25 chamadas MCP por execução

Uma recomendação além das travas: não coloque o agente do Stripe em canal público, nem só com leitura. Um agente aberto ao público que lê a sua conta de pagamentos pode ser convencido a mostrar dados de outros clientes. Esse agente é ferramenta interna, para o Chat do painel e para rotinas agendadas.

Quanto custa

A CollaborAI não cobra por chamada MCP, e o Stripe não cobra pelas chamadas comuns de API. O que conta é a execução do agente: 200 por mês no Pro e 2.000 no Enterprise. Servidores MCP estão disponíveis nesses dois planos, até 3 por conta.

Perguntas frequentes

O agente consegue fazer reembolso?

Só se você liberar a escrita no servidor e marcar a ferramenta no agente, e se a credencial permitir. Com uma chave restrita só de leitura, não consegue de jeito nenhum.

Posso usar a chave secreta principal da conta?

Tecnicamente sim, mas não faça isso. A chave principal dá acesso total à conta. Use OAuth ou uma chave restrita só com leitura.

O agente funciona com contas em modo de teste?

Funciona com a conta e o modo que a credencial der acesso. Uma boa forma de começar é conectar uma chave restrita do modo de teste, validar as perguntas e só depois trocar para a de produção.

Comece pelas perguntas 2 e 4. A lista de cobrança e a checagem de cobrança duplicada são as que mais aparecem no dia a dia de quem cuida do financeiro e do atendimento.