BernuviaBernuvia
Contenido

Asistentes (MCP)

Conecta Claude o cualquier cliente que hable MCP a tu cuenta de Bernuvia. Tu asistente busca, compra, publica y consulta tus ventas; la firma de cualquier pago sigue siendo tuya.

Qué es MCP, en una frase

MCP (Model Context Protocol) es la forma estándar en que un asistente de IA se conecta a una herramienta y la usa de verdad. Bernuvia expone su marketplace por MCP, así que tu asistente no te explica cómo publicar una plantilla: la publica, en tu cuenta y con los permisos que le diste.

  • Tú mandas: cada credencial lleva los permisos que le pongas, y nada más.
  • No hay que programar: se conecta pegando una línea en tu cliente.
  • Funciona con Claude, Cursor, ChatGPT, VS Code y cualquier cliente que hable MCP.

Esto opera tu cuenta, con tu asistente al lado. Si lo que quieres es un programa con cuenta y wallet propias, eso son las cuentas-agente.

Crea tu credencial

  1. 1Entra a MCP en tu panel y pulsa Crear token.
  2. 2Ponle un nombre que reconozcas, por ejemplo «Claude de mi portátil».
  3. 3Elige los permisos: solo lectura, comprador o vendedor. Si tienes segundo factor, te pedirá el código.
  4. 4Copia el token en ese momento: por seguridad no se vuelve a mostrar. Si lo pierdes, revócalo y crea otro.

El permiso de vendedor no basta por sí solo: necesitas tu membresía de vendedor al día. Se comprueba en cada llamada, así que si caduca esas funciones dejan de responder aunque la credencial siga viva.

Conecta tu cliente

Cada cliente se configura a su manera, pero siempre es lo mismo: la dirección del servidor y tu token en la cabecera Authorization. Sustituye TU_TOKEN por el que acabas de copiar.

Claude Code, en tu terminal

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

Clientes que se configuran con un fichero

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

En tu panel, en «Conectar tu cliente», tienes el bloque de cada cliente ya relleno con tu token. Puedes tener varios tokens a la vez y revocar cualquiera cuando quieras.

Qué puede hacer

El servidor publica más de cuarenta funciones repartidas en tres grupos, y cada una pide su permiso. No hace falta que te las aprendas: tu asistente las descubre solo al conectarse.

  • Lectura: tu perfil y tu saldo, el catálogo, las reseñas, tus compras, tus notificaciones y el centro de ayuda. Por ejemplo buscar_plantillas o mis_compras.
  • Compra: carrito, favoritos, reseñas, cotizar con el desglose exacto, preparar el pago y seguir una disputa tuya. Por ejemplo cotizar_compra o mi_carrito.
  • Venta: tus ventas y estadísticas, borradores, subir el paquete, enviar a revisión, códigos de descuento y responder reseñas. Por ejemplo enviar_a_revision o mis_ventas.

Son las mismas funciones que usa la web, con las mismas validaciones y la misma revisión humana. Lo único que cambia es quién teclea.

Lo que nunca puede hacer

No es una promesa de buena conducta: el servidor no tiene funciones para esto, así que ni tu asistente ni un token robado pueden intentarlo.

  • Firmar un pago. Prepara la compra y te da el enlace; la firma la pones tú, en tu navegador, con tu wallet.
  • Retirar tu dinero. Retirar exige tu firma y un código enviado a tu correo.
  • Tocar tu cuenta. No cambia tu correo, no toca tu segundo factor y no crea otras credenciales. Una credencial nunca fabrica otra.
  • Entrar a la administración. Tu asistente opera como tú, y solo como tú.

Si sospechas de un token, revócalo en MCP y deja de funcionar al instante. Activar el segundo factor en Seguridad los revoca todos de golpe.

Lo que siempre firmas tú

Todo lo que mueve dinero termina en tu navegador. Tu asistente llega hasta el borde, te deja el enlace y para.

Tu asistente te acompaña hasta el pago; el pago lo firmas tú.
  • Pagar una compra: te entrega el enlace con el importe ya cotizado y firmas tú.
  • Abrir, retirar o cerrar por vencimiento una disputa: te prepara el enlace y firmas tú.
  • Retirar tus ganancias y activar tu membresía: siempre tuyo, nunca por MCP.

Las interfaces en el chat

Si tu cliente sabe pintarlas, algunas respuestas llegan además como tarjetas: el catálogo con sus imágenes, tu carrito con el total, tus ventas dibujadas. Está en beta.

  • No hay nada que instalar ni activar: si tu cliente sabe, aparecen solas; si no, recibes el texto de siempre.
  • Una tarjeta puede menos que tú: no firma, no publica y no retira.
  • Lo que escribió otra persona se pinta como texto. Si algo ahí dentro pide liberar un pago, ni la tarjeta ni tu asistente lo obedecen.

Salen en el idioma de tu cuenta de Bernuvia, no en el de tu cliente. Tienes el detalle en la página de interfaces.

Sigue por aquí

La documentación explica cómo funciona esto; el centro de ayuda te lleva de la mano. Ir al centro de ayuda.