Automação do Stripe via Rube MCP

Automatize operações de pagamento do Stripe através do kit de ferramentas Stripe da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do Stripe via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas stripe
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas stripe
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a conexão do Stripe
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Gerenciar Clientes

Quando usar: O usuário deseja criar, atualizar, pesquisar ou listar clientes do Stripe

Sequência de ferramentas:

1. STRIPE_SEARCH_CUSTOMERS - Pesquisar clientes por e-mail/nome [Opcional]
2. STRIPE_LIST_CUSTOMERS - Listar todos os clientes [Opcional]
3. STRIPE_CREATE_CUSTOMER - Criar um novo cliente [Opcional]
4. STRIPE_POST_CUSTOMERS_CUSTOMER - Atualizar um cliente [Opcional]

Parâmetros principais:

• email: E-mail do cliente
• name: Nome do cliente
• description: Descrição do cliente
• metadata: Pares de metadados chave-valor
• customer: ID do cliente para atualizações (por exemplo, 'cus_xxx')

Armadilhas:

• O Stripe permite clientes duplicados com o mesmo e-mail; pesquise primeiro para evitar duplicatas
• IDs de clientes começam com 'cus_'

2. Gerenciar Cobranças e Pagamentos

Quando usar: O usuário deseja criar cobranças, intenções de pagamento ou visualizar o histórico de cobranças

Sequência de ferramentas:

1. STRIPE_LIST_CHARGES - Listar cobranças com filtros [Opcional]
2. STRIPE_CREATE_PAYMENT_INTENT - Criar uma intenção de pagamento [Opcional]
3. STRIPE_CONFIRM_PAYMENT_INTENT - Confirmar uma intenção de pagamento [Opcional]
4. STRIPE_POST_CHARGES - Criar uma cobrança direta [Opcional]
5. STRIPE_CAPTURE_CHARGE - Capturar uma cobrança autorizada [Opcional]

Parâmetros principais:

• amount: Valor na menor unidade monetária (por exemplo, centavos para USD)
• currency: Código de moeda ISO de três letras (por exemplo, 'usd')
• customer: ID do cliente
• payment_method: ID do método de pagamento
• description: Descrição da cobrança

Armadilhas:

• Valores estão na menor unidade monetária (100 = $1,00 para USD)
• Códigos de moeda devem ser minúsculos (por exemplo, 'usd' em vez de 'USD')
• Intenções de pagamento são o fluxo recomendado em vez de cobranças diretas

3. Gerenciar Assinaturas

Quando usar: O usuário deseja criar, listar, atualizar ou cancelar assinaturas

Sequência de ferramentas:

1. STRIPE_LIST_SUBSCRIPTIONS - Listar assinaturas [Opcional]
2. STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS - Criar assinatura [Opcional]
3. STRIPE_RETRIEVE_SUBSCRIPTION - Obter detalhes da assinatura [Opcional]
4. STRIPE_UPDATE_SUBSCRIPTION - Modificar assinatura [Opcional]

Parâmetros principais:

• customer: ID do cliente
• items: Matriz de itens de preço (price_id e quantidade)
• subscription: ID da assinatura para recuperação/atualização (por exemplo, 'sub_xxx')

Armadilhas:

• Assinaturas exigem um cliente válido com um método de pagamento
• IDs de preço (não IDs de produto) são usados para itens de assinatura
• O cancelamento pode ser imediato ou no final do período

4. Gerenciar Faturas

Quando usar: O usuário deseja criar, listar ou pesquisar faturas

Sequência de ferramentas:

1. STRIPE_LIST_INVOICES - Listar faturas [Opcional]
2. STRIPE_SEARCH_INVOICES - Pesquisar faturas [Opcional]
3. STRIPE_CREATE_INVOICE - Criar uma fatura [Opcional]

Parâmetros principais:

• customer: ID do cliente para a fatura
• collection_method: 'charge_automatically' ou 'send_invoice'
• days_until_due: Dias até o vencimento da fatura

Armadilhas:

• Faturas são finalizadas automaticamente por padrão; use auto_advance: false para faturas em rascunho

5. Gerenciar Produtos e Preços

Quando usar: O usuário deseja listar ou pesquisar produtos e seus preços

Sequência de ferramentas:

1. STRIPE_LIST_PRODUCTS - Listar produtos [Opcional]
2. STRIPE_SEARCH_PRODUCTS - Pesquisar produtos [Opcional]
3. STRIPE_LIST_PRICES - Listar preços [Opcional]
4. STRIPE_GET_PRICES_SEARCH - Pesquisar preços [Opcional]

Parâmetros principais:

• active: Filtrar por status ativo/inativo
• query: Consulta de pesquisa para endpoints de pesquisa

Armadilhas:

• Produtos e preços são objetos separados; um produto pode ter vários preços
• IDs de preço (por exemplo, 'price_xxx') são usados para assinaturas e checkout

6. Lidar com Reembolsos

Quando usar: O usuário deseja emitir reembolsos em cobranças

…