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 paginaLink naar deze sectie#
Elke documentatiepagina is ook gewone markdown:
- Voeg
.mdtoe aan de URL:/docs/api/productswordt/docs/api/products.md. - Of vraag om markdown: stuur
Accept: text/markdownnaar elke/docsURL.
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 paginaLink naar deze sectie#
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.txtLink naar deze sectie#
| Bestand | Wat erin zit |
|---|---|
| /llms.txt | Een korte samenvatting van TradeCatalog en links naar de belangrijke pagina's, volgens de llms.txt-conventie. |
| /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.
OpenAPILink naar deze sectie#
/api/v1/openapi.json beschrijft elke REST-eindpunt. Assistenten die OpenAPI begrijpen kunnen API-aanroepen direct vanuit het halen.
OntdekkingsbestandenLink naar deze sectie#
| 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. |
/auth.md | Hoe agents authenticeren, op één pagina. |
Laat AI-apps uw gegevens gebruikenLink naar deze sectie#
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. Het meldt zich aan als u en ziet alleen wat u kunt zien.