# Wine Suite

> Wine Suite è il gestionale per cantine. Questo host espone le API pubbliche e un server MCP. Senza chiavi si legge solo questa guida. Con le chiavi della cantina il client parla con il CRM di quella cantina.

## Pagine

- [Documentazione API](https://mcp.wine-suite.com/docs): reference delle API, webhook, e come collegare Cursor, Claude, ChatGPT e Perplexity.
- [Guida per assistenti](https://mcp.wine-suite.com/llms.txt): questo testo.
- Server MCP: https://mcp.wine-suite.com/mcp (Streamable HTTP). Una GET senza il protocollo MCP restituisce questa guida.

## Chiavi, da generare nel CRM

La licenza è Pro. Menu: Impostazioni → Sviluppatori.

1. Tab APIKeys → Aggiungi. Copia API Key. L'API Secret non va negli header MCP.
2. L'UUID della cantina è in Impostazioni → Gestione account, Informazioni della Cantina.
3. Non incollare la chiave in chat. Va solo negli header della connessione MCP.

## Collegare il server MCP

URL: https://mcp.wine-suite.com/mcp

Header:

- APIKey: la chiave appena copiata
- X-DWS-WINERY-ID: UUID della cantina
- X-DWS-ENV: production su questo host. Opzionale: il default è production. Valori ammessi qui: production, staging.

Client:

- Cursor: file .cursor/mcp.json, chiave mcpServers.winesuite con url e headers.
- Claude: Customize → Connectors → Add custom connector. Gli header stanno in Request headers. Guida https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp
- ChatGPT: Settings → Security and login → Developer mode, poi crea l'app con questo URL. Guida https://developers.openai.com/api/docs/guides/developer-mode
- Perplexity: Account settings → Connectors → Custom connector → Remote, transport Streamable HTTP. Guida https://www.perplexity.ai/help-center/en/articles/13915507-adding-custom-remote-connectors

ChatGPT e Perplexity documentano OAuth, API key o nessuna auth. Questo server legge i due header sopra. Se il form non li accetta, la chiamata al CRM non parte: usa Claude o Cursor.

Dopo il salvataggio il client è connesso. I tool leggono e scrivono il CRM di quella cantina. Le scritture (stato prenotazione, import ordine, aggiornamento prenotazione) usano l'ambiente di X-DWS-ENV.

Host di test, per dev test e staging: https://staging.mcp.wine-suite.com/mcp