# Risorse per AI e LLM

> Versioni in markdown semplice di questi documenti, llms.txt, OpenAPI, la competenza per agenti e gli altri file leggibili dagli strumenti AI.

Questi documenti sono scritti per essere letti da strumenti AI così come da persone. Usali per fornire a Claude, ChatGPT, Cursor o al tuo agente informazioni accurate e aggiornate su TradeCatalog.

## Versioni in markdown di ogni pagina

Ogni pagina dei documenti è anche in markdown semplice:

- Aggiungi `.md` all'URL: `/docs/api/products` diventa `/docs/api/products.md`.
- Oppure chiedi il markdown: invia `Accept: text/markdown` a qualsiasi URL `/docs`.

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

Alcune altre pagine di TradeCatalog restituiscono il markdown quando richiesto con `Accept: text/markdown`.

## Pulsanti su ogni pagina

Nella parte superiore di ogni pagina dei documenti:

- **Copia pagina** copia la pagina in formato markdown, pronta da incollare in una chat.
- **Visualizza come markdown** apre la versione `.md`.
- **Apri in Claude** e **Apri in ChatGPT** avviano una nuova chat che legge la pagina, così puoi porre domande su di essa.

Ogni blocco di codice ha anche un pulsante **Copia**.

## llms.txt e llms-full.txt

| File                             | Cosa contiene                                                                                                                        |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| [/llms.txt](/llms.txt)           | Un breve riassunto di TradeCatalog e collegamenti alle pagine principali, seguendo la convenzione [llms.txt](https://llmstxt.org).   |
| [/llms-full.txt](/llms-full.txt) | Tutte le pagine dei documenti in un unico file markdown. Incollalo in un progetto o forniscilo a un agente per un contesto completo. |

Per gli assistenti di programmazione, aggiungi `/llms-full.txt` al tuo progetto, o fai sapere all'assistente di leggerlo prima di scrivere il codice TradeCatalog.

## OpenAPI

[`/api/v1/openapi.json`](/docs/api/openapi) descrive ogni endpoint REST. Gli agenti che comprendono OpenAPI possono pianificare chiamate API direttamente da esso.

## File di scoperta

| File                                        | Per                                                                                              |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `/.well-known/api-catalog`                  | Catalogo API RFC 9727: collegamenti al server MCP, all'API REST, a OpenAPI e a questi documenti. |
| `/.well-known/mcp/server-card.json`         | Scheda del server MCP: URL, trasporto, autenticazione e strumenti.                               |
| `/.well-known/agent-skills/index.json`      | Una competenza per agenti che descrive come utilizzare TradeCatalog.                             |
| `/.well-known/ai-catalog.json`              | Indice del server MCP e della competenza.                                                        |
| `/.well-known/oauth-protected-resource/mcp` | Metadati OAuth per il server MCP. Vedere [OAuth per client MCP](/docs/mcp/oauth).                |
| `/auth.md`                                  | Come gli agenti si autenticano, in una sola pagina.                                              |

## Lascia che le app AI utilizzino i tuoi dati

Leggere i documenti è una cosa. Per permettere a un'app AI di cercare i tuoi prodotti, prezzi e ordini reali, collegala al [server MCP](/docs/mcp). Si autentica come te e vede solo ciò che puoi vedere tu.