Desarrollando integraciones de IA con LLM y MCP de Yuno

Yuno ofrece herramientas para ayudarte a crear experiencias de pago compatibles con IA y fáciles de usar para comercios. Nuestra documentación, preparada para máquinas, facilita que los grandes modelos de lenguaje (LLM) comprendan las API y la documentación de Yuno, mientras que nuestro Protocolo de Contexto de Modelo (MCP) facilita la integración de las capacidades de Yuno en tu producto.

Esta guía presenta cómo trabajar con ambos componentes. Aprenderá cómo la capa LLM permite que las herramientas de IA brinden una integración más precisa y contextual, y cómo el MCP puede integrar funcionalidades clave de pago y comercio directamente en su entorno, lo que permite compilaciones más rápidas y con menos fricción.

Contenido listo para máquina en texto sin formato

Para ayudar a los modelos de lenguaje grandes a comprender y soportar las integraciones de Yuno, ofrecemos un conjunto específico de archivos Markdown (.md), diseñados específicamente para la legibilidad por máquina. Estos archivos describen las API de Yuno, el comportamiento del producto y los detalles de implementación en un formato fácil de analizar para los LLM.

Los archivos .md son parte de Yuno Docs. Puedes acceder a ellos añadiendo .md al final de cualquier URL de Yuno Docs (esto funciona tanto para las Guías como para las páginas de Referencia API). El contenido se sirve en texto plano, lo que facilita que las máquinas extraigan y procesen el conocimiento subyacente sin necesidad de interpretación humana.

Esta configuración permite que los asistentes de IA, las herramientas de desarrollo y los agentes de chat respondan preguntas, expliquen funciones y guíen integraciones automáticamente. Es una forma sencilla pero potente de abrir la documentación de Yuno a una amplia gama de aplicaciones inteligentes.

📘
¿Buscas un endpoint MCP gestionado y accesible en red con enlace IP, límites de velocidad y TTL de sesión? Consulta el servidor MCP remoto de Yuno.

Protocolo de Contexto Modelo de Yuno (MCP)

Este paquete proporciona un servidor MCP que expone la API de la plataforma de pago Yuno como herramientas del Protocolo de Contexto de Modelo. Permite el acceso programático a agentes de IA, sistemas de automatización y otros flujos de trabajo avanzados que se basan en un contexto estructurado y legible por máquina.

Características

Expone endpoints la API Yuno como herramientas MCP: Cada endpoint se modela como una herramienta que los agentes pueden llamar mediante programación, con estructuras claras de entrada y salida.
Habilita la IA y los flujos de trabajo de automatización con Yuno: integra Yuno en agentes locales o flujos de trabajo personalizados sin una lógica compleja y artesanal.
Fácil integración con Cursor y otros agentes compatibles con MCP: Funciona de forma inmediata con herramientas como Cursor, Claude Desktop y otros entornos compatibles con el Protocolo de Contexto de Modelo.

Herramientas disponibles

El servidor Yuno MCP pone a disposición de los agentes de IA y la automatización las siguientes herramientas:

