Stripe MCP — Casos de uso, Instalar & Demo en vivo

Name: Stripe MCP Server
Author: stripe

Por qué usarlo

Características clave

Lee y escribe en los recursos principales de Stripe
Alterna entre modo de prueba y modo en vivo mediante la clave de API
Búsqueda potente (consultas de estilo stripe.search)
Selección de herramientas mediante el argumento CLI --tools= — restringe a solo lectura por seguridad
Mantenido directamente por Stripe

Demo en vivo

Cómo se ve en la práctica

stripe.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "stripe",
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "stripe": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@stripe/mcp",
          "--tools=all"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add stripe -- npx -y @stripe/mcp --tools=all

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Stripe

Investiga por qué fallan los cargos de un cliente

👤 Ingenieros de soporte, fundadores haciendo soporte de primera línea ⏱ ~10 min beginner

Cuándo usarlo: El cliente dice 'mi tarjeta fue rechazada 3 veces'. Quieres ver qué sucedió realmente en el lado de Stripe.

Requisitos previos

Clave de API restringida de Stripe con lectura en cargos/clientes — dashboard.stripe.com/apikeys → Claves restringidas → otorga Lectura en Clientes, Cargos, Intenciones de pago

Flujo

Encuentra el cliente

Encuentra el cliente de Stripe con correo electrónico '[email protected]'. Muestra su método de pago predeterminado y gasto total.✓ Copiado

→ Registro de cliente con detalles del método de pago
Extrae cargos fallidos recientes

Enumera los cargos de este cliente en los últimos 30 días donde estado != 'succeeded'. Para cada uno, muestra el código de error y el mensaje.✓ Copiado

→ Lista de errores con códigos como card_declined/expired_card/etc.
Explica y recomienda una acción

¿Cuál es el problema real? Recomienda qué decirle al cliente (p. ej., 'tarjeta expirada — por favor actualiza', o 'bloqueo por fraude — intenta con otra tarjeta').✓ Copiado

→ Explicación clara orientada al cliente

Resultado: Ticket de soporte resuelto con la causa real, no 'intenta más tarde'.

Errores comunes

Mirar solo los cargos — se pierden las Intenciones de pago que nunca llegaron a un cargo — También verifica Intenciones de pago con estado 'requires_payment_method' o 'canceled'
El cliente dice 'rechazado' pero fue abandono de 3DS — Los desafíos de 3DS que el usuario cierra se muestran como requires_action y luego expiran; verifica la línea de tiempo

Crea una factura de prueba y un enlace de pago para un trato

👤 Personas de ventas y operaciones cerrando tratos personalizados ⏱ ~5 min beginner

Cuándo usarlo: Acordaste un precio personalizado único con un cliente y necesitas una factura o un enlace de pago, rápido.

Requisitos previos

Clave de modo de PRUEBA (sk_test_...) — Siempre comienza en modo de prueba. Cambia a la clave en vivo solo después de validar el flujo.

Flujo

Encuentra o crea el cliente

Busca el cliente de Stripe con correo electrónico '[email protected]'. Si no existe, crea uno con el nombre 'BigCo Inc'.✓ Copiado

→ ID de cliente devuelto
Crea un precio único + elemento de factura

Crea un elemento de factura único: $4,500, descripción 'Servicios de incorporación Q2'. Adjunta al cliente. Luego crea y finaliza una factura.✓ Copiado

→ Factura con hosted_invoice_url
Confirma el entregable

Dame la URL de la factura alojada y un resumen de lo que se creó. No la envíes por correo electrónico — la reenviaré manualmente.✓ Copiado

→ URL + resumen; sin correos electrónicos sorpresos enviados

Resultado: Una factura que puedes enviar al cliente en 90 segundos.

Errores comunes

Enviar correos electrónicos automáticos a clientes desde el chat es un paso en falso — Usa auto_advance: false y omite send_invoice hasta que hayas revisado; el MCP no debe enviar correos electrónicos a clientes de producción sin confirmación explícita
La confusión de modo prueba/en vivo significa que dinero real fluye para una 'prueba' — Siempre inspecciona el prefijo de la clave de API (sk_test_ vs sk_live_) antes de cualquier mutación; haz que el MCP lo repita

Combinar con: supabase

Calcula el MRR actual y la pérdida de clientes de las suscripciones de Stripe

👤 Fundadores haciendo operaciones financieras ⏱ ~15 min intermediate

Cuándo usarlo: Revisión mensual; quieres una lectura rápida de MRR/pérdida directamente de la fuente.

