# Servidor MCP

Ligue assistentes de IA (Claude Code, Cursor, VS Code e qualquer cliente compatível com MCP remoto) ao TryOnCloud. O assistente pode ler estes documentos, verificar os seus créditos e executar testes reais enquanto cria a sua integração.

|  |  |
|---|---|
| URL | `https://www.tryoncloud.com/api/mcp` |
| Transportes | HTTP com transmissão contínua |
| Auth | Cabeçalho `X-API-KEY: tk_dev_v1_...` (ou `Authorization: Bearer tk_dev_v1_...`) |

## Ferramentas

| Ferramenta | O que faz | Custo |
|---|---|---|
| `search_docs` | Pesquisa estes documentos e apresenta as páginas mais relevantes | Gratuito |
| `read_doc` | Devolve uma página do Docs no formato Markdown | Gratuito |
| `check_credits` | As tuas provas restantes | Gratuito |
| `generate_tryon` | Executa uma simulação de experimentação a partir do URL de uma peça de roupa e do URL de uma imagem de uma pessoa, devolvendo a imagem | 1 crédito (grátis com `mock: true`) |

> **Nota: A função **`generate_tryon`**,** através do MCP, requer créditos adquiridos (ou `mock: true`). A cota gratuita destina-se a chamadas diretas à API.

## Ligar

### 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 os projetos) ou `.cursor/mcp.json` (um projeto):

```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`. O VS Code solicita a chave uma única vez e guarda-a 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}" }
    }
  }
}
```

> **Aviso:** A sua chave API pode gastar créditos. Não suba um ficheiro de configuração que a contenha; utilize o prompt de entrada do VS Code ou um ficheiro local ignorado pelo Git.

## Experimenta

Assim que estiver ligado, pergunte ao seu assistente:

- "Consulte a documentação do TryOnCloud para saber como os erros são tratados."
- «Quantos créditos do TryOnCloud ainda me restam?»
- "Execute uma simulação no TryOnCloud no modo de simulação com este URL da peça de roupa e este URL da pessoa."
