# Serveur MCP

Connectez vos assistants IA (Claude Code, Cursor, VS Code et tout autre client prenant en charge le MCP à distance) à TryOnCloud. L'assistant peut consulter cette documentation, vérifier vos crédits et effectuer des essais réels tout en mettant en place votre intégration.

|  |  |
|---|---|
| URL | `https://www.tryoncloud.com/api/mcp` |
| Transports | HTTP en flux continu |
| Auth | En-tête `X-API-KEY: tk_dev_v1_...` (ou `Authorization: Bearer tk_dev_v1_...`) |

## Outils

| Outil | Fonctionnalités | Coût |
|---|---|---|
| `search_docs` | Effectue des recherches dans ces documents et renvoie les pages les plus pertinentes | Gratuit |
| `read_doc` | Renvoie une page « docs » au format Markdown | Gratuit |
| `check_credits` | Le nombre d'essais qu'il vous reste | Gratuit |
| `generate_tryon` | Lance une simulation d'essayage à partir de l'URL d'un vêtement et de celle d'une photo de personne, puis renvoie l'image | 1 crédit (gratuit avec `mock: true`) |

> **Remarque : la fonction **`generate_tryon`**,** accessible via MCP, nécessite des crédits achetés (ou la valeur `mock: true`). Le quota gratuit s'applique aux appels API directs.

## Se connecter

### 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` (tous les projets) ou `.cursor/mcp.json` (un seul projet) :

```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 vous demande la clé une seule fois et la stocke en toute sécurité :

```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}" }
    }
  }
}
```

> **Avertissement :** votre clé API peut entraîner des dépenses de crédits. Ne validez pas de fichier de configuration qui la contient ; utilisez plutôt la fenêtre de saisie de VS Code ou un fichier local ignoré par Git.

## Essayez-le

Une fois connecté, demandez à votre assistant :

- « Consultez la documentation d'TryOnCloud pour savoir comment les erreurs sont gérées. »
- « Combien de crédits TryOnCloud me reste-t-il ? »
- « Lancez une simulation d'essayage TryOnCloud en mode test avec l'URL de ce vêtement et celle de cette personne. »
