# AI- en LLM-bronnen

> Plaatsmarkdown-versies van deze documentatie, llms.txt, OpenAPI, de agentvaardigheid en de andere bestanden die AI-tools kunnen lezen.

Deze documentatie is geschreven om zowel door AI-tools als mensen gelezen te worden. Gebruik ze om Claude, ChatGPT, Cursor of uw eigen agent nauwkeurige, actuele context over TradeCatalog te geven.

## Markdown-versies van elke pagina

Elke documentatiepagina is ook gewone markdown:

- Voeg `.md` toe aan de URL: `/docs/api/products` wordt `/docs/api/products.md`.
- Of vraag om markdown: stuur `Accept: text/markdown` naar elke `/docs` URL.

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

Andere TradeCatalog-pagina's geven ook markdown terug als je dat vraagt met `Accept: text/markdown`.

## Knoppen op elke pagina

Boven aan elke documentatiepagina:

- **Kopieer pagina** kopieert de pagina als markdown, klaar om te plakken in een chat.
- **Bekijk als Markdown** opent de `.md`-versie.
- **Open in Claude** en **Open in ChatGPT** start een nieuwe chat die de pagina leest, zodat u vragen over het kunt stellen.

Elke codeblok heeft ook een **Kopieer**-knop.

## llms.txt en llms-full.txt

| Bestand                          | Wat erin zit                                                                                                                         |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| [/llms.txt](/llms.txt)           | Een korte samenvatting van TradeCatalog en links naar de belangrijke pagina's, volgens de [llms.txt](https://llmstxt.org)-conventie. |
| [/llms-full.txt](/llms-full.txt) | Alle documentatiepagina's in één markdown-bestand. Plak het in een project of geef het aan een agent voor volledige context.         |

Voor coderingsassistenten, voeg `/llms-full.txt` toe aan de documentatie van uw project, of zeg de assistent om het te lezen voordat hij TradeCatalog-code schrijft.

## OpenAPI

[`/api/v1/openapi.json`](/docs/api/openapi) beschrijft elke REST-eindpunt. Assistenten die OpenAPI begrijpen kunnen API-aanroepen direct vanuit het halen.

## Ontdekkingsbestanden

| Bestand                                     | Voor                                                                                         |
| ------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `/.well-known/api-catalog`                  | RFC 9727 API-catalogus: links naar de MCP-server, de REST API, OpenAPI en deze documentatie. |
| `/.well-known/mcp/server-card.json`         | De kaart van de MCP-server: URL, transport, authenticatie en tools.                          |
| `/.well-known/agent-skills/index.json`      | Een agentvaardigheid die beschrijft hoe TradeCatalog gebruikt moet worden.                   |
| `/.well-known/ai-catalog.json`              | Index van de MCP-server en de vaardigheid.                                                   |
| `/.well-known/oauth-protected-resource/mcp` | OAuth-metadata voor de MCP-server. Zie [OAuth voor MCP-clients](/docs/mcp/oauth).            |
| `/auth.md`                                  | Hoe agents authenticeren, op één pagina.                                                     |

## Laat AI-apps uw gegevens gebruiken

Lezen van documentatie is één ding. Om een AI-app te laten zoeken naar uw echte producten, prijzen en bestellingen, verbindt u het met de [MCP-server](/docs/mcp). Het meldt zich aan als u en ziet alleen wat u kunt zien.