Nombre de la herramienta	Descripción
`customer.create`	Crear un nuevo cliente
`customer.retrieve`	Recuperar un cliente por ID
`customer.retrieveByExternalId`	Recuperar un cliente por id externo (`merchant_customer_id`)
`customer.update`	Actualizar un cliente existente por ID
`paymentMethod.enroll`	Inscribir o crear un método de pago para un cliente
`paymentMethod.retrieve`	Recuperar método de pago
`paymentMethod.retrieveEnrolled`	Recuperar todos los métodos de pago registrados para un cliente
`paymentMethod.unenroll`	Método de pago para cancelar la inscripción
`checkoutSession.create`	Crear una sesión de checkout
`checkoutSession.retrievePaymentMethods`	Recuperar métodos de pago para el pago
`payments.create`	Crear un pago con varios flujos de trabajo
`payments.retrieve`	Recuperar información de pago
`payments.retrieveByMerchantOrderId`	Recuperar pago(s) por `merchant_order_id`
`payments.refund`	Reembolsar un pago (total o parcial) por ID de pago y transacción
`payments.cancelOrRefund`	Cancelar o reembolsar un pago por ID de pago (detecta automáticamente la acción)
`payments.cancelOrRefundWithTransaction`	Cancelar o reembolsar un pago mediante el ID de pago y transacción (detecta automáticamente la acción)
`payments.cancel`	Cancelar un pago pendiente por ID de pago y transacción
`payments.authorize`	Autorizar un pago (`capture: false`)
`payments.captureAuthorization`	Capturar un pago previamente autorizado
`paymentLinks.create`	Crear un nuevo enlace de pago
`paymentLinks.retrieve`	Recuperar un enlace de pago por ID
`paymentLinks.cancel`	Cancelar un enlace de pago por ID
`subscriptions.create`	Crear una nueva suscripción
`subscriptions.retrieve`	Recuperar una suscripción por ID
`subscriptions.pause`	Pausar una suscripción por ID
`subscriptions.resume`	Reanudar una suscripción por ID
`subscriptions.update`	Actualizar una suscripción por ID
`subscriptions.cancel`	Cancelar una suscripción por ID
`recipients.create`	Crear un nuevo destinatario
`recipients.retrieve`	Recuperar un destinatario por ID
`recipients.update`	Actualizar un destinatario por ID
`recipients.delete`	Eliminar un destinatario por ID
`recipients.createOnboarding`	Crear la incorporación de un destinatario
`installmentPlans.create`	Crear un nuevo plan de pago
`installmentPlans.retrieve`	Recuperar un plan de pago por ID
`installmentPlans.retrieveAll`	Recuperar todos los planes de pago de una cuenta
`installmentPlans.update`	Actualizar un plan de pago por ID
`installmentPlans.delete`	Eliminar un plan de cuotas por ID
`documentation.read`	Acceda a la documentación y guías de la API de Yuno

Uso del MCP con Cursor o Claude Desktop

Puede utilizar este servidor MCP con Cursor o Claude Desktop para habilitar flujos de pago impulsados por IA, creación de clientes y más.

1. Configura tus credenciales de la API de Yuno

Configure sus credenciales de API de Yuno usando variables de entorno (consulte los ejemplos de configuración a continuación).

2. Agregue el servidor MCP a Cursor

Abrir configuración del cursor (Cmd+Shift+P → "Configuración del cursor")
Vaya a la sección MCP y haga clic en Añadir nuevo servidor MCP global
Agregue la siguiente configuración (reemplace la ruta con su salida de compilación real):

{
  "mcpServers": {
    "yuno-mcp": {
      "type": "command",
      "command": "npx @yuno-payments/yuno-mcp@latest",
      "env": {
        "YUNO_ACCOUNT_CODE": "your_account_code",
        "YUNO_PUBLIC_API_KEY": "your_public_api_key",
        "YUNO_PRIVATE_SECRET_KEY": "your_private_secret_key",
        "YUNO_COUNTRY_CODE": "your_country_code",
        "YUNO_CURRENCY": "your_currency"
      }
    }
  }
}

3. Agregue el servidor MCP a Claude Desktop

Abra la configuración de Claude Desktop → pestaña "Desarrollador" → Editar configuración.
Agregue la siguiente configuración:

{
  "mcpServers": {
    "yuno-mcp": {
      "command": "npx",
      "args": ["@yuno-payments/yuno-mcp@latest"],
      "env": {
        "YUNO_ACCOUNT_CODE": "your_account_code",
        "YUNO_PUBLIC_API_KEY": "your_public_api_key",
        "YUNO_PRIVATE_SECRET_KEY": "your_private_secret_key",
        "YUNO_COUNTRY_CODE": "your_country_code",
        "YUNO_CURRENCY": "your_currency"
      }
    }
  }
}

4. Pruebe la integración

En Cursor o Claude, selecciona un archivo Markdown o un chat y pídale al agente que cree una sesión de pago, cliente o pago utilizando la herramienta yuno-mcp
Asegúrese de que sus variables de entorno estén configuradas correctamente

Variables de entorno

YUNO_ACCOUNT_CODE*
YUNO_PUBLIC_API_KEY*
YUNO_PRIVATE_SECRET_KEY*
YUNO_COUNTRY_CODE (opcional)
YUNO_CURRENCY (opcional)

Se requieren marcas de asterisco (*).

Apoyo

Para soporte oficial de Yuno, por favor visita la documentación oficial de Yuno