> ## 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.

# Conecta tu agente a la documentación de Yuno

> Agrega el servidor MCP de la documentación de Yuno a Cursor, Claude, Codex o VS Code. Solo lectura, sin credenciales de API, configurado en unos dos minutos.

Servidor MCP de documentación

Solo lectura · unos 2 minutos

El servidor MCP de la documentación de Yuno le da a tu agente de programación la documentación actualizada mientras integras. Es de solo lectura, no necesita credenciales de Yuno y no puede tocar pagos ni tu cuenta.

Busca en todas las páginas
Lee las referencias de la API
Sin API keys

URL del servidor · transporte HTTP · sin autenticación[https://docs.y.uno/mcp](https://docs.y.uno/mcp)Pégala en cualquier cliente MCP que admita servidores HTTP. Sin token, sin encabezado.

[Agrégalo a tu herramienta](#add-the-server)
[llms.txt](https://docs.y.uno/llms.txt)
[OpenAPI](https://docs.y.uno/openapi.json)

## Qué expone el servidor

Tres herramientas, todas de solo lectura. Tu agente las llama por sí solo una vez que el servidor está conectado.

`search_yuno_api_documentation`Busca en la documentación guías, ejemplos de código y referencias de la API que coincidan con una pregunta.`query_docs_filesystem_yuno_api_documentation`Ejecuta consultas de solo lectura al estilo shell, como `rg` o `cat`, sobre la documentación como si fuera un sistema de archivos virtual.`submit_feedback`Reporta al equipo de documentación una página incorrecta o faltante, con la ruta de la página y qué está mal.

## Agrega el servidor

**1. Elige tu herramienta y agrega la URL**

> [tab] Cursor
>
> 1. Abre **Cursor Settings** (`Cmd+Shift+P` o `Ctrl+Shift+P`, luego "Open MCP Settings").
> 2. Haz clic en **+ Add New MCP Server**.
> 3. Completa los detalles:
>    * **Name**: Yuno Docs
>    * **Type**: `http`
>    * **URL**: `https://docs.y.uno/mcp`
> 4. Haz clic en **Save**.

> [tab] Claude Code
>
> ```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> claude mcp add --transport http yuno-docs https://docs.y.uno/mcp
> ```
>
> Agrega `--scope project` para compartir el servidor con tu equipo mediante `.mcp.json`.

> [tab] Claude Desktop
>
> 1. Abre el archivo de configuración de Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` en macOS, `%APPDATA%\Claude\claude_desktop_config.json` en Windows).
> 2. Agrega el servidor a `mcpServers`:
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "mcpServers": {
>     "yuno-docs": {
>       "url": "https://docs.y.uno/mcp"
>     }
>   }
> }
> ```

> [tab] Codex
>
> ```bash theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> codex mcp add yuno-docs --url https://docs.y.uno/mcp
> ```

> [tab] VS Code
>
> Crea `.vscode/mcp.json` en tu proyecto:
>
> ```json theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
> {
>   "servers": {
>     "yuno-docs": {
>       "type": "http",
>       "url": "https://docs.y.uno/mcp"
>     }
>   }
> }
> ```

**2. Verifica la conexión**

Hazle a tu agente una pregunta que solo responda la documentación:

```text theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
Which two headers authenticate a Yuno API call?
```

Un agente conectado responde `public-api-key` y `private-secret-key`, y cita una página de docs.y.uno. Si adivina o nombra otro encabezado, el servidor aún no está conectado: reinicia la herramienta y revisa la URL.

**3. Pide un primer pago**

El servidor funciona mejor con una tarea concreta. Por ejemplo:

```text theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
Using the Yuno docs, write a Node script that
creates a checkout session and a sandbox payment
with the test card from the Quickstart.
```

El agente lee el [Quickstart](https://docs.y.uno/es/docs/quickstart.md) y la referencia de la API a través del servidor, de modo que la URL base, los encabezados y los campos obligatorios provienen de la documentación actual.

## ¿Qué MCP de Yuno necesitas?

| Servidor | Qué hace | Credenciales |
| - | - | - |
| **MCP de documentación** (esta página) | Busca y lee la documentación de Yuno. No puede actuar sobre tu cuenta. | Ninguna |
| [MCP de acciones local](https://docs.y.uno/es/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp.md) | Se ejecuta desde tu máquina con `npx`. Crea y gestiona pagos, clientes y suscripciones. | Tus API keys |
| [MCP de acciones remoto](https://docs.y.uno/es/docs/ai-capabilities/remote-yuno-mcp-server.md) | Endpoint alojado con las mismas acciones, además de límites de tasa, vinculación de IP y vencimiento de sesión aplicados por Yuno. | Tus API keys |

## Siguiente

<ol>
  <li>[Quickstart](https://docs.y.uno/es/docs/quickstart.md)Tutorial Tu primer pago en sandbox en unos 10 minutos, la tarea que debes darle primero a tu agente.</li>
  <li>[Capacidades de IA](https://docs.y.uno/docs/ai-capabilities.md)Centro Todas las formas de construir con Yuno y un agente: servidores MCP, guías para LLM y Maia.</li>
  <li>[AGENTS.md](https://docs.y.uno/AGENTS.md)Para agentes El contrato de integración que los agentes leen primero, con los datos que necesita cada llamada.</li>
  <li>[Especificación OpenAPI](https://docs.y.uno/openapi.json)Referencia El esquema completo de la API para generación de código y validación de solicitudes.</li>
</ol>


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