# Server MCP

Collega gli assistenti AI (Claude Code, Cursor, VS Code e qualsiasi client che supporti MCP remoto) a TryOnCloud. L'assistente può leggere questa documentazione, controllare i tuoi crediti ed eseguire prove reali mentre configura la tua integrazione.

|  |  |
|---|---|
| URL | `https://www.tryoncloud.com/api/mcp` |
| Trasporti | HTTP in streaming |
| Autore | Intestazione `X-API-KEY: tk_dev_v1_...` (o `Authorization: Bearer tk_dev_v1_...`) |

## Strumenti

| Strumento | Cosa fa | Costo |
|---|---|---|
| `search_docs` | Esegue una ricerca in questi documenti e restituisce le pagine più pertinenti | Gratis |
| `read_doc` | Restituisce una pagina di documenti in formato Markdown | Gratis |
| `check_credits` | Le tue prove rimanenti | Gratis |
| `generate_tryon` | Esegue una simulazione di prova a partire dall'URL di un capo di abbigliamento e dall'URL dell'immagine di una persona, restituendo l'immagine | 1 credito (gratuito con `mock: true`) |

> **Nota: per utilizzare** `generate_tryon` tramite MCP sono necessari crediti acquistati (oppure `mock: true`). La quota gratuita è riservata alle chiamate API dirette.

## Connettiti

### Claude Code

```bash
claude mcp add --transport http tryoncloud https://www.tryoncloud.com/api/mcp \
  --header "X-API-KEY: tk_dev_v1_your_key_here"
```

### Cursor

`~/.cursor/mcp.json` (tutti i progetti) oppure `.cursor/mcp.json` (un solo progetto):

```json
{
  "mcpServers": {
    "tryoncloud": {
      "url": "https://www.tryoncloud.com/api/mcp",
      "headers": { "X-API-KEY": "tk_dev_v1_your_key_here" }
    }
  }
}
```

### VS Code

`.vscode/mcp.json`. VS Code richiede la chiave una sola volta e la memorizza in modo sicuro:

```json
{
  "inputs": [
    { "type": "promptString", "id": "tryoncloud-key", "description": "TryOnCloud API key", "password": true }
  ],
  "servers": {
    "tryoncloud": {
      "type": "http",
      "url": "https://www.tryoncloud.com/api/mcp",
      "headers": { "X-API-KEY": "${input:tryoncloud-key}" }
    }
  }
}
```

> **Attenzione:** la tua chiave API può comportare l'utilizzo di crediti. Non salvare in un file di configurazione che la contenga; utilizza la finestra di dialogo di VS Code o un file locale ignorato da Git.

## Provalo

Una volta connesso, chiedi al tuo assistente:

- "Consulta la documentazione di TryOnCloud per sapere come vengono gestiti gli errori."
- "Quanti crediti TryOnCloud mi restano?"
- "Esegui una prova con TryOnCloud in modalità simulata utilizzando l'URL di questo capo e l'URL di questa persona."
