Assistenti (MCP)

MCP (Model Context Protocol) è il modo standard con cui un assistente di IA 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 permessi che gli hai dato.

• Comandi tu: ogni credenziale porta i permessi che le dai, e nulla di più.
• Non serve programmare: si collega incollando una riga nel tuo client.
• Funziona con Claude, Cursor, ChatGPT, VS Code e qualsiasi client che parli MCP.

1. 1Entra in MCP nel tuo pannello e premi Crea token.
2. 2Dagli un nome che riconosci, per esempio «Claude del mio portatile».
3. 3Scegli i permessi: sola lettura, acquirente o venditore. Se hai il secondo fattore, ti chiederà il codice.
4. 4Copia il token in quel momento: per sicurezza non viene mostrato di nuovo. Se lo perdi, revocalo e creane un altro.

Ogni client si configura a modo suo, ma il succo è sempre lo stesso: l'indirizzo del server e il tuo token nell'intestazione Authorization. Sostituisci TU_TOKEN con quello che hai appena copiato.

claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
  --header "Authorization: Bearer TU_TOKEN"

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

Il server pubblica più di quaranta funzioni divise in tre gruppi, e ognuna chiede il suo permesso. Non devi impararle: il tuo assistente le scopre da solo quando si collega.

• Lettura: il tuo profilo e il tuo saldo, il catalogo, le recensioni, i tuoi acquisti, le tue notifiche e il centro assistenza. Per esempio buscar_plantillas o mis_compras.
• Acquisto: carrello, preferiti, recensioni, preventivo con il dettaglio esatto, preparare il pagamento e seguire una tua disputa. Per esempio cotizar_compra o mi_carrito.
• Vendita: le tue vendite e statistiche, bozze, caricare il pacchetto, mandare in revisione, codici sconto e rispondere alle recensioni. Per esempio enviar_a_revision o mis_ventas.

Non è una promessa di buona condotta: il server semplicemente non ha funzioni per questo, quindi né il tuo assistente né un token rubato possono provarci.

• Firmare un pagamento. Prepara l'acquisto e ti dà il link; la firma la metti tu, nel tuo browser, con il tuo wallet.
• Prelevare i tuoi soldi. Prelevare richiede la tua firma e un codice inviato alla tua email.
• Toccare il tuo account. Non cambia la tua email, non tocca il secondo fattore e non crea altre credenziali. Una credenziale non ne fabbrica mai un'altra.
• Entrare nell'amministrazione. Il tuo assistente opera come te, e solo come te.

Tutto ciò che muove denaro finisce nel tuo browser. Il tuo assistente arriva fino al bordo, ti lascia il link e si ferma.

• Pagare un acquisto: ti consegna il link con l'importo già calcolato e firmi tu.
• Aprire, ritirare o chiudere per scadenza una disputa: ti prepara il link e firmi tu.
• Prelevare i tuoi guadagni e attivare l'abbonamento: sempre tuo, mai via MCP.

Se il tuo client sa disegnarle, alcune risposte arrivano anche come schede: il catalogo con le immagini, il tuo carrello con il totale, le tue vendite disegnate. È in beta.

• Non c'è nulla da installare né da attivare: se il tuo client sa farlo, appaiono da sole; se no, ricevi il testo di sempre.
• Una scheda può meno di te: non firma, non pubblica e non preleva.
• Quello che ha scritto un'altra persona viene mostrato come testo. Se lì dentro qualcosa chiede di liberare un pagamento, né la scheda né il tuo assistente obbediscono.