Flujo

Extrae suscripciones activas

Enumera todas las suscripciones activas de Stripe (status='active' o 'trialing'). Agrupa por price_id, suma el equivalente de MRR.✓ Copiado

→ Totales por precio + total general
Extrae canceladas este mes

Enumera las suscripciones canceladas en los últimos 30 días. Para cada una, muestra la fecha de inicio, MRR aportado y cliente.✓ Copiado

→ Lista de pérdida con impacto de ingresos
Calcula el nuevo MRR neto

Nuevo MRR neto = nuevo este mes - pérdida este mes. Calcula y escribe un resumen de 3 líneas.✓ Copiado

→ Un único número con desglose de cálculo

Resultado: Una instantánea de MRR precisa que puedes pegar en tu revisión mensual.

Errores comunes

Los planes anuales necesitan normalización mensual — Divide el precio anual entre 12 al sumar MRR; el MCP no lo hace por ti
Los descuentos y créditos sesgan el bruto frente al neto — Decide la convención de MRR (bruto frente a neto de descuentos) y aplícala consistentemente

Combinar con: filesystem

Procesa un reembolso con salvaguardas apropiadas

👤 Líderes de soporte con autoridad de reembolso ⏱ ~5 min beginner

Cuándo usarlo: El cliente solicita un reembolso; quieres verificar el cargo y procesarlo limpiamente.

Requisitos previos

Clave de API con refunds:write — Clave restringida, otorga solo los alcances mínimos

Flujo

Encuentra y valida el cargo

Encuentra el cargo de Stripe ch_xxx. Muestra el monto, cliente, estado, y si ya fue reembolsado (parcial o completo).✓ Copiado

→ Detalles del cargo + historial de reembolsos
Previsualiza el reembolso

Quiero reembolsar $50 de $200 (parcial). Muéstrame cómo se vería la llamada de reembolso. No ejecutes todavía.✓ Copiado

→ Previsualización de prueba seca de la llamada de API
Ejecuta en la confirmación

Procede con el reembolso parcial. Devuelve el ID de reembolso y el estado actualizado del cargo.✓ Copiado

→ Reembolso creado, cargo marcado como partially_refunded

Resultado: Reembolso procesado limpiamente con pista de auditoría.

Errores comunes

Reembolsar más que el cargo original falla confusamente — Siempre verifica el saldo reembolsable restante antes de solicitar; el MCP repite el límite
El reembolso desencadena un webhook en tu aplicación — puede actualizar dos veces el estado interno — Coordina el flujo de reembolso con quien mantenga el manejador de webhook

Audita el saldo y los pagos recientes antes del cierre del trimestre

👤 Finanzas, fundadores ⏱ ~10 min intermediate

Cuándo usarlo: Fin de trimestre, quieres saber exactamente qué hay en Stripe y qué está a punto de llegar al banco.

Flujo

Obtén el desglose del saldo actual

Muestra el saldo actual de Stripe: disponible, pendiente, en tránsito. Desglosa por moneda.✓ Copiado

→ Balance triple por moneda
Enumera los pagos recientes

Enumera los pagos en los últimos 90 días con fecha, monto, estado y fecha de llegada. Ordena por fecha desc.✓ Copiado

→ Calendario de pagos con totales
Concilia con tu libro contable

¿Cuál es el monto total de pago en el período? Dime qué esperar que llegue al banco en los próximos 7 días.✓ Copiado

→ Total agregado del período + pronóstico a corto plazo

Resultado: Un resumen listo para la conciliación.

Errores comunes

Las reservas y fondos en disputa no están en 'available' — No equipares balance.available + balance.pending = efectivo total; verifica los saldos retenidos por separado

Combinar con: filesystem

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

stripe + supabase

Webhook de Stripe → Función Edge de Supabase → consultas de Stripe MCP para enriquecer el manejo de eventos

Cuando se dispara el webhook de Stripe 'invoice.payment_failed', la Función Edge llama a Stripe MCP para obtener los cargos recientes del cliente y pega un resumen en nuestro canal de operaciones de Slack.✓ Copiado

stripe + postgres

Concilia los cargos de Stripe con tu DB de pedidos interna

Para cada cargo exitoso de Stripe de ayer, encuentra la fila coincidente en nuestra tabla orders por stripe_payment_intent_id. Marca los desajustes.✓ Copiado

stripe + filesystem

Exporta datos de Stripe a CSV para el equipo de finanzas

