Saltar al contenido principal
Blog
Volver al blog

Stripe MCP en Claude Code: configuración segura y el cambio de claves del 30 de noviembre

El servidor MCP de Stripe permite que Claude Code consulte la documentación de Stripe, lea tu cuenta y cree objetos como productos, precios y enlaces de pago mientras desarrollas. La documentación de Stripe indica que, después del 30 de noviembre de 2026, su servidor MCP dejará de aceptar claves secretas de acceso completo y claves restringidas sin la etiqueta Agent. Si configuraste Stripe MCP hace meses pegando una clave en un archivo de configuración, esa conexión dejará de funcionar en diciembre. Esta guía es para un fundador que desarrolla en solitario con Claude Code: cómo conectar Stripe de la forma que Stripe recomienda ahora, por qué empezar en un sandbox, cómo encontrar claves antiguas en los archivos de configuración de tus agentes, cómo migrar y cómo funcionan las aprobaciones cuando eres la única persona en la cuenta. Es útil sin una cuenta de Soloop y no es una auditoría de seguridad.

La respuesta breve

Instala la Stripe CLI y ejecuta stripe agent setup. Detecta Claude Code e instala el plugin de Stripe, que configura el servidor MCP alojado en mcp.stripe.com y las skills de Stripe. Inicia Claude Code, ejecuta /mcp e inicia sesión en Stripe con OAuth. En la página de consentimiento de Stripe, concede primero un sandbox y añade el modo live solo cuando lo necesites.

Si alguna de tus herramientas envía a mcp.stripe.com una clave secreta sk_ o una clave restringida rk_ sin la etiqueta Agent, sustitúyela antes del 30 de noviembre de 2026: vuelve a conectar con OAuth o crea una clave de API de agente con solo los permisos que necesita la tarea y cárgala desde una variable de entorno. Mantén los reembolsos y las cancelaciones de suscripciones detrás de una aprobación, y nunca le digas a Claude Code que permita siempre la herramienta de escritura de Stripe.

Qué cambia el 30 de noviembre de 2026

El servidor MCP de Stripe admite dos formas de iniciar sesión: OAuth, para un cliente que actúa en nombre de tu cuenta de usuario de Stripe, y las claves de API de agente, para una aplicación de IA que necesita acceso independiente y persistente. Una clave de API de agente es una clave restringida que, al crearla, se etiqueta como perteneciente a un agente autónomo. Se autentica como cualquier otra clave restringida, pero queda sujeta automáticamente a las reglas de aprobación de Stripe.

A partir de diciembre, las solicitudes al servidor MCP que usen una clave secreta de acceso completo o una clave restringida sin la etiqueta Agent recibirán una respuesta 401 con un desafío de descubrimiento de OAuth. El aviso de Stripe trata sobre las claves enviadas a su servidor MCP. No dice que cambien las claves que usa tu aplicación para cobrar a los clientes; una clave que tu app usa en su propio servidor es otra cuestión, cubierta por el consejo general de Stripe de preferir claves restringidas.

El corte

"Migrate by November 30, 2026. Starting in December, Stripe MCP will stop accepting full-access secret keys and restricted API keys without the Agent tag. Replace these keys with newly created agent API keys or reconnect with OAuth." (Migra antes del 30 de noviembre de 2026. A partir de diciembre, Stripe MCP dejará de aceptar claves secretas de acceso completo y claves de API restringidas sin la etiqueta Agent. Sustituye estas claves por claves de API de agente nuevas o vuelve a conectar con OAuth.)

Documentación de Stripe: Model Context Protocol
Cuál usar

Usa OAuth para clientes MCP interactivos; te permite autorizar y revocar un cliente sin compartir una clave de API. Para clientes autónomos que no pueden usar OAuth, crea una clave de API de agente con solo los permisos que necesita el cliente, pruébala en un sandbox y después haz caducar la clave antigua.

Documentación de Stripe: Model Context Protocol
Claves de agente

