Collega Claude a Webround

MCP (Model Context Protocol) permette a un assistente AI come Claude di usare un servizio attraverso un insieme di strumenti. Webround ha due server MCP, uno per ciò che vendi e uno per il sito stesso. Collega Claude all'uno o all'altro e chiedigli quello che vuoi in linguaggio naturale: chiama le stesse operazioni che usano la dashboard e l'editor, con i permessi della chiave che gli dai.

Server	Cosa può fare Claude	Indirizzo
Commerce	Prodotti, varianti, collezioni, ordini, promozioni, spedizioni, tasse, impostazioni dello store e altro: lo store	https://ai-api.webround.com/mcp
Editor	Il codice e i contenuti di un sito: pagine, sezioni, testi, SEO, tema, stili, commenti, file	https://<draftId>-render-v2.webround.net/__wr/mcp

Puoi collegarli entrambi insieme. Sono indipendenti: ognuno ha la sua chiave.

Cosa ti serve

• Una chiave API con i permessi che vuoi dare a Claude. La crei dalla dashboard (vedi API Keys). Claude può fare esattamente ciò che la chiave permette e niente di più, quindi dagli solo ciò che serve al compito.
• Un client che parli con un server MCP remoto (Streamable HTTP) e ti lasci impostare le intestazioni della richiesta. Claude Code lo fa.

Entrambi i server si autenticano con lo stesso tipo di intestazione, a ogni richiesta:

Authorization: Bearer <la tua chiave API>

Collega con Claude Code

Aggiungi un server con claude mcp add. La pagina di ogni server ha il comando esatto:

claude mcp add --transport http webround-commerce "https://ai-api.webround.com/mcp" \
  --header "Authorization: Bearer <la tua chiave API>" \
  --header "store-id: <l'ID del tuo store>" \
  --header "user-id: <il tuo ID utente>"

Per condividere la configurazione con un team, mettila invece nel file .mcp.json del progetto e tieni la chiave in una variabile d'ambiente:

{
  "mcpServers": {
    "webround-commerce": {
      "type": "http",
      "url": "https://ai-api.webround.com/mcp",
      "headers": {
        "Authorization": "Bearer ${WEBROUND_API_KEY}",
        "store-id": "<l'ID del tuo store>",
        "user-id": "<il tuo ID utente>"
      }
    }
  }
}

Non committare mai una chiave. Chi la possiede ha i permessi che le hai dato.

Cosa chiedere

• "Crea un prodotto 'T-shirt sportiva Nike' a 19,99 €, taglie S, M e L, colori rosso, blu, verde e nero, con 10 pezzi a magazzino per ogni variante."
• "Quali ordini di questa settimana sono pagati ma non spediti?"
• "Aggiungi una promozione del 15% sulla collezione 'Estate' fino a fine mese."
• "Nella home, cambia il titolo della prima sezione in 'Novità' e scrivi la versione inglese."
• "Controlla la SEO di ogni pagina e correggi ciò che manca."

Claude legge prima di scrivere. I server dicono al client quali strumenti si limitano a leggere e quali tolgono qualcosa, quindi un buon client ti chiede conferma prima di cancellare o sostituire.

Da sapere

• I permessi sono quelli della chiave. Se la chiave non può fare qualcosa, l'API risponde con un errore e Claude te lo dice. Crea un'altra chiave con il permesso che serve.
• Non si ricorda niente tra una richiesta e l'altra. I server non tengono sessioni: ogni chiamata sta da sola.
• Un server, uno store. Il server commerce lavora sullo store il cui store-id invii, il server editor sul draft nel suo indirizzo. Un draft e il suo store hanno lo stesso ID.