Stripe MCP

Stripe MCP es un componente sencillo que conecta tu dashboard con la plataforma de pagos Stripe. Con él puedes elegir una herramienta predefinida (por ejemplo, crear un cliente, cobrar una suscripción, etc.) y ejecutar esa acción directamente desde Nappai, sin tocar código.

¿Cómo funciona?

Stripe MCP envía peticiones a la API de Stripe usando la clave de API que le proporciones. Cuando seleccionas una herramienta en el menú desplegable, el componente construye la solicitud correspondiente y la envía a Stripe. La respuesta de Stripe (normalmente un objeto JSON con los datos de la operación) se devuelve como salida del componente y puede ser usada por otros componentes en tu flujo de trabajo.

Entradas

Campos de Entrada

• API Key: La clave secreta de tu cuenta de Stripe. Es obligatoria y debe mantenerse en secreto.
• Tool: Herramienta que deseas ejecutar. Es un campo obligatorio y se muestra como un menú desplegable con las opciones disponibles (por ejemplo, “Create Customer”, “Create Charge”, etc.).

Salidas

El componente devuelve la respuesta de Stripe en formato JSON. Esta salida puede incluir información como el ID del cliente creado, el estado del cargo, errores, etc. Puedes usar esta salida para tomar decisiones posteriores en tu flujo de trabajo o para mostrar resultados al usuario.

Ejemplo de Uso

1. Añade el componente Stripe MCP a tu flujo de trabajo.
2. Configura la entrada:
   • En API Key pega la clave secreta de tu cuenta de Stripe (puedes guardarla en un secreto seguro de Nappai).
   • En Tool selecciona “Create Customer”.
3. Ejecuta el flujo.
4. Revisa la salida: verás un objeto JSON con el ID del nuevo cliente y otros detalles.
5. Conecta la salida a otro componente, por ejemplo, para enviar un correo de bienvenida al cliente.

Componentes Relacionados

• StripeMCPBase: Base que contiene la lógica común para todas las herramientas de Stripe.
• Stripe API: Servicio externo que procesa las peticiones enviadas por Stripe MCP.

Consejos y Mejores Prácticas

• Mantén tu API Key segura: no la compartas en el código ni la publiques en repositorios.
• Prueba en modo sandbox: usa la clave de prueba de Stripe para evitar cargos reales durante el desarrollo.
• Valida la respuesta: verifica el campo status o error en la salida antes de continuar con el flujo.
• Registra los errores: si Stripe devuelve un error, guarda el mensaje para depurar más tarde.

Consideraciones de Seguridad

• La API Key es la credencial que permite acceder a tu cuenta de Stripe. Si se filtra, alguien podría crear cargos o acceder a datos sensibles.
• Almacena la clave en un secreto seguro de Nappai y restringe su acceso solo a los usuarios que necesiten ejecutarla.
• Utiliza la clave de prueba de Stripe cuando trabajes en entornos de desarrollo o pruebas.

---