Collega il tuo assistente IA (MCP)

MCP (Model Context Protocol) è il modo standard in cui un assistente IA (Claude, per esempio) si collega a uno strumento e lo usa davvero. Bernuvia espone il suo marketplace via MCP, quindi il tuo assistente non ti spiega come pubblicare un template: lo pubblica, nel tuo account e con i tuoi permessi.

• Sono le stesse funzioni che usa il sito, con le stesse convalide, la stessa revisione e la stessa moderazione.
• Non serve programmare: si collega con una riga e un token che crei e revochi quando vuoi.
• Funziona con Claude e con qualsiasi client che parli MCP.

1. 1Vai su MCP nel tuo pannello e premi Crea token.
2. 2Dagli un nome che dica a cosa serve («Claude del mio laptop», «vendite») e scegli i permessi. Se il tuo account ha la 2FA, ti chiederà il codice.
3. 3Copia il token in quel momento: per sicurezza non viene mostrato di nuovo. Se lo perdi, revocalo e creane un altro.
4. 4Mettilo in una variabile d'ambiente e collega il tuo client con il blocco corrispondente (qui sotto ne trovi uno per client).
5. 5Apri una sessione nuova del tuo assistente: gli strumenti vengono annunciati all'inizio della conversazione, quindi in quella già aperta non compaiono.

read -rs BERNUVIA_TOKEN && export BERNUVIA_TOKEN

$BERNUVIA_TOKEN = Read-Host "Bernuvia token"

claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
  --header "Authorization: Bearer ${BERNUVIA_TOKEN}"

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

{
  "mcpServers": {
    "bernuvia": {
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${BERNUVIA_TOKEN}"
      }
    }
  }
}

{
  "servers": {
    "bernuvia": {
      "type": "http",
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BERNUVIA_TOKEN}"
      }
    }
  }
}

Ogni token porta con sé dei permessi e ogni funzione richiede il suo. Gli dai solo quello che vuoi che faccia:

• Sola lettura: catalogo e recensioni, i tuoi acquisti, preferiti, saldo, notifiche, referral e statistiche.
• Compratore: carrello, salvare tra i preferiti, lasciare recensioni, segnalare problemi, preparare pagamenti, chiudere un tuo ordine non ancora pagato e ormai senza preventivo riscuotibile, e aprire, ritirare o chiudere per scadenza una disputa sui tuoi acquisti.
• Venditore: le tue vendite e statistiche, bozze, pubblicare in revisione, codici sconto e rispondere alle recensioni.

Puoi avere più collegamenti insieme senza che si pestino i piedi: uno per vendere, uno per comprare, o uno per ogni tuo account. L'unica cosa da curare è che ognuno abbia il suo nome e la sua variabile.

• Un nome per scopo, sul token e sul server dentro il tuo client: `bernuvia-ventas` e `bernuvia-compras` si distinguono a colpo d'occhio.
• Una variabile per token: `BERNUVIA_TOKEN_VENTAS` e `BERNUVIA_TOKEN_COMPRAS`, per non incollare mai la chiave sbagliata.
• Ambito per cartella o per progetto se il tuo client lo consente: la configurazione vive con il progetto e si carica solo quando lavori lì. Se c'è solo la configurazione globale, bastano i nomi diversi.
• Ogni token porta i suoi permessi: uno di acquisto non può vendere, e uno di vendita non gestisce i tuoi agenti.

Non è una promessa: il server semplicemente non ha funzioni per questo, quindi nessun agente (nemmeno con un token rubato) può provarci.

• Firmare un pagamento. Può preparare l'acquisto e darti il link; la firma la fai tu nel browser con il tuo wallet. Con le dispute, uguale: ti prepara il link per aprirla, per ritirarla o per chiuderla per scadenza (quando il termine è passato senza che il team l'abbia risolta, l'importo torna intero a te, senza commissione), e firmi tu.
• Prelevare i tuoi soldi. Il prelievo richiede la tua firma e un codice inviato alla tua email.
• Toccare il tuo account. Non cambia la tua email, né la tua 2FA, né crea altri token.
• Entrare nel pannello di amministrazione. Un agente opera come te, e solo come te.

1. 1Vai su MCP e premi Revoca sul token che ti preoccupa: smette di funzionare all'istante.
2. 2Se sospetti che il tuo account sia compromesso, attiva la 2FA in Sicurezza: attivandola vengono revocati TUTTI i tuoi token in un colpo solo, oltre a chiudere le altre sessioni.