Exporta todas las facturas del trimestre pasado a /reports/invoices-Q1-2026.csv con correo electrónico del cliente, monto, estado y fecha.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_customers / retrieve_customer / create_customer / update_customer	Parámetros de cliente de Stripe	CRUD de cliente	API de Stripe gratuita
list_products / create_product / update_product	Parámetros de producto	Operaciones de catálogo de productos	gratuita
list_prices / create_price	Parámetros de precio	Operaciones de precio (únicos o recurrentes)	gratuita
list_invoices / create_invoice / finalize_invoice / pay_invoice	Parámetros de factura	Ciclo de vida de la factura	gratuita
create_invoice_item	customer, amount, currency, description	Añade una línea a una factura borrador	gratuita
list_payment_intents / retrieve_payment_intent	Parámetros de PI	Inspecciona el estado del flujo de pago	gratuita
list_charges / retrieve_charge	Parámetros de cargo	Inspección de cargo	gratuita
create_refund	charge: str, amount?: int	Emite un reembolso completo o parcial — destructivo en modo en vivo	API de Stripe gratuita; el reembolso en sí mueve dinero
create_payment_link	line_items, after_completion?	Genera una URL de pago alojada para enviar a un cliente	gratuita
list_subscriptions / cancel_subscription / update_subscription	Parámetros de suscripción	Ciclo de vida de la suscripción	gratuita
retrieve_balance	ninguno	Saldo disponible/pendiente actual	gratuita
list_payouts	limit, created?	Ver pagos recientes y próximos	gratuita
search_*	query: str (sintaxis de búsqueda de Stripe)	Filtrado potente en todos los recursos a través de la API de búsqueda	gratuita

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: La API de Stripe tiene límites de velocidad generosos (100 req/s lectura en vivo, 25 req/s en prueba por defecto)
Tokens por llamada: Los objetos de Stripe consumen muchos tokens (datos anidados ricos). Usa expand solo cuando sea necesario; limita los tamaños de lista
Monetario: MCP gratuito; Stripe cobra por pago procesado, no por llamada de API
Consejo: En modo prueba, los costos son cero. En modo en vivo, el único 'costo' que importa son los reembolsos o facturas emitidas accidentalmente — controla las escrituras con filtrado --tools=.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: clave restringida con los alcances mínimos por flujo de trabajo (p. ej. Customers:read + Charges:read para soporte)

Almacenamiento de credenciales: Clave de API en variable de entorno STRIPE_SECRET_KEY. Nunca hagas commit. Usa claves restringidas, no la clave secreta raíz.

Salida de datos: Todas las llamadas a api.stripe.com (TLS, PCI manejado por Stripe)

No conceder nunca: clave secreta raíz a agentes de larga duración clave de API con Refunds:write o Subscriptions:write a flujos de trabajo autónomos sin HITL

Modo en vivo significa dinero real. Siempre confirma el prefijo de clave (sk_live_ vs sk_test_) antes de cualquier llamada de escritura.
Usa la bandera CLI --tools= (p. ej. --tools=customers.read,charges.read) para restringir el MCP a un subconjunto seguro.
Los webhooks actualizan el estado interno — coordina los reembolsos y cancelaciones con ingeniería.

Resolución de problemas

Errores comunes y soluciones

401 Clave de API no válida

Clave incorrecta, revocada o desajuste prueba/en vivo. Verifica en el panel. Confirma que la variable de entorno se exporta al proceso cliente de MCP.

Verificar: curl https://api.stripe.com/v1/balance -u $STRIPE_SECRET_KEY:

Permiso denegado: esta clave no tiene acceso a ...

Clave restringida sin el alcance relevante. Edita la clave en el panel para otorgar el permiso necesario.

Reembolso: el monto excede el reembolsable restante

Cargo ya parcialmente reembolsado. Recupera el cargo primero, verifica amount_refunded, reembolsa solo el resto.

Búsqueda devuelve 0 resultados a pesar de que el objeto existe

Stripe Search tiene una demora de propagación (~1 minuto para objetos recién creados). Usa list/retrieve para elementos muy recientes.

Alternativas

Stripe vs otros

Alternativa	Cuándo usarla	Contrapartida
Stripe CLI via shell	Quieres reenvío de webhooks, generación de fixtures o flujos de prueba locales	Sin ergonomía de agente; diseñado para flujos de trabajo de desarrollo
API REST directo a través de fetch MCP	Necesitas una característica que el MCP oficial no expone	Autenticación, paginación y tipos son todos manuales; mucho más propenso a errores

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills