# Recursos de IA y LLM

> Versiones en markdown plano de esta documentación, llms.txt, OpenAPI, la habilidad del agente y otros archivos que pueden leer las herramientas de IA.

Estos documentos están escritos para ser leídos por herramientas de IA así como por personas. Úselos para dar a Claude, ChatGPT, Cursor o a su propio agente un contexto preciso y actual sobre TradeCatalog.

## Versiones en markdown de cada página

Cada página de documentación también es markdown plano:

- Añada `.md` a la URL: `/docs/api/products` se convierte en `/docs/api/products.md`.
- O pida markdown: envíe `Accept: text/markdown` a cualquier URL `/docs`.

```bash
curl https://tradecatalog.app/docs/api/products.md
curl -H "Accept: text/markdown" https://tradecatalog.app/docs/api/products
```

Otras páginas de TradeCatalog también devuelven markdown cuando se les pide con `Accept: text/markdown`.

## Botones en cada página

En la parte superior de cada página de documentación:

- **Copiar página** copia la página como markdown, lista para pegar en un chat.
- **Ver como markdown** abre la versión `.md`.
- **Abrir en Claude** y **Abrir en ChatGPT** inician un nuevo chat que lee la página, para que pueda hacer preguntas sobre ella.

Cada bloque de código también tiene un botón **Copiar**.

## llms.txt y llms-full.txt

| Archivo                          | Qué contiene                                                                                                                                       |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| [/llms.txt](/llms.txt)           | Un resumen breve de TradeCatalog y enlaces a las páginas clave, siguiendo la convención [llms.txt](https://llmstxt.org).                           |
| [/llms-full.txt](/llms-full.txt) | Todas las páginas de documentación en un solo archivo markdown. Péguelo en un proyecto o hágalo llegar a un agente para obtener contexto completo. |

Para asistentes de programación, añada `/llms-full.txt` a los documentos de su proyecto, o indique al asistente que lo lea antes de escribir código de TradeCatalog.

## OpenAPI

[`/api/v1/openapi.json`](/docs/api/openapi) describe cada punto de entrada REST. Los asistentes que entiendan OpenAPI pueden planificar llamadas a API directamente desde él.

## Archivos de descubrimiento

| Archivo                                     | Para                                                                                                |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `/.well-known/api-catalog`                  | Catálogo de API RFC 9727: enlaces al servidor MCP, a la API REST, a OpenAPI y a esta documentación. |
| `/.well-known/mcp/server-card.json`         | Tarjeta del servidor MCP: URL, transporte, autenticación y herramientas.                            |
| `/.well-known/agent-skills/index.json`      | Habilidad de un agente que describe cómo usar TradeCatalog.                                         |
| `/.well-known/ai-catalog.json`              | Índice del servidor MCP y de la habilidad.                                                          |
| `/.well-known/oauth-protected-resource/mcp` | Metadatos OAuth para el servidor MCP. Vea [OAuth para clientes MCP](/docs/mcp/oauth).               |
| `/auth.md`                                  | Cómo se autentican los agentes, en una sola página.                                                 |

## Deje que las aplicaciones de IA usen sus datos

Leer documentación es una cosa. Para que una aplicación de IA busque sus productos, precios y pedidos reales, conéctela al [servidor MCP](/docs/mcp). Se identifica como usted y ve solo lo que usted puede ver.