# Servidor MCP

Conecta los asistentes de IA (Claude Code, Cursor, VS Code y cualquier cliente compatible con MCP remoto) a TryOnCloud. El asistente puede leer esta documentación, comprobar tus créditos y realizar pruebas reales mientras configura tu integración.

|  |  |
|---|---|
| URL | `https://www.tryoncloud.com/api/mcp` |
| Transporte | HTTP con transmisión continua |
| Auth | Encabezado `X-API-KEY: tk_dev_v1_...` (o `Authorization: Bearer tk_dev_v1_...`) |

## Herramientas

| Herramienta | Para qué sirve | Coste |
|---|---|---|
| `search_docs` | Busca en estos documentos y muestra las páginas que mejor se ajustan a la búsqueda | Gratis |
| `read_doc` | Devuelve una página de «docs» en formato Markdown | Gratis |
| `check_credits` | Las pruebas que te quedan | Gratis |
| `generate_tryon` | Realiza una simulación de prueba a partir de la URL de una prenda y la URL de una imagen de una persona, y devuelve la imagen. | 1 crédito (gratis con `mock: true`) |

> **Nota: La función **`generate_tryon`**,** a través de MCP, requiere créditos adquiridos (o `mock: true`). La asignación gratuita es para llamadas directas a la API.

## Conectar

### 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` (todos los proyectos) o `.cursor/mcp.json` (un proyecto):

```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 solicita la clave una sola vez y la almacena de forma segura:

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

> **Advertencia:** Tu clave API puede consumir créditos. No guardes en un archivo de configuración que la contenga; utiliza el cuadro de diálogo de VS Code o un archivo local ignorado por Git.

## Pruébalo

Una vez conectado, pregúntale a tu asistente:

- «Consulta la documentación de TryOnCloud para saber cómo se gestionan los errores».
- «¿Cuántos créditos de TryOnCloud me quedan?»
- «Ejecuta una prueba de TryOnCloud en modo simulado con esta URL de la prenda y esta URL de la persona».
