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áginaEnlace a esta sección#
Cada página de documentación también es markdown plano:
- Añada
.mda la URL:/docs/api/productsse convierte en/docs/api/products.md. - O pida markdown: envíe
Accept: text/markdowna cualquier URL/docs.
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áginaEnlace a esta sección#
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.txtEnlace a esta sección#
| Archivo | Qué contiene |
|---|---|
| /llms.txt | Un resumen breve de TradeCatalog y enlaces a las páginas clave, siguiendo la convención llms.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.
OpenAPIEnlace a esta sección#
/api/v1/openapi.json describe cada punto de entrada REST. Los asistentes que entiendan OpenAPI pueden planificar llamadas a API directamente desde él.
Archivos de descubrimientoEnlace a esta sección#
| 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. |
/auth.md | Cómo se autentican los agentes, en una sola página. |
Deje que las aplicaciones de IA usen sus datosEnlace a esta sección#
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. Se identifica como usted y ve solo lo que usted puede ver.