Para etiquetar una clave restringida como clave de agente, selecciona "Authorizing agent access to your account" (autorizar el acceso de un agente a tu cuenta) cuando Stripe pregunte el uso previsto de la clave. Las claves etiquetadas como de agente están sujetas a reglas de aprobación; Stripe añade reglas predeterminadas cuando creas la primera.

Documentación de Stripe: API keys
Servidor local antiguo

Los paquetes @stripe/mcp y @stripe/agent-toolkit están obsoletos y "will receive no further updates, including security fixes" (no recibirán más actualizaciones, ni siquiera correcciones de seguridad); Stripe remite al servidor alojado.

GitHub: stripe/ai

Qué acceso encaja con cada tarea

La mayoría de los fundadores que usan Claude Code desde su propio teclado necesitan OAuth y nada más. Una clave de agente es para el trabajo que se ejecuta sin ti, como una tarea programada o un agente sin interfaz en CI.

Formas en que una herramienta de programación con IA puede acceder a Stripe, y cuándo encaja cada una
DimensiónEncaja cuandoDespués del 30 de noviembre de 2026
Plugin o /mcp con OAuthTrabajas en Claude Code, Codex o Cursor y puedes iniciar sesión desde un navegador. Eliges sandboxes o cuentas live y permisos en la página de consentimiento de Stripe.Recomendado por Stripe. Revoca una sesión en OAuth sessions, en la configuración de usuario de Stripe.
Clave de API de agente en una variable de entornoEl agente se ejecuta sin ti o el cliente no puede usar OAuth. La clave solo tiene los permisos que tú fijas.Aceptada. Las acciones sensibles siguen tus reglas de aprobación.
Clave secreta (sk_) o clave restringida sin etiqueta (rk_) enviada a mcp.stripe.comConfiguraciones antiguas que pegaban una clave en un archivo de configuración.Rechazada con un 401. Sustitúyela antes del corte.
Paquete local @stripe/mcp con --api-keyTutoriales antiguos lo iniciaban con npx y una clave secreta.Obsoleto y sin correcciones de seguridad. Pasa al servidor alojado.

Configura Stripe en Claude Code, primero en un sandbox

Un sandbox es un entorno de pruebas aislado de Stripe: ninguna red de tarjetas procesa nada y sus objetos nunca se mezclan con el modo live. Desarrollar en un sandbox significa que una petición confusa crea un precio de prueba, no uno real.

  1. Instala la Stripe CLI (versión 1.43.3 o posterior) con npm install -g @stripe/cli o con el script de instalación de Stripe.
  2. En el directorio de tu proyecto, ejecuta stripe agent setup --client claude-code. Ejecuta stripe agent setup --status en cualquier momento para ver qué está instalado.
  3. Inicia Claude Code y ejecuta /mcp. Elige el servidor de Stripe e inicia sesión. En la página de consentimiento de Stripe, concede un sandbox y los permisos que quieras; deja fuera el modo live por ahora.
  4. Si administras la cuenta, abre la configuración del Dashboard para el acceso de MCP y CLI y decide por separado si el modo live y los sandboxes permiten MCP.
  5. Mantén activada la aprobación de herramientas de Claude Code, para que cada llamada a Stripe que cambie algo espere tu confirmación.
  6. Pide primero una tarea de solo lectura, como "Enumera los productos y precios de mi sandbox de Stripe", y comprueba que la respuesta coincide con el Dashboard.
  7. Antes de aceptar pagos reales, sigue la lista de comprobación de puesta en producción de Stripe. Concede el modo live a la conexión MCP solo para las tareas que lo necesiten.

Encuentra claves antiguas de Stripe en la configuración de tus agentes

