# Recursos de IA e LLM

> Versões em markdown simples destas documentações, llms.txt, OpenAPI, a habilidade do agente e outros arquivos que ferramentas de IA podem ler.

Estes documentos foram escritos para serem lidos por ferramentas de IA, bem como por pessoas. Use-os para dar ao Claude, ChatGPT, Cursor ou ao seu próprio agente um contexto preciso e atual sobre o TradeCatalog.

## Versões em Markdown de cada página

Cada página de documentação também é markdown simples:

- Adicione `.md` à URL: `/docs/api/products` se torna `/docs/api/products.md`.
- Ou peça em markdown: envie `Accept: text/markdown` para qualquer URL `/docs`.

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

Outras páginas do TradeCatalog também retornam markdown quando solicitadas com `Accept: text/markdown`.

## Botões em cada página

No topo de cada página de documentação:

- **Copiar página** copia a página como markdown, pronta para colar em um chat.
- **Visualizar como Markdown** abre a versão `.md`.
- **Abrir no Claude** e **Abrir no ChatGPT** iniciam um novo chat que lê a página, para que você possa fazer perguntas sobre ela.

Cada bloco de código também tem um botão **Copiar**.

## llms.txt e llms-full.txt

| Arquivo                          | O que há nele                                                                                                                        |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| [/llms.txt](/llms.txt)           | Um resumo curto do TradeCatalog e links para as páginas principais, seguindo a convenção [llms.txt](https://llmstxt.org).            |
| [/llms-full.txt](/llms-full.txt) | Todas as páginas de documentação em um único arquivo markdown. Cole-o em um projeto ou forneça-o a um agente para contexto completo. |

Para assistentes de codificação, adicione `/llms-full.txt` ao seu projeto de documentação, ou peça ao assistente para lê-lo antes de escrever código do TradeCatalog.

## OpenAPI

[`/api/v1/openapi.json`](/docs/api/openapi) descreve cada ponto final REST. Agentes que entendem OpenAPI podem planejar chamadas de API diretamente a partir dele.

## Arquivos de descoberta

| Arquivo                                     | Para                                                                                            |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `/.well-known/api-catalog`                  | Catálogo de API RFC 9727: links para o servidor MCP, a API REST, OpenAPI e estas documentações. |
| `/.well-known/mcp/server-card.json`         | Cartão do servidor MCP: URL, transporte, autenticação e ferramentas.                            |
| `/.well-known/agent-skills/index.json`      | Habilidade de agente descrevendo como usar o TradeCatalog.                                      |
| `/.well-known/ai-catalog.json`              | Índice do servidor MCP e da habilidade.                                                         |
| `/.well-known/oauth-protected-resource/mcp` | Metadados OAuth para o servidor MCP. Consulte [OAuth para clientes MCP](/docs/mcp/oauth).       |
| `/auth.md`                                  | Como os agentes se autenticam, em uma única página.                                             |

## Permita que aplicativos de IA usem seus dados

Ler documentação é uma coisa. Para permitir que um aplicativo de IA consulte seus produtos, preços e pedidos reais, conecte-o ao [servidor MCP](/docs/mcp). Ele entra como você e vê apenas o que você pode ver.