Assistentes (MCP)

MCP (Model Context Protocol) é a forma padrão de um assistente de IA se conectar a uma ferramenta e usá-la de verdade. A Bernuvia expõe o seu marketplace por MCP, então o seu assistente não explica como publicar um modelo: ele publica, na sua conta e com as permissões que você deu.

• Quem manda é você: cada credencial leva as permissões que você definir, e nada mais.
• Não precisa programar: conecta colando uma linha no seu cliente.
• Funciona com Claude, Cursor, ChatGPT, VS Code e qualquer cliente que fale MCP.

1. 1Entre em MCP no seu painel e clique em Criar token.
2. 2Dê um nome que você reconheça, por exemplo «Claude do meu notebook».
3. 3Escolha as permissões: só leitura, comprador ou vendedor. Se você tem segundo fator, ele vai pedir o código.
4. 4Copie o token na hora: por segurança ele não é mostrado de novo. Se perder, revogue e crie outro.

Cada cliente se configura do seu jeito, mas é sempre a mesma coisa: o endereço do servidor e o seu token no cabeçalho Authorization. Troque TU_TOKEN pelo que você acabou de copiar.

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" }
    }
  }
}

O servidor publica mais de quarenta funções divididas em três grupos, e cada uma pede a sua permissão. Você não precisa decorá-las: o seu assistente as descobre sozinho ao conectar.

• Leitura: o seu perfil e o seu saldo, o catálogo, as avaliações, as suas compras, as suas notificações e a central de ajuda. Por exemplo buscar_plantillas ou mis_compras.
• Compra: carrinho, favoritos, avaliações, cotar com o detalhamento exato, preparar o pagamento e acompanhar uma disputa sua. Por exemplo cotizar_compra ou mi_carrito.
• Venda: as suas vendas e estatísticas, rascunhos, subir o pacote, enviar para revisão, códigos de desconto e responder avaliações. Por exemplo enviar_a_revision ou mis_ventas.

Não é uma promessa de bom comportamento: o servidor simplesmente não tem funções para isso, então nem o seu assistente nem um token roubado podem tentar.

• Assinar um pagamento. Ele prepara a compra e te dá o link; a assinatura é sua, no seu navegador, com a sua wallet.
• Sacar o seu dinheiro. Sacar exige a sua assinatura e um código enviado ao seu e-mail.
• Mexer na sua conta. Não muda o seu e-mail, não toca no seu segundo fator e não cria outras credenciais. Uma credencial nunca fabrica outra.
• Entrar na administração. O seu assistente opera como você, e só como você.

Tudo o que move dinheiro termina no seu navegador. O seu assistente chega até a borda, te entrega o link e para.

• Pagar uma compra: ele entrega o link com o valor já cotado e você assina.
• Abrir, retirar ou fechar por vencimento uma disputa: ele prepara o link e você assina.
• Sacar os seus ganhos e ativar a sua assinatura: sempre seu, nunca pelo MCP.

Se o seu cliente souber desenhá-las, algumas respostas chegam também como cartões: o catálogo com as imagens, o seu carrinho com o total, as suas vendas desenhadas. Está em beta.

• Não há nada para instalar nem ativar: se o seu cliente souber, elas aparecem sozinhas; se não, você recebe o texto de sempre.
• Um cartão pode menos que você: não assina, não publica e não saca.
• O que outra pessoa escreveu é pintado como texto. Se algo ali dentro pedir para liberar um pagamento, nem o cartão nem o seu assistente obedecem.