# MCP-Server

Verbinden Sie KI-Assistenten (Claude Code, Cursor, VS Code und jeden Client, der Remote-MCP unterstützt) mit TryOnCloud. Der Assistent kann diese Dokumentationen lesen, Ihr Guthaben überprüfen und echte Try-Ons durchführen, während er Ihre Integration aufbaut.

|  |  |
|---|---|
| URL | `https://www.tryoncloud.com/api/mcp` |
| Verkehr | Streambares HTTP |
| Auth | Header `X-API-KEY: tk_dev_v1_...` (oder `Authorization: Bearer tk_dev_v1_...`) |

## Werkzeuge

| Werkzeug | Was es bewirkt | Kosten |
|---|---|---|
| `search_docs` | Durchsucht diese Dokumente und gibt die am besten passenden Seiten zurück | Kostenlos |
| `read_doc` | Gibt eine Docs-Seite als Markdown zurück | Kostenlos |
| `check_credits` | Deine verbleibenden Anproben | Kostenlos |
| `generate_tryon` | Führt eine Anprobe anhand einer URL für ein Kleidungsstück und einer URL für ein Personenbild durch und gibt das Bild zurück | 1 Credit (kostenlos bei `mock: true`) |

> **Hinweis: Für **`generate_tryon`**-Aufrufe** über MCP sind gekaufte Credits (oder `mock: true`) erforderlich. Das kostenlose Kontingent gilt für direkte API-Aufrufe.

## Verbinden

### 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` (alle Projekte) oder `.cursor/mcp.json` (ein Projekt):

```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 fragt den Schlüssel einmal ab und speichert ihn sicher:

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

> **Warnung:** Mit Ihrem API-Schlüssel können Credits verbraucht werden. Committen Sie keine Konfigurationsdatei, die diesen enthält; verwenden Sie stattdessen die Eingabeaufforderung in VS Code oder eine lokale, von Git ignorierte Datei.

## Probier es aus

Sobald die Verbindung hergestellt ist, fragen Sie Ihren Assistenten:

- „Schau in der TryOnCloud-Dokumentation nach, wie Fehler behandelt werden.“
- „Wie viele TryOnCloud-Guthaben habe ich noch?“
- „Führen Sie eine TryOnCloud-Anprobe im Testmodus mit dieser Kleidungsstück-URL und dieser Personen-URL durch.“