Ejecútalos desde una terminal, no a través de un agente, para que los valores de las claves no acaben en una transcripción de IA. Cada comando muestra solo nombres de archivo o identificadores de commit. Se probaron con grep y git en macOS; en Linux, la configuración de Claude Desktop está en otra ubicación.

  1. Configuraciones de agentes a nivel de usuario que contienen una clave de Stripe: grep -lE '(sk|rk)_(live|test)_' ~/.claude.json ~/.cursor/mcp.json ~/.codex/config.toml ~/Library/"Application Support"/Claude/claude_desktop_config.json 2>/dev/null
  2. Configuraciones de proyecto en cada repositorio, desde su raíz: grep -rlE '(sk|rk)_(live|test)_' .mcp.json .claude .cursor .vscode 2>/dev/null
  3. Qué configuraciones usan Stripe MCP: grep -rlE 'mcp\.stripe\.com|@stripe/mcp' ~/.claude.json .mcp.json .claude .cursor .vscode 2>/dev/null
  4. ¿Llegó alguna vez una clave al historial de git? git log --all --oneline -G '(sk|rk)_(live|test)_' enumera cada commit que añadió o eliminó una, incluso en archivos que ya has borrado.
  5. Abre cada archivo que indiquen los comandos y busca una clave de Stripe en una entrada de servidor MCP, una cabecera Authorization, un argumento --api-key o un permiso de comando guardado.

Migra antes del corte

  1. Para cada conexión que encontró la búsqueda, decide: ¿puedes iniciar sesión con OAuth? Si es así, elimina la clave de la configuración y ejecuta /mcp para volver a conectar.
  2. Si la tarea debe ejecutarse sin ti, crea una clave nueva en la página de claves de API: Create restricted key (crear clave restringida), elige "Authorizing agent access to your account" y concede solo los recursos que la tarea lee o escribe. Créala primero en un sandbox.
  3. Guarda la clave en tu gestor de secretos o en una variable de entorno, nunca en el propio .mcp.json, y haz referencia a ella por su nombre (plantilla más abajo).
  4. Ejecuta una solicitud de solo lectura y confirma que funciona. Un 401 con un desafío de OAuth significa que la clave no está etiquetada como clave de agente.
  5. Haz caducar la clave antigua, o rótala con un periodo de gracia si tu app también la usa. Stripe permite que ambas claves funcionen hasta 7 días durante una rotación.
  6. Elimina cualquier entrada de @stripe/mcp iniciada con npx y sustitúyela por el servidor alojado.

Copia el .mcp.json para una clave de agente

Úsalo solo cuando OAuth no sea posible. Guárdalo como .mcp.json en el proyecto, define STRIPE_AGENT_KEY en tu shell o gestor de secretos antes de iniciar Claude Code y mantén fuera de git los archivos .env y la propia clave. El nombre de la variable es un ejemplo; la documentación de Stripe usa AGENT_API_KEY.

Descargar Markdown

Concede solo lo que la tarea necesita

Ejemplos ilustrativos, no los valores predeterminados de Stripe: decide primero la tarea y después los permisos. Las claves restringidas y de agente te permiten fijar cada recurso en ninguno, lectura o escritura.

Conjuntos de permisos ilustrativos para tareas habituales de un fundador
DimensiónConcederDejar fuera
Responder "¿por qué falló este pago?"Acceso de lectura a clientes, cargos, payment intents y facturas.Todo el acceso de escritura.
Configurar productos, precios y enlaces de pago mientras desarrollasAcceso de escritura a productos, precios y enlaces de pago, en un sandbox.El modo live hasta el lanzamiento; reembolsos y pagos a tu cuenta bancaria (payouts).
Resumen semanal de ingresosAcceso de lectura a suscripciones, facturas y saldo.Actualizaciones de clientes y todo el acceso de escritura.
Preparar reembolsos para tu revisiónAcceso de escritura a reembolsos, con la regla de aprobación predeterminada activada.Payouts, transferencias y cambios de cuenta bancaria.

Aprobaciones cuando trabajas solo

Hay tres controles distintos y cumplen funciones diferentes. La propia solicitud de permiso de Claude Code pregunta antes de que se ejecute una herramienta. La Human confirmation (confirmación humana) de Stripe se aplica a algunas acciones a través de OAuth, como crear un reembolso: Stripe da a tu agente un enlace, tú apruebas en el Dashboard en un plazo de 24 horas y después le dices al agente que lo vuelva a intentar. Las reglas de aprobación de Stripe se aplican a las claves etiquetadas como de agente.

