> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Crea con IA

> Conecta Claude Code, Cursor, Windsurf, VS Code o cualquier agente de programación a la documentación y la API de Yuno para que integre el SDK y cree pagos con contexto actualizado

Yuno publica su documentación y su API en los formatos que leen los agentes de programación. Conecta tu agente una sola vez y podrá generar la base del SDK, crear sesiones de checkout y pagos en sandbox, y leer las respuestas de la API con los nombres de campo actuales en lugar de adivinarlos a partir de sus datos de entrenamiento.

Hay tres cosas que puedes conectar, y rara vez necesitas todas:

| Quieres que el agente | Conecta | Autenticación |
| :- | :- | :- |
| Lea la documentación mientras escribe tu integración | Servidor MCP de documentación en `https://docs.y.uno/mcp` | Ninguna |
| Llame a la API de Yuno en tu cuenta (crear clientes, sesiones, pagos, reembolsos) | [Remote Yuno MCP Server](https://docs.y.uno/es/docs/ai-capabilities/remote-yuno-mcp-server.md) en `https://mcp.prod.y.uno/mcp`, o el paquete local `@yuno-payments/yuno-mcp` | Tus claves de API |
| Lance un producto de IA que recibe pagos | [Agent Toolkit](https://docs.y.uno/es/docs/ai-capabilities/agent-toolkit.md) (`@yuno-payments/agent-toolkit`) | Tus claves de API |

## Claude Code

Agrega el servidor de documentación a Claude Code desde la terminal:

```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
claude mcp add --transport http yuno-docs https://docs.y.uno/mcp
```

Para compartirlo con todas las personas del repositorio, haz commit de un archivo `.mcp.json` en la raíz del proyecto:

```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
{
  "mcpServers": {
    "yuno-docs": {
      "type": "http",
      "url": "https://docs.y.uno/mcp"
    }
  }
}
```

Luego pide lo que necesites en lenguaje natural, por ejemplo:

* "Integra el Yuno Seamless SDK en esta aplicación Next.js. Crea la sesión de checkout en un route handler y monta el SDK en un componente de cliente."
* "Agrega una ruta `/api/payments` que cree un pago de Yuno a partir del token de un solo uso y siga las reglas de reintento de pagos."
* "Suscríbete a los webhooks `payment.purchase` y `payment.chargeback` y verifica la firma HMAC."

Claude Code también lee archivos `AGENTS.md`. Yuno publica uno en [docs.y.uno/AGENTS.md](https://docs.y.uno/AGENTS.md) con comandos de instalación, URL base, credenciales y el flujo de pago de cuatro pasos; cópialo en tu proyecto o apunta al agente a la URL.

## Cursor, Windsurf y VS Code

Agrega el mismo servidor desde la configuración de MCP de cada editor. Las instrucciones paso a paso para Cursor, Claude Desktop, Windsurf y VS Code Copilot están en [Setup MCP](https://docs.y.uno/setup-mcp.md). La configuración es la misma en todos: tipo `http`, URL `https://docs.y.uno/mcp`, sin credenciales.

## Cualquier agente

Los agentes que no usan MCP también pueden leer todo:

* **`https://docs.y.uno/llms.txt`** enumera todas las páginas en un índice legible por máquinas. Agrega `.md` a cualquier URL de la documentación para obtener esa página en Markdown.
* **`https://docs.y.uno/openapi.json`** (también `.yaml`) es la especificación OpenAPI 3.1 de la API de pagos, agregada a partir de las especificaciones por operación que respaldan la referencia de la API.
* **[Recursos para desarrolladores](https://docs.y.uno/es/docs/developers.md)** enumera los puntos de entrada que un agente debe leer primero y la guía de inicio rápido para agentes.

## Deja que el agente actúe en tu cuenta

Cuando el agente debe crear objetos reales en lugar de escribir código, dale el servidor MCP de la API. El endpoint alojado es `https://mcp.prod.y.uno/mcp` con los encabezados `public-api-key`, `private-secret-key` y `account-code`; la opción local es `npx @yuno-payments/yuno-mcp@latest` con los mismos valores como variables de entorno. Ambos exponen como herramientas clientes, métodos de pago, sesiones de checkout, pagos, links de pago, suscripciones, destinatarios y planes de cuotas. Consulta [Building AI Integrations with Yuno's LLMs and MCP](https://docs.y.uno/es/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp.md) para ver la lista de herramientas y [Remote Yuno MCP Server](https://docs.y.uno/es/docs/ai-capabilities/remote-yuno-mcp-server.md) para conocer los límites de sesión.

> [!WARNING]
>
> Usa claves de sandbox mientras el agente itera. El servidor MCP de la API ejecuta lo que el agente le pide, incluidos reembolsos y cancelaciones en producción si le das claves de producción.

## Verifica lo que escribió el agente

Un agente con la documentación conectada necesita las mismas revisiones que una persona:

* Los pagos se crean desde tu servidor con el token de un solo uso, nunca desde el navegador.
* `X-Idempotency-Key` se envía en cada llamada a la API.
* El callback `createPayment` sigue las [reglas de reintento de pagos](https://docs.y.uno/docs/sdks/resources/references/web.md#payment-retry).
* Los manejadores de webhooks verifican `x-hmac-signature` antes de confiar en el payload.

Si el agente trabaja en React o Next.js, apúntalo a la guía de React y Next.js en SDKs para conocer el patrón de montaje solo en el cliente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.