Las reglas predeterminadas de Stripe para las claves etiquetadas como de agente retienen para revisión los reembolsos, las cancelaciones de suscripciones, los payouts, los pagos y transferencias salientes, y las conversiones de divisas. El agente recibe un error approval_required y Stripe abre una solicitud; la apruebas o la rechazas en el Dashboard o en la app móvil de Stripe, y las solicitudes caducan a los 14 días. La aprobación de dos partes normalmente necesita un revisor distinto de quien la solicita, así que en una cuenta de Stripe de una sola persona solo puedes guardar esas reglas para acciones realizadas por claves etiquetadas como de agente. Es otro motivo para dar a un agente desatendido su propia clave de agente en lugar de tu propio inicio de sesión.

Qué permitir en la solicitud de permiso de Claude Code
DimensiónQué haceAjuste sugerido
search_stripe_documentation, stripe_api_search, stripe_api_detailsBusca en la documentación y la referencia de API de Stripe.Permitir.
stripe_api_read, get_stripe_account_infoLee objetos de la cuenta conectada, incluidos datos de clientes.Permitir en un sandbox; preguntar en modo live.
stripe_api_writeCualquier llamada de creación, actualización o eliminación, desde un precio hasta un reembolso o la cancelación de una suscripción.Preguntar siempre. Nunca elijas "don't ask again".
Herramientas de Treasury como send_moneyMueve dinero desde una cuenta de Treasury.No las uses salvo que utilices Treasury; Stripe exige Human confirmation.

Copia la hoja de trabajo de migración

Usa una copia para tu máquina y otra para cada repositorio. Anota la conexión y su nuevo acceso para poder revocarlo limpiamente más adelante.

Dónde encaja Soloop

Soloop no se conecta a Stripe, no lee tus datos de Stripe ni gestiona claves de API. Para todo lo anterior, usa las herramientas y el Dashboard de Stripe.

Soloop sirve para lo que viene después de poder cobrar: según el manual de Soloop, puede investigar un mercado con fuentes, escribir y publicar publicaciones y respuestas en X a través de una cuenta conectada, enviar mensajes de contacto a través de una cuenta de Gmail conectada y preparar campañas de búsqueda de Google Ads después de la configuración y el pago; por defecto, las acciones esperan tu aprobación. No pegues claves de Stripe en la petición de ninguna herramienta de IA, tampoco en la de Soloop.

Fuentes, limitaciones y actualización

La documentación de Stripe sobre Model Context Protocol, API keys, approvals, agent plugin, agent setup y skills, y el README de stripe/ai, se leyeron el 11 de noviembre de 2026. Stripe no ha publicado una hora de corte más precisa que "starting in December" (a partir de diciembre). Los comandos, los conjuntos de permisos y los ajustes de herramientas son orientación editorial probada en un directorio de muestra, no una auditoría de seguridad ni una declaración de Stripe o Anthropic.

Esta guía se revisará antes del 11 de febrero de 2027, o antes si Stripe cambia el corte o la forma en que se autentica su servidor MCP.

Aprobaciones

Las reglas predeterminadas para las claves etiquetadas como de agente cubren reembolsos, cancelaciones de suscripciones, pagos y transferencias salientes, payouts y conversiones de divisas. Las solicitudes caducan a los 14 días. Las cuentas de un solo usuario solo pueden guardar reglas de dos partes con la condición de actor fijada en claves de API etiquetadas como de agente.

Documentación de Stripe: Two-party approvals
Comando de configuración

stripe agent setup detecta Claude Code, Codex y Cursor e instala el plugin, las skills y el servidor MCP correspondientes; --client lo limita a una herramienta y --status muestra qué está instalado.

Stripe CLI: agent setup
Capacidad del producto

El manual de Soloop describe investigación con fuentes, publicación en X a través de una cuenta conectada, mensajes de contacto por Gmail y campañas de búsqueda de Google Ads después de la configuración y el pago; por defecto, primero se pide la aprobación. No se conecta a Stripe.

Manual de producto de Soloop